UGS 使用入门#

本主题介绍如何设置您的项目以使用 Unity Gaming Services。

先决条件#

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

• 创建一个 Unity 帐户。.
• 了解定价和账单。

使用 Unity 引擎的游戏#

要开始在您的 Unity 项目中使用 UGS

1. 创建一个新的 Unity 云项目。
   • 对于新项目，请在 Unity Hub 中创建一个项目。这将在 Unity 云面板中自动创建您的项目。
   • 对于现有的 Unity 项目
     1. 在 Unity 云面板中创建一个项目。
     2. 将您的项目链接到 Unity 编辑器项目。
2. 安装您需要的 UGS 包。
3. 为您的 SDK 导入命名空间。
4. 在您的游戏代码中初始化 UGS。
5. 创建您的第一个云代码脚本。

使用 REST API 的游戏#

如果您使用其他游戏引擎，则可以使用 REST API 在您的游戏中实现 UGS。要开始使用 UGS

1. 在 Unity 云面板中创建一个项目。
2. 请参阅 REST API 入门文档。

如果您使用虚幻引擎，您还可以使用以下内容在您的游戏中实现一些 UGS 功能

• 适用于虚幻引擎的 Unity Gaming Services SDK，以实现
  • 身份验证
  • 游戏服务器托管
  • 匹配系统
• Vivox 虚幻 SDK

在 Unity Hub 中创建项目#

创建与 Unity 云连接的新项目的最快方法是通过 Unity Hub。

1. 在 Unity Hub 中，选择“新建项目”。
2. 输入必填字段，包括您的 Unity 组织。
3. 确保选中“连接到 Unity 云”复选框。

您的新 Unity 项目将在 Unity 云面板中自动创建，您无需手动连接它们。

您已经可以开始浏览 Unity 云面板中的服务。要集成服务，请继续安装 UGS 包。

在 Unity 云面板中创建项目#

从Unity 云面板管理您的项目和服务。要创建新项目

1. 从主导航菜单中选择“项目”。
2. 在“项目”页面右上角选择“新建”。
3. 输入项目名称和COPPA指定。
4. 选择“创建”。

您现在可以在 Unity 云面板中配置您的项目，并在与 Unity 编辑器项目集成之前开始配置一些服务。例如，配置经济项目或创建游戏覆盖。接下来，将您的 Unity 云项目链接到 Unity 编辑器项目。

详细了解管理 Unity 项目。

在 Unity 编辑器中链接您的项目#

要使用 Unity Gaming Services，您必须将 Unity 编辑器中的项目链接到 Unity 云项目。

要在编辑器中链接您的项目

1. 选择“编辑”>“项目设置”>“服务”。
2. 选择“使用现有的 Unity 项目 ID”。
3. 从下拉菜单中选择一个组织和一个项目。
4. 选择“链接项目 ID”。

详细了解将项目链接到 Unity 云面板。

安装 UGS 包#

为您要在项目中实现的服务安装相应的包。要查看和安装适用于 UGS 的包

1. 在 Unity 编辑器中，选择“窗口”>“包管理器”。
2. 在包管理器中，选择“Unity 注册表”列表视图。
3. 搜索包名称，或在注册表列表中找到它。
4. 选择包，然后单击“安装”。

您也可以在搜索栏中键入“服务”，这将返回除远程配置之外的所有服务的结果。

在 2022.1 或更高版本的编辑器中，包管理器的“服务”选项卡显示所有可用于 UGS 的包。

导入 SDK 命名空间#

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

using Unity.Services.Analytics;

在您的游戏代码中初始化 Unity 服务#

您必须先初始化服务核心 SDK，然后才能调用任何服务的功能。建议的最佳实践是在游戏运行时尽早初始化服务，最好是在启动时。

要在您的游戏代码中初始化 Unity 服务，请创建一个导入服务核心命名空间 (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。您可以使用State方法在运行时检查您的游戏的初始化状态。有关更多信息，请参阅服务核心 API文档。

创建您的第一个云代码脚本以及更多内容#

自定义服务器权威经济逻辑或游戏逻辑是 Unity Gaming Services 最常见的用途之一。此云代码演练包括您入门所需的一切内容，包括安装、初始化、面板配置以及从您的游戏客户端远程执行简单的云代码脚本。

后续步骤#

• 有关如何使用 UGS 功能的灵感，请参阅 Unity 的用例示例项目。
• 实现个别服务。
• 使用UGS CLI或部署窗口来简化配置管理工作流程。