GlobalAudioSubsystem.h

이 파일의 문서화 페이지로 가기

// Fill out your copyright notice in the Description page of Project Settings.
 
#pragma once
 
#include "CoreMinimal.h"
#include "Data/Audio/AudioData.h"
#include "DeveloperSettings/GlobalAudioSettings.h"
#include "FMODBlueprintStatics.h"
#include "FMODBus.h"
#include "GameplayTagContainer.h"
#include "Subsystems/GameInstanceSubsystem.h"
 
#include "GlobalAudioSubsystem.generated.h"
 
class UAudioData;
class UFMODAudioComponent;
class USceneComponent;
class UWorld;
 
UCLASS()
class CK_UE_API UGlobalAudioSubsystem : public UGameInstanceSubsystem
{
    GENERATED_BODY()
 
public:
    virtual void Initialize(FSubsystemCollectionBase& Collection) override;
    virtual void Deinitialize() override;
 
public:
    UFUNCTION(BlueprintCallable, Category = "Audio|BGM")
    bool PlayBGM(UAudioData* SourceAudioData, FGameplayTag BGMTag, bool bStopOtherBGM = true);
 
    UFUNCTION(BlueprintCallable, Category = "Audio|BGM")
    void StopBGM();
 
    UFUNCTION(BlueprintPure, Category = "Audio|BGM")
    bool IsPlayingBGM(FGameplayTag BGMTag) const;
 
    UFUNCTION(BlueprintCallable, Category = "Audio|Volume")
    void SetBGMVolume(float NewVolume);
 
    UFUNCTION(BlueprintCallable, Category = "Audio|Volume")
    void SetSFXVolume(float NewVolume);
 
    UFUNCTION(BlueprintCallable, Category = "Audio|Volume")
    void SetAMBVolume(float NewVolume);
 
public:
    UFUNCTION(BlueprintCallable, Category = "Audio|Tag")
    bool PlayAudioTagAtLocation(UAudioData* SourceAudioData, FGameplayTag AudioTag, FVector Location);
 
    UFUNCTION(BlueprintCallable, Category = "Audio|Tag")
    UFMODAudioComponent* StartLoopAudioTag(UAudioData* SourceAudioData, FGameplayTag AudioTag, USceneComponent* AttachToComponent);
 
    UFUNCTION(BlueprintCallable, Category = "Audio|Tag")
    void StopLoopAudio(UFMODAudioComponent* LoopAudioComponent);
 
public:
    UFUNCTION(BlueprintPure, Category = "Audio|Volume")
    FORCEINLINE float GetBGMVolume() const
    {
        return BGMVolume;
    }
 
    UFUNCTION(BlueprintPure, Category = "Audio|Volume")
    FORCEINLINE float GetSFXVolume() const
    {
        return SFXVolume;
    }
 
    UFUNCTION(BlueprintPure, Category = "Audio|Volume")
    FORCEINLINE float GetAMBVolume() const
    {
        return AMBVolume;
    }
 
private:
    // 재생 중인 BGM 하나의 상태.
    struct FActiveBGMEntry
    {
        FFMODEventInstance Instance {};
        bool bLevelChangeContinue = true;
    };
 
private:
    FORCEINLINE UFMODBus* GetBGMBus()
    {
        if (const UGlobalAudioSettings* Settings = GetDefault<UGlobalAudioSettings>())
        {
            return LoadBus(Settings->GetBGMBus(), CachedBGMBus);
        }
        else
        {
            return nullptr;
        }
    }
 
    FORCEINLINE UFMODBus* GetSFXBus()
    {
        if (const UGlobalAudioSettings* Settings = GetDefault<UGlobalAudioSettings>())
        {
            return LoadBus(Settings->GetSFXBus(), CachedSFXBus);
        }
        else
        {
            return nullptr;
        }
    }
 
    FORCEINLINE UFMODBus* GetAMBBus()
    {
        if (const UGlobalAudioSettings* Settings = GetDefault<UGlobalAudioSettings>())
        {
            return LoadBus(Settings->GetAMBBus(), CachedAMBBus);
        }
        else
        {
            return nullptr;
        }
    }
 
    FORCEINLINE UFMODBus* LoadBus(const TSoftObjectPtr<UFMODBus>& SourceBus, TObjectPtr<UFMODBus>& CachedBus)
    {
        if (CachedBus)
        {
            return CachedBus;
        }
 
        if (SourceBus.IsNull())
        {
            return nullptr;
        }
 
        CachedBus = SourceBus.LoadSynchronous();
        return CachedBus;
    }
 
    bool IsEventInstancePlaying(const FFMODEventInstance& EventInstance) const;
    void StopEventInstance(const FFMODEventInstance& EventInstance) const;
    void OnPostLoadMap(UWorld* LoadedWorld);
 
    void StopBGMByTag(FGameplayTag BGMTag);
 
private:
    UPROPERTY(Transient)
    TObjectPtr<UFMODBus> CachedBGMBus;
 
    UPROPERTY(Transient)
    TObjectPtr<UFMODBus> CachedSFXBus;
 
    UPROPERTY(Transient)
    TObjectPtr<UFMODBus> CachedAMBBus;
 
private:
    TMap<FGameplayTag, FActiveBGMEntry> ActiveBGMs;
 
    FDelegateHandle PostLoadMapHandle;
 
    float BGMVolume = 1.0f;
    float SFXVolume = 1.0f;
    float AMBVolume = 1.0f;
};