文档

支持

Friends

Friends

欢迎使用 Friends（Beta 版）

Explore the Friends service for managing player relationships and connections.
阅读时间2 分钟最后更新于 1 个月前
借助 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
关系。