Skip to main content
好友列表是提升玩家社交能力的绝佳功能。它易于使用,并可以让排行榜对用户更具吸引力。

先决条件

SDK:Unity

  • PlayFabSharedSettings 对象中已设置游戏 ID。
  • 项目能够成功登录用户。
  • 游戏至少注册了两个用户。

关于好友

游戏中的任何玩家都可以与游戏中的任何其他玩家成为好友。值得注意的是,PlayFab 中的好友关系是单向的。 如果 AlbertBob 添加为好友,则 Bob 不需要任何批准流程。事实上,Bob 可能并不知情。 Bob 必须单独添加 Albert,好友关系才是相互的。如果您希望实施相互性规则,则由您的游戏负责通过自定义游戏服务器或 CloudScript 逻辑(如有必要)来强制执行这些条件。 如果玩家已关联其 Steam、Facebook 或 XBOX Live 账户,且这些好友也在玩您的游戏,则也可以显示这些平台特定的好友。

添加好友

示例代码使用函数 DisplayFriends()DisplayError(string error) 来代替您应用的 UI。您可以将它们粘贴到编辑器中,即可无需额外操作即可运行 — 或者用您自己的代码替换这些调用。
  1. 玩家登录后,即可访问好友的 UI。此功能通常至少包括添加、删除和显示好友。
  2. 若要获取玩家当前的好友列表,请使用 GetFriendsList API 调用。
GetFriendsList 的结果包含一个 friends 参数,它是一组 FriendInfo 对象的列表。
  1. 若要向玩家的好友列表中添加好友,请使用 AddFriend API 调用。
  1. 若要从玩家的好友列表中移除某位玩家,请使用 RemoveFriend API 调用。

更进一步

除了添加、删除和显示之外,您还可以对好友执行其他操作。

为好友添加标签

GetFriendsList 检索到的 FriendInfo 对象包含该好友的标签列表。更新此列表时,您需要从中添加和删除标签,并将其包含在 API 调用中(如下所示)。
您可以使用标签来告知匹配(例如,玩家不喜欢与被标记为 2tuff 的好友一起进行困难难度的游戏),实现好友分组 — 或者仅用它们来存储与关系相关的所需元数据。 需要重点注意的是,PlayFab 目前不会以任何方式为这些标签编制索引。GetFriendsList 无法基于标签进行过滤,因此该操作必须在本地完成。 考虑此系统可能带来的任何性能影响时,请牢记这一点。
最后修改于 2026年8月24日