开始使用 UGS#

本主题介绍如何设置项目以使用 Unity Gaming Services（Unity 游戏服务）。

先决条件

如果您尚未完成以下操作，请在开始入门流程之前完成以下操作：

• 创建 Unity 帐户。
• 了解定价与计费。

使用 Unity 引擎的游戏#

要开始在 Unity 项目中使用 UGS，请执行以下操作：

1. 创建新的 Unity Cloud 项目。
   • 对于新项目，请在 Unity Hub 中创建一个项目。此过程会自动在 Unity Cloud Dashboard 中创建您的项目。
   • 对于现有的 Unity 项目：
     1. 在 Unity Cloud Dashboard 中创建一个项目。
     2. 将项目关联到 Unity 编辑器项目。
2. 安装所需的 UGS 包。
3. 为您的 SDK 导入命名空间。
4. 在游戏代码中初始化 UGS。
5. 创建您的第一个 Cloud Code 脚本。

使用 REST API 的游戏#

如果您使用的是其他游戏引擎，可以使用 REST API 在您的游戏中实现 UGS。要开始使用 UGS，请执行以下操作：

1. 在 Unity Cloud Dashboard 中创建一个项目。
2. 参阅 REST API 入门文档。

如果使用 Unreal Engine，也可以在游戏中实现一些 UGS 功能，为此需使用：

• 适用于 Unreal Engine 的 Unity Gaming Services SDK 实现：
  • 身份验证
  • Multiplay Hosting
  • Matchmaker
• Vivox Unreal SDK

在 Unity Hub 中创建一个项目#

为了创建连接到 Unity Cloud 的新项目，最快的方法是通过 Unity Hub。

1. 在 Unity Hub 中，选择 New project（新建项目）。
2. 输入必填字段的值，包括您的 Unity Organization（Unity 组织）。
3. 确保选中 **Connect to Unity Cloud（连接到 Unity Cloud）**复选框。

新的 Unity 项目将在 Unity Cloud Dashboard 中自动创建，无需手动连接。

您已经可以在 Unity Cloud Dashboard 中开始浏览服务。要集成所需的服务，请继续安装 UGS 包。

在 Unity Cloud Dashboard 中创建一个项目#

从 Unity Cloud Dashboard 管理您的项目和服务。要创建新项目，请执行以下操作：

1. 从主导航菜单中选择 Projects（项目）。
2. 在 **Projects（项目）**页面的右上角选择 New（新建）。
3. 输入项目名称和 COPPA 定位。
4. 选择 Create（创建）。

您现在可以在 Unity Cloud Dashboard 中配置您的项目，并在与 Unity 编辑器项目集成之前开始配置一些服务。例如，配置 Economy 项或创建 Game Overrides。接下来，将 Unity Cloud 项目关联到 Unity 编辑器项目。

了解有关管理 Unity 项目的更多信息。

在 Unity 编辑器中关联您的项目#

要使用 Unity Gaming Services（Unity 游戏服务），您必须在 Unity 编辑器中将项目关联到 Unity Cloud 项目。

要在编辑器中关联您的项目，请执行以下操作：

1. 选择 Edit（编辑）> Project Settings（项目设置）> Services（服务）。
2. 选择 Use an existing Unity project ID（使用现有 Unity Project ID）。
3. 从下拉菜单中选择组织和项目。
4. 选择 Link project ID（关联 Project ID）。

了解有关将项目关联到 Unity Cloud Dashboard 的更多信息。

安装 UGS 包#

安装您想要在项目中实现的服务的相应包。要查看和安装适用于 UGS 的包，请执行以下操作：

1. 在 Unity 编辑器中，选择 Window（窗口）> Package Manager（包管理器）。
2. 在 Package Manager（包管理器）中，选择 **Unity Registry（Unity 注册表）**列表视图。
3. 搜索包名称，或在注册表列表中找到包。
4. 选择包，然后单击 Install（安装）。

您还可以在搜索栏中输入 services（服务），随即将返回除 Remote Config 之外的所有服务的结果。

在编辑器 2022.1 或更高版本中，Package Manager（包管理器）的 **Services（服务）**选项卡会显示所有可用于 UGS 的包。

导入 SDK 命名空间#

要访问 SDK 的 API，必须在脚本中导入 SDK 的命名空间。例如，对于 Analytics：

using Unity.Services.Analytics;

在游戏代码中初始化 Unity Services#

在调用任何服务功能之前，必须初始化 Services Core SDK。建议的最佳做法是在游戏运行时尽早初始化服务，最好是在启动时。

要在游戏代码中初始化 Unity Services，请创建一个导入 Services Core 命名空间 (Unity.Services.Core) 的脚本，然后调用 InitializeAsync 方法。例如：

using System;
using Unity.Services.Core;
using UnityEngine;

public class InitializationExample : MonoBehaviour
{
	async void Awake()
	{
		try
		{
			await UnityServices.InitializeAsync();
		}
		catch (Exception e)
		{
			Debug.LogException(e);
		}
	}
}

此方法用于初始化项目中安装的所有 Unity Gaming Services（Unity 游戏服务）。您可以使用 State 方法在运行时检查游戏的初始化状态。如需了解更多信息，请参阅 Services Core API 文档。

创建您的第一个 Cloud Code 脚本及其他#

自定义服务器权威经济逻辑或游戏逻辑是 Unity Gaming Services（Unity 游戏服务）最常见的用途之一。此 Cloud Code 演练包含快速入门所需的一切信息，包括安装、初始化、后台配置以及从游戏客户端远程执行简单的 Cloud Code 脚本。

后续步骤#

• 参阅 Unity 的用例示例项目，获取 UGS 功能的使用灵感。
• 实现各项服务。
• 使用 UGS CLI 或 Deployment（部署）窗口来简化配置管理工作流程。