朋友示例
在继续之前，下载并安装 Unity Hub 和受支持的 Unity 编辑器版本。Friends 服务支持以下 Unity 编辑器版本
- 版本 2021 或更高版本
- 支持 UI 工具包和 Unity GUI
- 版本 2020.3 或更高版本
- 支持 Unity GUI
下载示例项目
从 GitHub 下载Friends 示例项目并在受支持的 Unity 编辑器版本中打开它。您需要在启用 Friends 服务时打开示例项目。
启用 Friends 服务
- 登录Unity 云控制台。如果您还没有帐户，请参考Unity 游戏服务 (UGS) 入门。
- 转到 **产品** > **朋友**。
- 选择 **启动**。
- 如果您还没有添加付款信息，Unity 云控制台可能会提示您添加付款信息。朋友是一个按需付费服务，并提供免费套餐。
- 继续进行设置指南，该指南将引导您完成设置 Friends 项目。
将您的 Friends 项目与 Unity 编辑器链接
Note: You can skip this step if you've already linked your project through the Unity Engine. You can also link your project after enabling the Friends service.
- 按照在 Unity 编辑器中链接您的项目中的说明进行操作。
- 在设置指南中选择 **下一步**。
安装 Friends 包
- 您可以使用 Unity 编辑器版本 **2021 或更高版本** 或版本 **2020.3 或更高版本**。在 Unity 云控制台的设置指南中选择您要使用的版本，然后按照说明操作。
- 完成后，在设置指南中选择 **下一步**。
打开 Friends
- 通过将设置指南中的按钮切换到 **开** 来激活 Friends。激活后，玩家可以向其他玩家发送好友请求并建立好友列表。
- 选择 **完成**。
Note: If you meet any conflicts with other services, deactivate the Friends service. You can turn Friends on or off at any time.
在编辑器中运行示例
使用以下说明在本地设置示例
- 启动 Unity Hub。
- 选择 **打开** > **从磁盘添加项目**。
- 选择本地磁盘上的示例项目位置，然后选择 **添加项目**。
- 示例项目将以正确的编辑器版本列在 Unity Hub 中。双击项目以打开它。您可能需要等待几分钟才能启动 Unity 项目。
将资产拖放到您的项目中
此示例作为您的项目的插件。它可以立即让您开始使用 Friends！
获取资产
将整个 Assets/FriendsSample/ 文件夹从示例项目拖放到您的项目中，或者将该文件夹导出为 .unitypackage。
解析依赖项
此项目依赖于两个非标准的 Unity 包依赖项
- Friends 服务 SDK
- 转到包管理器（**窗口** > **包管理器**）获取它。
- 点击窗口左上角的小 + 图标，然后选择 **从 Git URL 添加包** 或 **按名称添加包**。
- 输入：com.unity.services.friends
- TextMesh Pro 必需资源
- 转到 **窗口** > **Textmesh Pro** > **导入 TMP 必需资源** 获取它。
使用示例资产
对于 2020.3，该示例支持 Canvas 样式 UI，对于 2021.1+，该示例支持 UIToolkit 样式 UI。研究示例场景以查看层次结构和一般设置。您也可以将 **RelationshipsManager** 拖放到任何场景中，UI 将显示它并正常工作。
使用示例项目
此时，您已在 Unity 编辑器中打开了示例项目。现在该与示例进行交互了。
Note: If you haven’t already, log into the Unity Editor and link your Unity project before continuing.
示例项目包含一个简单的用户界面，允许您与 Friends 服务进行交互并执行以下操作，例如
使用下表作为按钮和用户界面元素含义的参考。
| 按钮名称 | 描述 |
| 拒绝 (×) | 拒绝好友请求 |
| 接受 (✔) | 接受好友请求 |
| 屏蔽 (-) | 屏蔽玩家 |
| 取消屏蔽 | 从您的屏蔽列表中删除玩家 |
| 删除 | 从您的好友列表中删除玩家 |
| 好友列表 | 您与之成为朋友的所有玩家的列表 |
| 屏蔽列表 | 您已屏蔽的所有玩家的列表 |
| 好友请求列表 | 传入好友请求的列表 |
启动项目
您必须启动示例场景才能与示例用户界面进行交互。
- 从 **项目** 选项卡中，选择 **资产** > **场景**。
- 双击 **FriendsSampleUGUI 场景或 FriendsSampleUIToolkit 场景**。
- 通过进入 Unity 编辑器中的 **播放模式** 来启动场景。
场景启动后，将显示示例 Friends 用户界面。
测试项目
要单独测试此项目，您必须打开 Unity 编辑器并打开项目的构建。
- 打开构建设置（**文件** > **构建设置**）。
- 选择构建到您选择的平台。（已在 Windows 和 macOS 上测试。）
- 确保其中一个示例场景是包含的顶部场景。
- 完成后，同时运行构建和编辑器。
发送好友请求
您可以使用玩家的 ID 和 **添加好友** 按钮向其他玩家发送好友请求。
- 复制项目的玩家 ID。
- 切换到项目的构建。
- 选择 **添加好友** 按钮。
- 将项目玩家的 ID 粘贴到 ID 字段中，然后选择 **添加**。
- 返回 Unity 编辑器。
- 选择 **好友请求列表** 按钮。
- **接受** 或 **忽略** 来自构建玩家的好友请求。
屏蔽玩家
如果玩家屏蔽了你，他们将对你显示为离线。如果你屏蔽了玩家，他们将出现在你的屏蔽列表中。
有两种方法可以屏蔽其他玩家：从您的好友列表或从您的好友请求收件箱。
从您的好友列表中屏蔽玩家
- 选择好友列表按钮。
- 选择您要屏蔽玩家姓名旁边的屏蔽（-）按钮。
屏蔽向您发送好友请求的玩家
- 选择好友请求列表按钮。
- 选择您要屏蔽玩家姓名旁边的屏蔽（-）按钮。
您可以在屏蔽列表中查看和解除屏蔽被屏蔽的玩家。
解除屏蔽玩家
您可以通过查看您的屏蔽列表，然后选择玩家姓名旁边的解除屏蔽按钮来解除屏蔽玩家。
删除好友
您可以通过在好友列表中选择玩家姓名旁边的删除好友按钮，从好友列表中删除好友。
- 选择好友列表按钮。
- 选择删除好友按钮。
设置您的状态
您可以通过选择当前状态旁边的向下箭头，然后选择新状态来设置您的状态。例如，要将您的状态从在线更改为忙碌
隐身是一个特殊状态，它使您对所有朋友都处于离线状态。
- 选择在线旁边的向下箭头。
- 选择忙碌。
设置您的活动状态
您可以通过选择状态下拉菜单右侧的文本设置您的活动状态。例如，您可以根据玩家当前正在玩的游戏中的活动设置自定义状态。
- 选择在好友菜单中文本。这是默认的活动状态
- 键入新消息，然后按回车键。按回车键后，您的好友列表中的用户可以看到更新的活动状态。
Note: The Friends service doesn't automatically save presence or activity when the user goes offline. To support persisting the same presence or activity when logging back on, save the presence or activity locally or via a data storage service like Cloud Save.
查看您的好友列表
您可以通过选择好友列表按钮查看您的好友列表。
查看您的请求列表
您可以通过选择请求列表按钮查看您的好友请求列表。
查看您的屏蔽列表
您可以通过选择屏蔽列表按钮查看您的屏蔽列表。
