#include <ASpeakStageActor.h>

ASpeakStageActor에 대한 상속 다이어그램 :

ASpeakStageActor에 대한 협력 다이어그램:

Public 멤버 함수
	ASpeakStageActor ()
	생성자

void	EndStage ()
	현재 플레이어의 스테이지를 강제로 종료합니다.

FString	GetCurrentQuestion () const

FORCEINLINE class ALingoPlayerState *	GetCurrentSpeaker () const

FORCEINLINE int32	GetCurrentStepIndex () const

virtual void	GetLifetimeReplicatedProps (TArray< FLifetimeProperty > &OutLifetimeProps) const override
	Replication 설정

int32	GetTotalQuestions () const

int32	GetTotalQuestionsCount ()

bool	IsMyTurn (class ALingoPlayerState *lingo_player_state)

void	NotifyAnswerComplete (class ALingoPlayerState *Player)
	플레이어 답변 완료 알림 (Server에서 호출됨)

void	StartStageForPlayer (class ALingoPlayerState *Player)
	특정 플레이어에 대해 Speak Stage를 시작합니다.

Public 속성
FOnSpeakerChangedDelegate	OnSpeakerChanged
	현재 발화자가 변경될 때 호출되는 이벤트입니다.

Protected 멤버 함수
void	Multicast_NotifySpeakQuestStarted (const FString &PlayerName)
	모든 클라이언트에게 SpeakQuest 시작 알림 전송 (Multicast RPC)

void	OnRep_CurrentSpeaker ()
	currentSpeaker 복제 알림

Protected 속성
TObjectPtr< class ALingoPlayerState >	CurrentSpeaker
	현재 발화 권한을 가진 플레이어. nullptr이면 스테이지가 비어있음을 의미.

int32	CurrentStepIndex
	현재 진행 단계 (질문 인덱스)

Private 멤버 함수
void	AdvanceStep ()
	다음 질문으로 진행합니다.

상세한 설명

Speak Stage 시스템

한 번에 한 명의 플레이어와 순차적 음성 대화를 진행하는 액터.

핵심 기능:

한 번에 한 플레이어만 발화 가능 (사용 중/비사용 중 상태)
Server Authority로 턴 제어
모든 클라이언트에 상태 복제
순차적 질문 진행 관리

ASpeakStageActor.h 파일의 22 번째 라인에서 정의되었습니다.

생성자 & 소멸자 문서화

◆ ASpeakStageActor()

ASpeakStageActor::ASpeakStageActor ( )

생성자

ASpeakStageActor.cpp 파일의 16 번째 라인에서 정의되었습니다.

{
    // Replication 설정
    bReplicates = true;
    bAlwaysRelevant = true; // 모든 클라이언트에 항상 복제
 
    // Tick 비활성화 (이벤트 기반으로 동작)
    PrimaryActorTick.bCanEverTick = false;
 
    // 초기값 설정
    CurrentSpeaker = nullptr;
    CurrentStepIndex = 0;
}

다음을 참조함 : CurrentSpeaker, CurrentStepIndex.

멤버 함수 문서화

◆ AdvanceStep()

void ASpeakStageActor::AdvanceStep ( )

private

다음 질문으로 진행합니다.

모든 질문 완료 시 EndStage()를 호출합니다.

ASpeakStageActor.cpp 파일의 134 번째 라인에서 정의되었습니다.

{
    if (!HasAuthority())
    {
        return; 
    }
 
    CurrentStepIndex++;
 
    // 모든 질문 완료?
    auto TotalQuestionsCount = GetTotalQuestionsCount();
    if( CurrentStepIndex >= TotalQuestionsCount )
    {
        PRINTLOG(TEXT("[SpeakStage] All steps completed for: %s"), *ULingoGameHelper::GetPlayerNameFromState(CurrentSpeaker));
        // 스테이지 종료
        EndStage();
    }
    else
    {
        PRINTLOG(TEXT("[SpeakStage] Advanced to step: %d/%d"), CurrentStepIndex + 1, TotalQuestionsCount);
 
        // 클라이언트에게 현재 단계 정보(Toast, TTS)를 전송하고 UI 업데이트를 요청합니다.
        if (APlayerControl* PC = Cast<APlayerControl>(CurrentSpeaker->GetOwner()))
        {
            // 클라이언트에게 StepIndex를 전달하여 스스로 UI와 TTS를 처리하도록 합니다.
            PC->Client_UpdateSpeakQuest(CurrentStepIndex);
            PRINTLOG(TEXT("[SpeakStage] Sent StepIndex %d to client for update."), CurrentStepIndex);
        }
    }
}

다음을 참조함 : CurrentSpeaker, CurrentStepIndex, EndStage(), ULingoGameHelper::GetPlayerNameFromState(), GetTotalQuestionsCount(), PRINTLOG.

다음에 의해서 참조됨 : NotifyAnswerComplete().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ EndStage()

void ASpeakStageActor::EndStage ( )

현재 플레이어의 스테이지를 강제로 종료합니다.

currentSpeaker를 nullptr로 만들고 상태를 초기화합니다.

ASpeakStageActor.cpp 파일의 165 번째 라인에서 정의되었습니다.

{
    if (!HasAuthority() || !CurrentSpeaker)
        return;
 
    // SpeakQuest 완료 처리 (PlayerState에 플래그 설정)
    if (ALingoPlayerState* PS = Cast<ALingoPlayerState>(CurrentSpeaker))
    {
        PS->SetSpeakQuestCompleted();
    }
 
    // 클라이언트 측에서 완료 UI 처리 및 위젯 업데이트를 하도록 단일 RPC 호출
    if (APlayerControl* PC = Cast<APlayerControl>(CurrentSpeaker->GetOwner()))
    {
        PC->Client_EndSpeakQuest();
        PRINTLOG(TEXT("[SpeakStage] Sent FinalizeSpeakQuest to client: %s"), *ULingoGameHelper::GetPlayerNameFromState(CurrentSpeaker));
    }
    
    // 서버 상태 초기화
    CurrentSpeaker = nullptr;
    CurrentStepIndex = 0;
 
    // 서버 측 리스너에게 알림
    OnSpeakerChanged.Broadcast(CurrentSpeaker);
}

다음을 참조함 : CurrentSpeaker, CurrentStepIndex, ULingoGameHelper::GetPlayerNameFromState(), OnSpeakerChanged, PRINTLOG.

다음에 의해서 참조됨 : AdvanceStep().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ GetCurrentQuestion()

FString ASpeakStageActor::GetCurrentQuestion ( ) const

ASpeakStageActor.cpp 파일의 112 번째 라인에서 정의되었습니다.

{
    if (!CurrentSpeaker)
        return TEXT("");
 
    // PlayerState에서 데이터 가져오기
    if (auto PS = Cast<ALingoPlayerState>(CurrentSpeaker))
    {
        if (PS->SpeakScenarioData.speak_quest_data.IsValidIndex(CurrentStepIndex))
            return PS->SpeakScenarioData.speak_quest_data[CurrentStepIndex].GetQuestionMessage();
    }
 
    return TEXT("");
}

다음을 참조함 : CurrentSpeaker, CurrentStepIndex.

다음에 의해서 참조됨 : ANPCExaminer::GetCurrentQuestion().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ GetCurrentSpeaker()

FORCEINLINE class ALingoPlayerState * ASpeakStageActor::GetCurrentSpeaker ( ) const

inline

ASpeakStageActor.h 파일의 35 번째 라인에서 정의되었습니다.

35{ return CurrentSpeaker; }

다음에 의해서 참조됨 : UMainWidget::CanShowSpeakWidget().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ GetCurrentStepIndex()

FORCEINLINE int32 ASpeakStageActor::GetCurrentStepIndex ( ) const

inline

ASpeakStageActor.h 파일의 38 번째 라인에서 정의되었습니다.

38{ return CurrentStepIndex; }

◆ GetLifetimeReplicatedProps()

void ASpeakStageActor::GetLifetimeReplicatedProps ( TArray< FLifetimeProperty > & OutLifetimeProps ) const

overridevirtual

Replication 설정

ASpeakStageActor.cpp 파일의 30 번째 라인에서 정의되었습니다.

{
    Super::GetLifetimeReplicatedProps(OutLifetimeProps);
 
    DOREPLIFETIME(ASpeakStageActor, CurrentSpeaker);
    DOREPLIFETIME(ASpeakStageActor, CurrentStepIndex);
}

다음을 참조함 : CurrentSpeaker, CurrentStepIndex.

◆ GetTotalQuestions()

int32 ASpeakStageActor::GetTotalQuestions ( ) const

ASpeakStageActor.cpp 파일의 103 번째 라인에서 정의되었습니다.

{
    if (ALingoPlayerState* PS = Cast<ALingoPlayerState>(CurrentSpeaker))
    {
        return PS->SpeakScenarioData.speak_quest_data.Num();
    }
    return 0;
}

다음을 참조함 : CurrentSpeaker.

다음에 의해서 참조됨 : USpeakWidget::UpdateSpeakStage().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ GetTotalQuestionsCount()

int32 ASpeakStageActor::GetTotalQuestionsCount ( )

ASpeakStageActor.cpp 파일의 127 번째 라인에서 정의되었습니다.

{
    if (ALingoPlayerState* PS = Cast<ALingoPlayerState>(CurrentSpeaker))
        return PS->SpeakScenarioData.speak_quest_data.Num();
    return 0;
}

다음을 참조함 : CurrentSpeaker.

다음에 의해서 참조됨 : AdvanceStep().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ IsMyTurn()

bool ASpeakStageActor::IsMyTurn ( class ALingoPlayerState * lingo_player_state )

ASpeakStageActor.cpp 파일의 191 번째 라인에서 정의되었습니다.

{
    if ( PlayerState == nullptr)
        return false;
 
    if ( CurrentSpeaker == nullptr)
        return false;
    
    return CurrentSpeaker == PlayerState;
}

다음을 참조함 : CurrentSpeaker.

◆ Multicast_NotifySpeakQuestStarted()

void ASpeakStageActor::Multicast_NotifySpeakQuestStarted ( const FString & PlayerName )

protected

모든 클라이언트에게 SpeakQuest 시작 알림 전송 (Multicast RPC)

매개변수

PlayerName [in] Quest를 시작한 플레이어 이름

다음에 의해서 참조됨 : StartStageForPlayer().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ NotifyAnswerComplete()

void ASpeakStageActor::NotifyAnswerComplete ( class ALingoPlayerState * Player )

플레이어 답변 완료 알림 (Server에서 호출됨)

매개변수

Player [in] 답변을 완료한 플레이어

ASpeakStageActor.cpp 파일의 90 번째 라인에서 정의되었습니다.

{
    if (!HasAuthority() || !Player)
        return;
 
    // 현재 발화자가 아니면 무시
    if (CurrentSpeaker != Player)
        return;
 
    // 다음 단계로 진행
    AdvanceStep();
}

다음을 참조함 : AdvanceStep(), CurrentSpeaker.

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ OnRep_CurrentSpeaker()

void ASpeakStageActor::OnRep_CurrentSpeaker ( )

protected

currentSpeaker 복제 알림

ASpeakStageActor.cpp 파일의 42 번째 라인에서 정의되었습니다.

{
    OnSpeakerChanged.Broadcast(CurrentSpeaker);
}

다음을 참조함 : CurrentSpeaker, OnSpeakerChanged.

◆ StartStageForPlayer()

void ASpeakStageActor::StartStageForPlayer ( class ALingoPlayerState * Player )

특정 플레이어에 대해 Speak Stage를 시작합니다.

(서버에서만 호출)

매개변수

Player [in] 스테이지를 시작할 플레이어의 PlayerState.

ASpeakStageActor.cpp 파일의 51 번째 라인에서 정의되었습니다.

{
    if (!HasAuthority() || !Player)
        return;
 
    // 이미 사용 중인 경우
    if (CurrentSpeaker != nullptr)
        return;
    
    // 플레이어를 현재 발화자로 설정
    CurrentSpeaker = Player;
    CurrentStepIndex = 0;
 
    // 서버 측 리스너에게 즉시 알림
    OnSpeakerChanged.Broadcast(CurrentSpeaker);
 
    // 모든 클라이언트에게 SpeakQuest 시작 알림 브로드캐스트
    FString PlayerName = ULingoGameHelper::GetPlayerNameFromState(Player);
    Multicast_NotifySpeakQuestStarted(PlayerName);
 
    // 클라이언트에게 현재 단계 정보(Toast, TTS)를 전송하고 UI 업데이트를 요청합니다.
    if (APlayerControl* PC = Cast<APlayerControl>(CurrentSpeaker->GetOwner()))
    {
        // 클라이언트에게 StepIndex를 전달하여 스스로 UI와 TTS를 처리하도록 합니다.
        PC->Client_UpdateSpeakQuest(CurrentStepIndex);
        PRINTLOG(TEXT("[SpeakStage] Sent StepIndex %d to client for update."), CurrentStepIndex);
    }
}

다음을 참조함 : CurrentSpeaker, CurrentStepIndex, ULingoGameHelper::GetPlayerNameFromState(), Multicast_NotifySpeakQuestStarted(), OnSpeakerChanged, PRINTLOG.

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

◆ CurrentSpeaker

TObjectPtr<class ALingoPlayerState> ASpeakStageActor::CurrentSpeaker

protected

현재 발화 권한을 가진 플레이어. nullptr이면 스테이지가 비어있음을 의미.

ASpeakStageActor.h 파일의 98 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ASpeakStageActor(), AdvanceStep(), EndStage(), GetCurrentQuestion(), GetLifetimeReplicatedProps(), GetTotalQuestions(), GetTotalQuestionsCount(), IsMyTurn(), NotifyAnswerComplete(), OnRep_CurrentSpeaker(), StartStageForPlayer().

◆ CurrentStepIndex

int32 ASpeakStageActor::CurrentStepIndex

protected

현재 진행 단계 (질문 인덱스)

ASpeakStageActor.h 파일의 102 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ASpeakStageActor(), AdvanceStep(), EndStage(), GetCurrentQuestion(), GetLifetimeReplicatedProps(), StartStageForPlayer().

◆ OnSpeakerChanged

FOnSpeakerChangedDelegate ASpeakStageActor::OnSpeakerChanged

현재 발화자가 변경될 때 호출되는 이벤트입니다.

ASpeakStageActor.h 파일의 93 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : EndStage(), OnRep_CurrentSpeaker(), AWheatly::SetSpeakStageActor(), StartStageForPlayer().

이 클래스에 대한 문서화 페이지는 다음의 파일들로부터 생성되었습니다.:

Source/Onepiece/Game/Public/ASpeakStageActor.h
Source/Onepiece/Game/Private/ASpeakStageActor.cpp

Public 멤버 함수

Public 속성

Protected 멤버 함수

Protected 속성

Private 멤버 함수

상세한 설명

생성자 & 소멸자 문서화

◆ ASpeakStageActor()

멤버 함수 문서화

◆ AdvanceStep()

◆ EndStage()

◆ GetCurrentQuestion()

◆ GetCurrentSpeaker()

◆ GetCurrentStepIndex()

◆ GetLifetimeReplicatedProps()

◆ GetTotalQuestions()

◆ GetTotalQuestionsCount()

◆ IsMyTurn()

◆ Multicast_NotifySpeakQuestStarted()

◆ NotifyAnswerComplete()

◆ OnRep_CurrentSpeaker()

◆ StartStageForPlayer()

멤버 데이터 문서화

◆ CurrentSpeaker

◆ CurrentStepIndex

◆ OnSpeakerChanged