好友功能入门

注意：根据《数字服务法案》(DSA) 的要求，如果 Unity 采取的行动会对终端用户产生影响，则 Unity 必须通知客户的终端用户。为遵守此要求，如果您使用依赖 Unity 身份验证服务的 Unity 游戏服务 (UGS) 产品，则必须集成通知 API。

有关 DSA 的更多信息，请参阅数字服务法案 - 合规性更新。

要使您的游戏合规，请参阅DSA 通知。

本指南将引导您完成设置和开始使用好友功能的步骤。

先决条件

要开始使用好友功能，您需要执行以下操作

设置好友功能

您可以通过 Unity 云仪表板设置和管理好友功能

前往 cloud.unity.com。
从侧边栏中选择“产品”选项卡。
在“游戏服务”>“社区”下，前往“好友”并选择“启动”。

首次启动好友功能时，这会将好友功能添加到侧边栏上的“快捷方式”部分，并打开“概览”页面。

将您的项目与 Unity 云仪表板相关联

您必须将您的项目与 Unity 云仪表板相关联，才能使用好友服务。

在 Unity 编辑器中，选择“编辑”>“项目设置...”>“服务”。
关联您的项目。
1. 如果您的项目没有 Unity 项目 ID
  1. 选择“创建 Unity 项目 ID”>“组织”，然后选择一个组织。
  2. 选择“创建项目 ID”。
2. 如果您要使用现有的 Unity 项目 ID
3. 选择“使用现有的 Unity 项目 ID”。
4. 选择一个组织和一个项目。
5. 选择“关联项目 ID”。

您的 Unity 项目 ID 现在会显示在 Unity 编辑器中，并且该项目已关联到 Unity 的云服务。您还可以使用 UnityEditor.CloudProjectSettings.projectId 在代码中访问您的 Unity 项目 ID。

启用好友服务

您可以从 Unity 云仪表板为您的项目启用好友服务。

登录到 Unity 云仪表板。
选择您的项目。
导航到“产品”>“好友”。
您可以从“概览”页面或“设置指南”中启用好友功能。

设置指南将引导您关联 Unity 项目、安装好友包并启用好友服务。

安装好友包

将您的项目关联到 Unity 云仪表板后，您就可以安装最新版本的好友包。

使用 Unity 包管理器在 Unity 编辑器中导入好友包。

初始化好友服务

在您启用好友服务并通过 Unity 编辑器中的包管理器导入好友 SDK 后，请使用 await UnityServices.InitializeAsync() 初始化核心 SDK。

以下代码示例展示了如何初始化好友服务以及您项目中的任何其他 Unity 服务。

// Import required packages
using Unity.Services.Core;
using Unity.Services.Authentication;
...
private async Task MyMethod()
{
    // Initialize all of the used services
    await UnityServices.InitializeAsync();

    // Sign in anonymously or using a provider
    await AuthenticationService.Instance.SignInAnonymouslyAsync();

    // Initialize friends service
    await FriendsService.Instance.InitializeAsync();

    // Start using the Friends SDK functionalities.
    var friends = FriendsService.Instance.Friends;
}

好友功能入门#

先决条件#

设置好友功能#

将您的项目与 Unity 云仪表板相关联#

启用好友服务#

安装好友包#

初始化好友服务#