DataBundleRegistry.h

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

// Fill out your copyright notice in the Description page of Project Settings.
 
#pragma once
 
#include "CoreMinimal.h"
#include "Subsystems/GameInstanceSubsystem.h"
#include "GameplayTagContainer.h"
#include "DataBundleDefinition.h"
#include "CK_UE.h"
#include "DataBundleRegistry.generated.h"
 
 
struct FStreamableHandle;
 
DECLARE_MULTICAST_DELEGATE_OneParam(FOnBundleStateChanged, FGameplayTag /*BundleTag*/);
 
 
 
UENUM(BlueprintType)
enum class EDataBundleState : uint8
{
    Unloaded UMETA(DisplayName = "언로드됨"),
    Loading UMETA(DisplayName = "로딩 중"),
    Loaded UMETA(DisplayName = "로드됨"),
};
 
 
UCLASS()
class CK_UE_API UDataBundleRegistry : public UGameInstanceSubsystem
{
    GENERATED_BODY()
 
public:
    virtual void Initialize(FSubsystemCollectionBase& Collection) override;
 
    virtual void Deinitialize() override;
 
public:
    void RequestLoad(FGameplayTag BundleTag, TFunction<void()> OnReady = nullptr);
 
    void RequestLoad(const TArray<FGameplayTag>& BundleTags, TFunction<void()> OnAllReady);
 
    UFUNCTION(BlueprintCallable, Category = "Bundle")
    void Release(FGameplayTag BundleTag);
 
    UFUNCTION(BlueprintCallable, Category = "Bundle")
    void ForceRelease(FGameplayTag BundleTag);
 
    UFUNCTION(BlueprintCallable, Category = "Bundle")
    EDataBundleState GetState(FGameplayTag BundleTag) const;
 
    UFUNCTION(BlueprintCallable, Category = "Bundle")
    bool IsLoaded(FGameplayTag BundleTag) const;
 
    UFUNCTION(BlueprintCallable, Category = "Bundle")
    TArray<FGameplayTag> GetLoadedBundles() const;
 
    void ReleaseUnusedBundles(const TArray<FGameplayTag>& RequiredTags);
 
    template <typename T>
    T* GetBundleAsset(FGameplayTag BundleTag, const TSoftObjectPtr<T>& AssetPtr) const;
 
    template <typename T>
    void RequestBundleAsset(FGameplayTag BundleTag, const TSoftObjectPtr<T>& AssetPtr, TFunction<void(T*)> OnReady);
 
private:
    void ScanAndRegisterBundles();
 
    void PreLoadBundles();
 
    void OnAllDependenciesReady(FGameplayTag BundleTag);
 
    void OnAssetsLoaded(FGameplayTag BundleTag);
 
    void FlushPendingCallbacks(FGameplayTag BundleTag);
 
    void NotifyBundleLoadedToAssets(const TArray<UObject*>& Assets, FGameplayTag BundleTag);
    void NotifyBundleReleasedToAssets(const TArray<UObject*>& Assets, FGameplayTag BundleTag);
 
private:
    struct FBundleEntry
    {
        TSharedPtr<FStreamableHandle> Handle;
 
        EDataBundleState State = EDataBundleState::Unloaded;
 
        TArray<TFunction<void()>> PendingCallbacks;
    };
 
    UPROPERTY(Transient)
    TMap<FGameplayTag, TObjectPtr<UDataBundleDefinition>> Definitions;
 
    TMap<FGameplayTag, FBundleEntry> Entries;
};
 
 
#pragma region Template Implementations
 
template <typename T>
T* UDataBundleRegistry::GetBundleAsset(FGameplayTag BundleTag, const TSoftObjectPtr<T>& AssetPtr) const
{
    if (IsLoaded(BundleTag) == false)
    {
        LOG_WARNING(LogCKAsset, "번들 '%s'이 로드되지 않은 상태에서 GetBundleAsset 호출됨.", *BundleTag.ToString());
        return nullptr;
    }
 
    T* Asset = AssetPtr.Get();
 
    if (Asset == nullptr)
    {
        LOG_WARNING(LogCKAsset, "번들 '%s'의 에셋 '%s'이 메모리에 없습니다.", *BundleTag.ToString(), *AssetPtr.ToString());
    }
 
    return Asset;
}
 
 
template <typename T>
void UDataBundleRegistry::RequestBundleAsset(FGameplayTag BundleTag, const TSoftObjectPtr<T>& AssetPtr, TFunction<void(T*)> OnReady)
{
    TSoftObjectPtr<T> AssetCapture = AssetPtr;
 
    RequestLoad(BundleTag, [this, BundleTag, AssetCapture, OnReady = MoveTemp(OnReady)]()
    {
        T* Asset = AssetCapture.Get();
 
        if (Asset == nullptr)
        {
            LOG_WARNING(LogCKAsset, "RequestBundleAsset: 번들 '%s' 로드 완료 후에도 에셋을 찾을 수 없습니다: %s", *BundleTag.ToString(), *AssetCapture.ToString());
        }
 
        if (OnReady)
        {
            OnReady(Asset);
        }
    });
}
 
#pragma endregion