使用 C++ 保存游戏

本页面的内容：

创建 SaveGame 对象

SaveGame 类定义了一个对象结构，该结构可供 Kismet/GameplayStatics.h 中的存盘和读取的函数调用来使用。

要新建基于 SaveGame 的类可使用 C++类向导 。

SaveGameCode.png

在本例中，新建的 SaveGame 类称为 MySaveGame。

头文件

在这个 SaveGame 类的头文件中，您可以声明任意想要存储的变量。 

UPROPERTY(VisibleAnywhere, Category = Basic)
FString PlayerName;

在本示例中，还有一些已声明的变量，这些变量将用于存储 SaveSlotName 和 UserIndex 的默认值，保存至此 SaveGame 对象的各类 就不必单独设置这些变量了。此步骤为可选步骤，将产生一个保存槽，如果默认值未发生变化，则该保存槽将被覆盖。

MySaveGame.h 

// Copyright 1998-2017 Epic Games, Inc. All Rights Reserved.

#pragma once

#include "GameFramework/SaveGame.h"
#include "MySaveGame.generated.h"

/**
 * 
 */
UCLASS()
class [PROJECTNAME]_API UMySaveGame : public USaveGame
{
    GENERATED_BODY()

    public:

    UPROPERTY(VisibleAnywhere, Category = Basic)
    FString PlayerName;

    UPROPERTY(VisibleAnywhere, Category = Basic)
    FString SaveSlotName;

    UPROPERTY(VisibleAnywhere, Category = Basic)
    uint32 UserIndex;

    UMySaveGame();
};

源文件

通常，SaveGame 对象的源文件无需为功能编写特定代码，除非您的特定保存系统有您想要在此设置的 附加功能。

本例中，我们在类构建器中定义了 SaveSlotName 和 UserIndex 的值，以便其他游戏类可读取及使用这些值。

MySaveGame.cpp 

// Copyright 1998-2017 Epic Games, Inc. All Rights Reserved.

#include "[ProjectName].h"
#include "MySaveGame.h"

UMySaveGame::UMySaveGame()
{
    SaveSlotName = TEXT("TestSaveSlot");
    UserIndex = 0;
}

模块头文件

为了能从 GameplayStatics 同时方便地存取 SaveGame 对象及创建、保存和加载功能，您应在游戏模块的头文件中的 任何其他 #include 语句下面加入以下行。您的模块头文件将会自动命名为 [ProjectName].h。

MyProject.h 

#include "MySaveGame.h"
#include "Kismet/GameplayStatics.h"

需要保证这些 #include 语句添加在 #include "Engine.h" 之后，否则编译会失败。

保存变量

当想要在 SaveGame 的对象中保存变量的时候，必须先创建一个 SaveGame 的对象实例，然后再实例中设置需要的变量。 

PlayerName = TEXT("PlayerOne");
UMySaveGame* SaveGameInstance = Cast<UMySaveGame>(UGameplayStatics::CreateSaveGameObject(UMySaveGame::StaticClass()));
SaveGameInstance->PlayerName = MyPlayerName;
UGameplayStatics::SaveGameToSlot(SaveGameInstance, SaveGameInstance->SaveSlotName, SaveGameInstance->UserIndex);

加载变量

若要加载变量，您必须先使用 UGameplayStatics::LoadGameFromSlot 加载 SaveGame 对象。这样做将创建一个 SaveGame 对象的新实例。

同上示例，本示例中先创建了一个空的 SaveGame 对象，因此可从该对象中读取默认的 SaveSlotName 和 UserIndex。此步骤为可选步骤，可能无法适用于所有游戏实施。

从硬盘驱动器加载新的 SaveGame 对象后，即可从该对象中读取变量值，并将其指派给所需的 actor 或类，或者如此处所示直接使用。 

UMySaveGame* LoadGameInstance = Cast<UMySaveGame>(UGameplayStatics::CreateSaveGameObject(UMySaveGame::StaticClass()));
LoadGameInstance = Cast<UMySaveGame>(UGameplayStatics::LoadGameFromSlot(LoadGameInstance->SaveSlotName, LoadGameInstance->UserIndex));
FString PlayerNameToDisplay = LoadGameInstance->PlayerName;
if (GEngine)
{
    GEngine->AddOnScreenDebugMessage(-1, 5.f, FColor::Yellow, PlayerNameToDisplay);
}
完整内容索引