开始使用#

安装 Cloud Save SDK#

可以通过 Unity 编辑器安装软件包。

导航到 Window（窗口）> Package Manager（包管理器），然后在左上方的 Packages（包）下拉选单中选择 Unity Registry（Unity 注册表）。您可以执行以下任一操作：

• 在右上方的搜索栏中搜索 Cloud Save。
• 按名称添加包。打开 + 所示的下拉选单，然后选择 Add package by name...（按名称添加包...）。搜索 SDK 包 ID com.unity.services.cloudsave，不包含其版本。

安装完成后，可在 Unity 脚本中通过引用 Unity.Services.CloudSave 命名空间使用 Cloud Save SDK。

using Unity.Services.CloudSave;

安装 Authentication SDK#

Cloud Save 包依赖于 Authentication 包。Unity Authentication 服务创建一个帐户来保存玩家分数，您可以使用匿名登录或指定平台身份验证。

安装 Cloud Save 包时，Authentication 包作为依赖项进行安装。有关手动安装包的信息，请参阅通过注册表安装包。

安装完成后，可在 Unity 脚本中通过引用 Unity.Services.Authentication 命名空间使用 Authentication SDK。

using Unity.Services.Authentication;

关联您的 Unity 项目#

安装完成后，Authentication 包会提示您将 Unity 项目与 Unity Game Services Project ID 关联。

可以按照以下步骤，手动将 Unity 项目与 Project ID 关联：

• 在 Unity 编辑器中，选择 Edit（编辑）> Project Settings...（项目设置...）。
• 选择 Services（服务），
  • 如果您有 Unity ID，请登录。
  • 否则，选择 Create a Unity ID（创建 Unity ID）。
• 选择您的项目。
• 选择 Link（关联）。

初始化 SDK 并对玩家进行身份验证#

在使用 Cloud Save SDK 及其依赖项之前，必须先从 Unity 脚本生命周期回调中对它们进行初始化。

实现方法是通过 Core SDK 调用 await UnityServices.InitializeAsync()（引用 Unity.Services.Core 命名空间）来初始化所有已安装的服务。

SDK 初始化完成后，会对玩家进行身份验证。以下示例使用匿名身份验证来为玩家创建匿名帐户，以便保存其分数。有关其他可用的身份验证方法，请参阅 Unity Authentication 文档。

using UnityEngine;
using Unity.Services.Core;
using Unity.Services.Authentication;

public class CloudSaveSample : MonoBehaviour
{
  private async void Awake()
    {
        await UnityServices.InitializeAsync();
        await AuthenticationService.Instance.SignInAnonymouslyAsync();
    }
}

Cloud Save REST API#

您可以使用 REST API 访问 Cloud Save 中的数据。

REST API 提供更大的灵活性，让您可以利用喜欢的语言和游戏开发引擎来自动执行工作流程。

Cloud Save 服务提供以下 REST API：

• 用于玩家操作（例如保存/加载数据）的 Cloud Save Player API
• 用于管理操作（例如配置查询/索引）的 Cloud Save Admin API

其他资源#

• 通过 Unity 使用 Cloud Save
• 面向 Cloud Code 的 Cloud Save SDK
• Unity Dashboard（Unity 后台）
• Package Manager（包管理器）
• Unity Authentication