UUserSettingSubsystem 클래스 참조

#include <UserSettingSubsystem.h>

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

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

Public 멤버 함수
virtual void	Initialize (FSubsystemCollectionBase &Collection) override
void	ApplyUserGameSettingsToSaveGame (const UUserGameSettings *RuntimeSettings=nullptr) const
void	ApplySaveGameToUserGameSettings (UUserGameSettings *RuntimeSettings=nullptr) const
void	ApplyUserGameSettingsToCurrentGame (const UUserGameSettings *RuntimeSettings=nullptr) const
void	ApplyUserGameSettingsToCurrentGame (EUserGameSetting Setting, const UUserGameSettings *RuntimeSettings=nullptr) const
bool	LoadUserGameSettingsSaveGame ()
bool	SaveUserGameSettingsSaveGame () const
FORCEINLINE UUserGameSettings *	GetUserGameSettings () const
FORCEINLINE UUserGameSettingsSaveGame *	GetUserGameSettingsSaveGame () const

Protected 멤버 함수
bool	LoadUserGameSettingsData ()
bool	LoadAndApplyUserGameSettings (bool &LoadCompletion)

Protected 속성
TObjectPtr< UUserGameSettings >	UserGameSettings
TObjectPtr< UUserGameSettingsSaveGame >	UserGameSettingsSaveGame
FString	UserGameSettingsSlotName = TEXT("UserGameSettings")
int32	UserGameSettingsSlotUserIndex = 0

멤버 함수 문서화

ApplySaveGameToUserGameSettings()

void UUserSettingSubsystem::ApplySaveGameToUserGameSettings

(

UUserGameSettings *

RuntimeSettings = nullptr

)

const

{
    UUserGameSettings* RuntimeSettings = InRuntimeSettings ? InRuntimeSettings : UserGameSettings.Get();
 
    if (UserGameSettingsSaveGame == nullptr || RuntimeSettings == nullptr)
    {
        return;
    }
 
    TMap<EUserGameSetting, FInstancedStruct>& RuntimeSettingsMap = RuntimeSettings->GetMutableSettings();
 
    for (const TPair<EUserGameSetting, FInstancedStruct>& SavedPair : UserGameSettingsSaveGame->Settings)
    {
        FInstancedStruct* RuntimeStruct = RuntimeSettingsMap.Find(SavedPair.Key);
 
        if (RuntimeStruct == nullptr)
        {
            continue;
        }
 
        FSettingsBase* Setting = RuntimeStruct->GetMutablePtr<FSettingsBase>();
 
        if (Setting == nullptr)
        {
            continue;
        }
 
        Setting->SetSettingValue(SavedPair.Value);
    }
}

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

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

ApplyUserGameSettingsToCurrentGame() [1/2]

void UUserSettingSubsystem::ApplyUserGameSettingsToCurrentGame

(

const UUserGameSettings *

RuntimeSettings = nullptr

)

const

{
    const UUserGameSettings* RuntimeSettings = InRuntimeSettings ? InRuntimeSettings : UserGameSettings;
 
    if (RuntimeSettings == nullptr)
    {
        LOG_ERROR(LogCK, "RuntimeSettings가 nullptr입니다.");
        return;
    }
 
    const UEnum* UserGameSettingEnum = StaticEnum<EUserGameSetting>();
    check(UserGameSettingEnum);
 
    for (int32 Index = 1; Index < UserGameSettingEnum->NumEnums(); ++Index)
    {
        const int64 Idx = UserGameSettingEnum->GetValueByIndex(Index);
        const EUserGameSetting Setting = static_cast<EUserGameSetting>(Idx);
 
        if (Setting == EUserGameSetting::None)
        {
            continue;
        }
 
        const FInstancedStruct* SettingStruct = RuntimeSettings->GetSettings().Find(Setting);
 
        if (SettingStruct == nullptr)
        {
            continue;
        }
 
        const FSettingsBase* SettingBase = SettingStruct->GetPtr<FSettingsBase>();
 
        if (SettingBase == nullptr)
        {
            LOG_ERROR(LogCK, "%s로 변환할 수 없습니다.", NAMEOF(FSettingsBase));
            continue;
        }
 
        SettingBase->ApplySettings(RuntimeSettings, GetGameInstance());
    }
 
    UGameUserSettings* CurrentGameUserSettings = GEngine->GetGameUserSettings();
    checkf(CurrentGameUserSettings, TEXT("%s를 가져올 수 없습니다."), NAMEOF(UGameUserSettings));
    CurrentGameUserSettings->ApplySettings(false);
}

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

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

ApplyUserGameSettingsToCurrentGame() [2/2]

void UUserSettingSubsystem::ApplyUserGameSettingsToCurrentGame	(	EUserGameSetting	Setting,
		const UUserGameSettings *	RuntimeSettings = nullptr
	)		const

{
    if (Setting == EUserGameSetting::None)
    {
        return;
    }
 
    const UUserGameSettings* RuntimeSettings = InRuntimeSettings ? InRuntimeSettings : UserGameSettings;
    check(RuntimeSettings);
 
    const FInstancedStruct* SettingStruct = RuntimeSettings->GetSettings().Find(Setting);
 
    if (SettingStruct == nullptr)
    {
        return;
    }
 
    const FSettingsBase* SettingBase = SettingStruct->GetPtr<FSettingsBase>();
 
    if (SettingBase == nullptr)
    {
        LOG_ERROR(LogCK, "%s로 변환할 수 없습니다.", NAMEOF(FSettingsBase));
        return;
    }
 
    SettingBase->ApplySettings(RuntimeSettings, GetGameInstance());
 
    UGameUserSettings* CurrentGameUserSettings = GEngine->GetGameUserSettings();
    checkf(CurrentGameUserSettings, TEXT("%s를 가져올 수 없습니다."), NAMEOF(UGameUserSettings));
    CurrentGameUserSettings->ApplySettings(false);
}

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

ApplyUserGameSettingsToSaveGame()

void UUserSettingSubsystem::ApplyUserGameSettingsToSaveGame

(

const UUserGameSettings *

RuntimeSettings = nullptr

)

const

{
    const UUserGameSettings* RuntimeSettings = InRuntimeSettings ? InRuntimeSettings : UserGameSettings;
 
    if (UserGameSettingsSaveGame == nullptr || RuntimeSettings == nullptr)
    {
        return;
    }
 
    UserGameSettingsSaveGame->Settings.Empty();
 
    for (const TPair<EUserGameSetting, FInstancedStruct>& SettingPair : RuntimeSettings->GetSettings())
    {
        const FSettingsBase* Setting = SettingPair.Value.GetPtr<FSettingsBase>();
 
        if (Setting == nullptr)
        {
            continue;
        }
 
        UserGameSettingsSaveGame->Settings.Add(SettingPair.Key, Setting->GetSettingValue());
    }
}

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

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

GetUserGameSettings()

FORCEINLINE UUserGameSettings * UUserSettingSubsystem::GetUserGameSettings ( ) const

inline

    {
        return UserGameSettings;
    }

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

GetUserGameSettingsSaveGame()

FORCEINLINE UUserGameSettingsSaveGame * UUserSettingSubsystem::GetUserGameSettingsSaveGame ( ) const

inline

    {
        return UserGameSettingsSaveGame;
    }

Initialize()

void UUserSettingSubsystem::Initialize ( FSubsystemCollectionBase &  Collection )

overridevirtual

{
    Super::Initialize(Collection);
    FTimerManager& TimerManager = GetWorld()->GetTimerManager();
 
    if (LoadUserGameSettingsData() == false)
    {
        return;
    }
 
    if (LoadUserGameSettingsSaveGame() == false)
    {
        return;
    }
 
    TimerManager.SetTimerForNextTick([this]()
    {
        ApplySaveGameToUserGameSettings();
        ApplyUserGameSettingsToCurrentGame();
    });
}

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

LoadAndApplyUserGameSettings()

bool UUserSettingSubsystem::LoadAndApplyUserGameSettings ( bool &  LoadCompletion )

protected

{
    USaveGame* SaveGame = UGameplayStatics::LoadGameFromSlot(UserGameSettingsSlotName, UserGameSettingsSlotUserIndex);
    UserGameSettingsSaveGame = Cast<UUserGameSettingsSaveGame>(SaveGame);
 
    if (UserGameSettingsSaveGame == nullptr)
    {
        LOG_ERROR(LogCK, "%s 슬롯 로드에 실패했습니다.", *UserGameSettingsSlotName);
        return false;
    }
 
    if (UserGameSettingsSaveGame->Settings.IsEmpty() == false)
    {
        LoadCompletion = true;
        return true;
    }
 
    if (UserGameSettings == nullptr && LoadUserGameSettingsData() == false)
    {
        LoadCompletion = false;
        return true;
    }
 
    ApplyUserGameSettingsToSaveGame();
    LoadCompletion = SaveUserGameSettingsSaveGame();
    return true;
}

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

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

LoadUserGameSettingsData()

bool UUserSettingSubsystem::LoadUserGameSettingsData ( )

protected

{
    if (UserGameSettings)
    {
        return true;
    }
 
    const UUserGameSettings* DefaultUserSettings = GetDefault<UUserGameSettings>();
 
    UserGameSettings = DuplicateObject<UUserGameSettings>(DefaultUserSettings, this);
 
    if (UserGameSettings)
    {
        return true;
    }
 
    LOG_ERROR(LogCK, "UserGameSettings 복제에 실패했습니다.");
    return false;
}

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

LoadUserGameSettingsSaveGame()

bool UUserSettingSubsystem::LoadUserGameSettingsSaveGame

(

)

{
    bool LoadCompletion = false;
 
    if (UGameplayStatics::DoesSaveGameExist(UserGameSettingsSlotName, UserGameSettingsSlotUserIndex) && LoadAndApplyUserGameSettings(LoadCompletion))
    {
        return LoadCompletion;
    }
 
    UserGameSettingsSaveGame = Cast<UUserGameSettingsSaveGame>(UGameplayStatics::CreateSaveGameObject(UUserGameSettingsSaveGame::StaticClass()));
 
    if (UserGameSettingsSaveGame == nullptr)
    {
        LOG_ERROR(LogCK, "%s 생성에 실패했습니다.", NAMEOF(UUserGameSettingsSaveGame));
        return false;
    }
 
    if (UserGameSettings == nullptr && LoadUserGameSettingsData() == false)
    {
        return false;
    }
 
    ApplyUserGameSettingsToSaveGame();
    const bool bResult = SaveUserGameSettingsSaveGame();
    return bResult;
}

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

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

SaveUserGameSettingsSaveGame()

bool UUserSettingSubsystem::SaveUserGameSettingsSaveGame

(

)

const

{
    if (UserGameSettingsSaveGame == nullptr)
    {
        LOG_ERROR(LogCK, "저장할 UserGameSettingsSaveGame이 nullptr입니다.");
        return false;
    }
    else
    {
        return UGameplayStatics::SaveGameToSlot(UserGameSettingsSaveGame, UserGameSettingsSlotName, UserGameSettingsSlotUserIndex);
    }
}

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

멤버 데이터 문서화

UserGameSettings

TObjectPtr<UUserGameSettings> UUserSettingSubsystem::UserGameSettings

protected

UserGameSettingsSaveGame

TObjectPtr<UUserGameSettingsSaveGame> UUserSettingSubsystem::UserGameSettingsSaveGame

protected

UserGameSettingsSlotName

FString UUserSettingSubsystem::UserGameSettingsSlotName = TEXT("UserGameSettings")

protected

UserGameSettingsSlotUserIndex

int32 UUserSettingSubsystem::UserGameSettingsSlotUserIndex = 0

protected

---

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

• Source/CK_UE/Subsystem/GameInstance/UserSettingSubsystem.h
• Source/CK_UE/Subsystem/GameInstance/UserSettingSubsystem.cpp