欢迎使用 Friends（Beta 版）#

借助 Friends 服务，您可以为玩家提供一个与其他 Unity 服务配合良好的社交系统，从而提高玩家参与度。通过 Friends 服务，您的玩家可以：

• 发送和接收好友请求。
• 构建和管理好友列表。
• 屏蔽和取消屏蔽其他玩家。
• 向好友发送消息。

环境是指 Unity Game Services（Unity 游戏服务）的逻辑分区，其中包含与项目关联的数据。您可以在 Friends 后台和您的初始化脚本中设置目标环境。请参阅 Unity Environments。

Friends API 使用 JSON Web Token (JWT) 身份验证。Authentication SDK 支持匿名身份验证和特定平台身份验证.

了解 Friends#

Friends 服务负责管理各种不同类型的关系。一般来说，大多数用户关系不会经常改变，但用户通常希望尽快了解某些更新。为了提高效率，Friends SDK 会在启动时一次性获取用户的所有关系，然后使用推送通知使该列表保持最新状态。

该 SDK 会在更改发生后立即发送变更通知。会触发推送通知的用户关系变化包括：

• 好友更新其当前状态。
• 个别用户的当前状态发生更新。
• 用户添加新的关系。用户创建 FRIEND_REQUEST 关系。
• 用户移除关系，或 FRIEND 关系被以其他方式删除。

Friends 服务会以同样的方式处理所有关系。您可以使用每种关系的不同属性来决定如何处理相应关系。每个关系都有一个或多个成员（玩家），每个成员可能具有额外的属性，用于标识该成员在关系中的角色。例如，FRIEND_REQUEST 关系始终具有两个成员。

1. 一个具有 SOURCE 角色的成员（请求发起人）。
2. 一个具有 TARGET 角色的成员（请求接收人）。

但是，当 FRIEND_REQUEST 关系变为 FRIEND 关系时，成员的角色会更改为 NONE。

该 SDK 提供针对特定操作的包装器 API，以提高服务的可用性。

例如，当您调用 SendFriendRequestAsync 方法时，它会调用 CreateRelationship API，并与目标用户创建一个新的 FRIEND_REQUEST 关系。

如果已经存在来自目标用户的 FRIEND_REQUEST 关系，则它会创建新的 FRIEND 关系。根据状态不同，SendFriendRequestAsync 可能会创建 FRIEND_REQUEST 关系或新的 FRIEND 关系。