开始使用 Relay

阅读以下各部分,了解如何设置 Relay 项目以及如何使用 Relay 示例项目。如果不了解如何与 Unity Dashboard(Unity 后台)配合使用,请访问开始使用 UGS

注意:通过 Relay 服务器进行的绑定及其他交互是利用 UTPNGO 等网络解决方案来实现的,其中 NGO 是上层解决方案,而 UTP 是底层解决方案。

设置 Relay 项目

Relay 是一项带免费套餐的 PAYG(按量付费)服务。如果超出免费套餐月度使用限制,则必须输入支付信息,以便能够保持对 Relay 和任何其他服务的全面访问。如需了解更多信息,请参阅注册 UGS

注意:在继续进行操作之前,请确保您已具有 Unity Dashboard(Unity 后台)帐户。如需了解更多信息,请参阅 UGS 概述文档

  1. 创建 Unity Dashboard(Unity 后台)项目

  2. 启用 Relay 服务。

    1. 从 Unity Dashboard(Unity 后台)中,选择 Multiplayer(多人游戏) > Relay
    2. 选择 Set up Relay(设置 Relay)
    3. 继续转到 Unity Dashboard(Unity 后台)中嵌入的 Relay Setup guide(设置指南)
  3. 在 Unity 编辑器中链接 Relay 项目。

    1. 在 Unity 引擎中打开项目,并导航到 Edit(编辑)> Project Settings(项目设置)
    2. 从 **Project Settings(项目设置)**窗口中,转到 Services(服务) 选项卡。
    3. 选择 Use an existing Unity project ID(使用现有 Unity Project ID),然后链接到 **Setup guide(设置指南)**中显示的 Dashboard(Unity 后台)项目。
    4. 成功链接项目后,即可继续执行集成过程的下一步。
  4. 安装 Relay 包。

    1. 在 Unity 中,导航到 Window(窗口)> Package Manager(包管理器)
    2. 从 Package Manager(包管理器)中,搜索或滚动以在“Unity Registry(Unity 注册表)”中查找“Relay”包。
    3. 选择该包,然后单击“Install(安装)”按钮。
  5. 请查看 Simple Relay Sample,了解如何与该示例项目进行交互。

Simple Relay Sample

Simple Relay Sample 是测试 Relay SDK 的示例项目。提供简单的用户界面 (UI) 和按钮,用于对 SDK 进行手动测试。要试用该示例项目,请执行以下步骤。

注意:该 Simple Relay Sample 仅展示独立 Relay SDK 的作用,不包含绑定到服务器的情况。该独立 Relay SDK 通过对 Relay 后端服务进行 HTTP API 调用来创建分配和加入代码,不会影响客户端的网络连接。

导入 Simple Relay Sample 项目

  1. 使用 Unity 编辑器(版本 2020.3)打开 Relay 项目。如果您尚未设置 Relay 项目,请参阅设置 Relay 项目

  2. 打开 Package Manager(包管理器),然后导航到 Relay 包。

  3. 展开 **Samples(示例)**部分。

  4. 选择 Import(导入),导入 Simple Relay Sample 项目。

  5. 导入 Simple Relay Sample 项目后,即可将其作为场景打开。它位于 Assets/Samples/Relay/1.0.1-pre.3/Simple Relay Sample 下的当前项目中。

  6. 选择 File(文件)> Open Scene(打开场景)

  7. 导航到 Simple Relay Sample 场景。

请继续参阅使用 Simple Relay Sample,了解如何使用。

使用 Simple Relay Sample

  1. 登录 Unity 编辑器。

  2. 转到 Account(帐户)> Sign in…(登录...)

  3. 选择 **Sign in(登录)**按钮,在浏览器窗口中打开 Unity Dashboard(Unity 后台)。请确保登录到已启用 Relay 的项目所在的帐户。

  4. 将项目链接到 Simple Relay Sample。

  5. 选择 Edit(编辑)> Project Settings…(项目设置...)

  6. 选择 Use an existing Unity project ID(使用现有 Unity Project ID)

  7. 选择组织和项目。

  8. 选择 Link project ID(链接项目 ID)

  9. 链接成功后,项目 ID 会显示在“Unity Project ID”下。

启动 Simple Relay Sample

  1. 选择 **Play(播放)**按钮来启动该示例。

  2. 依次选择示例中以下按钮:

    1. “Sign In (Anonymously)(登录(匿名))”:使用 Unity 的匿名身份验证登录到 Relay。此操作将生成玩家 ID。
    2. “Get Regions(获取地区)”:列出具有可用 Relay 服务器的所有地区
    3. “Create Relay(创建 Relay)”:创建 Relay 分配并返回主机分配 ID。
    4. “Get Join Code(获取加入代码)”:为主机生成与其他玩家共享的加入代码
    5. “Join Relay(加入 Relay)”:加入 Relay 分配并返回玩家分配 ID。