게임 내 모든 사운드 재생을 관리하는 중앙 사운드 관리 서브시스템입니다. 더 자세히 ...

#include <UGameSoundManager.h>

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

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

Public 멤버 함수
	UGameSoundManager ()

	DEFINE_SUBSYSTEM_GETTER_INLINE (UGameSoundManager)

EGameSoundType	GetCurrentBGMType () const

virtual void	Initialize (FSubsystemCollectionBase &Collection) override

bool	IsConversationVoicePlaying () const

void	PlayBGM (EGameSoundType Type)
	BGM을 재생합니다.

UAudioComponent *	PlayConversationVoice (USoundBase *Sound)

void	PlaySound (EGameSoundType Type, FVector Location)

void	PlaySound2D (EGameSoundType Type)

void	StopBGM ()
	현재 재생 중인 BGM을 중지합니다.

void	StopConversationVoice ()

void	StopSound2D (const EGameSoundType Type)

Private 속성
TMap< EGameSoundType, UAudioComponent * >	ActiveSounds

TObjectPtr< UAudioComponent >	ConversationVoice

TObjectPtr< UAudioComponent >	CurrentBGM

EGameSoundType	CurrentBGMType

TObjectPtr< class USoundData >	SoundAsset

TMap< EGameSoundType, TObjectPtr< class USoundBase > >	SoundData

상세한 설명

게임 내 모든 사운드 재생을 관리하는 중앙 사운드 관리 서브시스템입니다.

2D 및 3D 사운드 재생, 중지 기능을 제공하며, 특히 대화 음성과 같이 단일 인스턴스만 허용되어야 하는 사운드를 별도로 제어합니다.

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

생성자 & 소멸자 문서화

◆ UGameSoundManager()

UGameSoundManager::UGameSoundManager ( )

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

{
    // FComponentHelper를 사용해 생성자에서 안전하게 에셋을 로드합니다.
    if (auto LoadedAsset = FComponentHelper::LoadAsset<USoundData>(SOUND_DATA_PATH))
    {
        for (const auto& Pair : LoadedAsset->SoundData)
        {
            SoundAsset = LoadedAsset;
            SoundData = SoundAsset->SoundData;
            
            TSoftObjectPtr<USoundBase> SoundAssetPtr = Pair.Value;
            if (!SoundAssetPtr.IsNull()) {
                SoundData.Add(Pair.Key, SoundAssetPtr.LoadSynchronous());
            }
        }
    }
    else
    {
        // 실패 시, 에디터 실행 시 Output Log에 에러를 출력합니다.
        UE_LOG(LogTemp, Error, TEXT("UGameSoundManager failed to load USoundData at path: %s"), SOUND_DATA_PATH);
    }
}

다음을 참조함 : FComponentHelper::LoadAsset(), SOUND_DATA_PATH, SoundAsset, SoundData.

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

멤버 함수 문서화

◆ DEFINE_SUBSYSTEM_GETTER_INLINE()

UGameSoundManager::DEFINE_SUBSYSTEM_GETTER_INLINE ( UGameSoundManager )

◆ GetCurrentBGMType()

EGameSoundType UGameSoundManager::GetCurrentBGMType ( ) const

inline

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

65{ return CurrentBGMType;}

UGameSoundManager::CurrentBGMType

EGameSoundType CurrentBGMType

Definition UGameSoundManager.h:86

◆ Initialize()

void UGameSoundManager::Initialize ( FSubsystemCollectionBase & Collection )

overridevirtual

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

{
    Super::Initialize(Collection);
 
    // FSoftObjectPath AssetPath(SOUND_DATA_PATH);
    // USoundData* LoadedAsset = Cast<USoundData>(StaticLoadObject(USoundData::StaticClass(), nullptr, *AssetPath.ToString()));
    //
    // if (LoadedAsset)
    // {
    //  for (const auto& Pair : LoadedAsset->SoundData)
    //  {
    //      SoundAsset = LoadedAsset;
    //      SoundData = SoundAsset->SoundData;
    //      
    //      TSoftObjectPtr<USoundBase> SoundAssetPtr = Pair.Value;
    //      if (!SoundAssetPtr.IsNull())
    //      {
    //          SoundData.Add(Pair.Key, SoundAssetPtr.LoadSynchronous());
    //      }
    //  }
    // }
    // else
    if (!SoundAsset)
    {
        UE_LOG(LogTemp, Error, TEXT("Failed to load SoundDataAsset from path"));
    }
}

다음을 참조함 : SoundAsset.

◆ IsConversationVoicePlaying()

bool UGameSoundManager::IsConversationVoicePlaying ( ) const

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

{
    return ConversationVoice && ConversationVoice->IsPlaying();
}

다음을 참조함 : ConversationVoice.

◆ PlayBGM()

void UGameSoundManager::PlayBGM ( EGameSoundType Type )

BGM을 재생합니다.

이미 같은 BGM이 재생 중이면 유지하고, 다른 BGM이면 전환합니다.

매개변수

Type	재생할 BGM 타입

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

{
    // 이미 같은 BGM 타입이고, AudioComponent가 유효하며 재생 중인지 확인
    // (레벨 전환 시 AudioComponent가 파괴되므로 IsValid 체크 필수)
    if ( CurrentBGMType == Type &&
         IsValid(CurrentBGM)
         && CurrentBGM->IsPlaying())
    {
        return;
    }
    
    // 기존 BGM 중지
    StopBGM();
 
    // 새 BGM 재생
    if (TObjectPtr<USoundBase>* FoundSound = SoundData.Find(Type))
    {
        if (*FoundSound)
        {
            // bPersistAcrossLevelTransition = true로 설정하여 레벨 전환에도 유지되도록 함
            CurrentBGM = UGameplayStatics::CreateSound2D(
                GetWorld(),
                *FoundSound,
                1.0f,  // VolumeMultiplier
                1.0f,  // PitchMultiplier
                0.0f,  // StartTime
                nullptr,  // ConcurrencySettings
                true,  // bPersistAcrossLevelTransition - 레벨 전환에도 유지
                false  // bAutoDestroy
            );
 
            if (CurrentBGM)
            {
                CurrentBGM->Play();
                CurrentBGMType = Type;
            }
        }
    }
}

다음을 참조함 : CurrentBGM, CurrentBGMType, SoundData, StopBGM().

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

◆ PlayConversationVoice()

UAudioComponent * UGameSoundManager::PlayConversationVoice ( USoundBase * Sound )

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

{
    if (!Sound)
        return nullptr;
 
    // 기존 대화 음성이 재생 중이면 중지
    StopConversationVoice();
 
    // 새로운 대화 음성 재생
    ConversationVoice = UGameplayStatics::SpawnSound2D(GetWorld(), Sound);
    return ConversationVoice;
}

다음을 참조함 : ConversationVoice, StopConversationVoice().

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

◆ PlaySound()

void UGameSoundManager::PlaySound	(	EGameSoundType	Type,
		FVector	Location
	)

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

{
    if (TObjectPtr<USoundBase>* FoundSound = SoundData.Find(Type))
    {
        if (*FoundSound)
        {
            UGameplayStatics::PlaySoundAtLocation(GetWorld(), *FoundSound, Location);
        }
    }
}

다음을 참조함 : SoundData.

◆ PlaySound2D()

void UGameSoundManager::PlaySound2D ( EGameSoundType Type )

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

{
    if (TObjectPtr<USoundBase>* FoundSound = SoundData.Find(Type))
    {
        if (*FoundSound)
        {
            // 이미 재생 중인 사운드가 있다면 멈추고 제거
            if (UAudioComponent* ExistingComp = ActiveSounds.FindRef(Type))
            {
                ExistingComp->Stop();
                ActiveSounds.Remove(Type);
            }
 
            // 새로운 사운드 재생 및 저장
            if (UAudioComponent* NewComp = UGameplayStatics::SpawnSound2D(GetWorld(), *FoundSound))
            {
                ActiveSounds.Add(Type, NewComp);
            }
        }
    }
}

다음을 참조함 : ActiveSounds, SoundData.

◆ StopBGM()

void UGameSoundManager::StopBGM ( )

현재 재생 중인 BGM을 중지합니다.

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

{
    if (IsValid(CurrentBGM) && CurrentBGM->IsPlaying())
    {
        CurrentBGM->Stop();
    }
    CurrentBGM = nullptr;
}

다음을 참조함 : CurrentBGM.

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

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

◆ StopConversationVoice()

void UGameSoundManager::StopConversationVoice ( )

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

{
    if (ConversationVoice && ConversationVoice->IsPlaying())
    {
        ConversationVoice->Stop();
    }
    ConversationVoice = nullptr;
}

다음을 참조함 : ConversationVoice.

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

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

◆ StopSound2D()

void UGameSoundManager::StopSound2D ( const EGameSoundType Type )

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

{
    if (UAudioComponent* Comp = ActiveSounds.FindRef(Type))
    {
        Comp->Stop();
        ActiveSounds.Remove(Type);
    }
}

다음을 참조함 : ActiveSounds.

멤버 데이터 문서화

◆ ActiveSounds

TMap<EGameSoundType, UAudioComponent*> UGameSoundManager::ActiveSounds

private

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

다음에 의해서 참조됨 : PlaySound2D(), StopSound2D().

◆ ConversationVoice

TObjectPtr<UAudioComponent> UGameSoundManager::ConversationVoice

private

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

다음에 의해서 참조됨 : IsConversationVoicePlaying(), PlayConversationVoice(), StopConversationVoice().

◆ CurrentBGM

TObjectPtr<UAudioComponent> UGameSoundManager::CurrentBGM

private

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

다음에 의해서 참조됨 : PlayBGM(), StopBGM().

◆ CurrentBGMType

EGameSoundType UGameSoundManager::CurrentBGMType

private

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

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

◆ SoundAsset

TObjectPtr<class USoundData> UGameSoundManager::SoundAsset

private

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

다음에 의해서 참조됨 : UGameSoundManager(), Initialize().

◆ SoundData

TMap<EGameSoundType, TObjectPtr<class USoundBase> > UGameSoundManager::SoundData

private

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

다음에 의해서 참조됨 : UGameSoundManager(), PlayBGM(), PlaySound(), PlaySound2D().

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

Source/LatteLibrary/Manager/Public/UGameSoundManager.h
Source/LatteLibrary/Manager/Private/UGameSoundManager.cpp

Public 멤버 함수

Private 속성

상세한 설명

생성자 & 소멸자 문서화

◆ UGameSoundManager()

멤버 함수 문서화

◆ DEFINE_SUBSYSTEM_GETTER_INLINE()

◆ GetCurrentBGMType()

◆ Initialize()

◆ IsConversationVoicePlaying()

◆ PlayBGM()

◆ PlayConversationVoice()

◆ PlaySound()

◆ PlaySound2D()

◆ StopBGM()

◆ StopConversationVoice()

◆ StopSound2D()

멤버 데이터 문서화

◆ ActiveSounds

◆ ConversationVoice

◆ CurrentBGM

◆ CurrentBGMType

◆ SoundAsset

◆ SoundData