通过

PlayFab 多人游戏 C++ SDK 发行说明

1.8.0

2025 年 6 月 11 日

新功能

Bug 修复

  • 修复了 PubSub 连接失败可能导致库崩溃的 bug。

1.7.16

2025 年 5 月 7 日

Bug 修复

  • 修复了在 Android 平台上公开的符号导致符号冲突的问题。 这是仅限 Android 的版本。

1.7.15

2025 年 5 月 2 日

Bug 修复

  • 修复了 iOS 和 macOS 的 Info.plist 文件缺少必填字段的问题，从而确保符合 Apple 的要求。

1.7.14

2025 年 4 月 28 日

Bug 修复

  • 修复了以下问题：第二个本地用户在重新连接网络后无法加入由第一个用户创建的大厅。

线程处理更改

  • SDK 正在将其自定义网络线程替换为线程池实现，这将提高 CPU 利用率。

1.7.13

2025 年 4 月 22 日

Bug 修复

  • 修复了索尼 (PlayStation®4 和 PlayStation®5) SDK 版本上的问题，即第二个本地用户在重新连接网络后无法加入由第一个用户创建的大厅。

“PlayStation”是索尼互动娱乐公司的注册商标或商标。

1.7.12

2025 年 4 月 15 日

Bug 修复

  • 修复了在创建和加入多用户大厅后意外断开连接后发生网络重新连接时发生的崩溃。
  • 修复了调用 PFLobbyPostUpdate 的问题。 在不存在的大厅中，不会自动生成断开连接的状态更改。
  • 修复了在 Android 上加载库时崩溃和公开 libc++_shared.so 的问题
  • 包含在 libHttpClient Android 上的发布包中。 有关使用情况的详细信息，请参阅 PlayFab 多人游戏 Android 入门。
  • 修复了 Apple 平台上的符号公开问题。

1.7.11

2025 年 4 月 9 日

Bug 修复

  • 修复了索尼 (PlayStation®4 和 PlayStation®5) SDK 版本在创建和加入多用户大厅后意外断开连接后发生网络重新连接时发生的崩溃。

“PlayStation”是索尼互动娱乐公司的注册商标或商标。

1.7.10

2025 年 3 月 6 日

Bug 修复

  • 修复了以下问题：如果应用在本地用户断开连接的同时挂起，库可能会崩溃。 这是仅限 GDK 的版本。

1.7.9

2025 年 2 月 11 日

Bug 修复

  • 修复了在收到 HTTP 401 时库会错误地重试与实时通知服务关联的某些作的问题。
  • 修复了 v1.7.8 中引入的 PFMultiplayerServerDetails::region 向 赋值的 PFMultiplayerServerDetails::fqdn回归。
  • 修复了以下问题：在提供后续 Updated 状态更改之前，与新成员关联的属性不会立即可用。 现在，一旦 MemberAdded 向游戏提供状态更改， PFLobbyGetMemberConnectionStatus () 、 PFLobbyGetMemberPropertyKeys () 和 PFLobbyGetMemberProperty () 提供与成员关联的最新信息。 为了保持依赖于以前行为的游戏的兼容性，添加成员后的第一个 Updated 状态更改将继续提供此初始属性键列表，就像它们是新属性一样。
  • 修复了在清理内部 Web 请求资源时调用 PFMultiplayerUninitialize () 时库崩溃的几个问题。
  • 修复了 GDK Xbox 的问题：在清理与邀请侦听器关联的内部状态时，库可能会在挂起期间崩溃。
  • 修复了 Android 的一个问题：在清理 JavaVM 附加线程时调用 PFMultiplayerUninitialize () 时，库可能会崩溃。
  • 修复了 macOS 的一个问题，即库未正确符号链接，在集成库时，该链接可能显示为生成中断。

1.7.8

2024 年 11 月 5 日

Bug 修复

  • 修复了调用 PFMatchmakingTicketCancel 以获取使用 PFMultiplayerCreateServerBackfillTicket 创建的回填票证失败的问题。
  • 修复了 SDK 将 PFMultiplayerServerDetails 中的所有值视为必需值的问题。
  • 修复了以下问题：索尼 (PlayStation®4 和 PlayStation®5) SDK 版本未正确处理来自索尼 (PlayStation 4 和 PlayStation®®5) HTTP 库的间歇性 HTTP 请求失败。 此外，改进了错误报告，以在此类情况下提供更详细的信息。

“PlayStation”是索尼互动娱乐公司的注册商标或商标。

1.7.7

2024 年 10 月 25 日

Bug 修复

  • 修复了 macOS 平台上公开的 OpenSSL 符号的问题。 这是仅限 macOS 的版本。

1.7.6

2024 年 8 月 12 日

Bug 修复

  • 修复了 GDK Xbox 的问题：某些事件在暂停并恢复游戏后不会排队。
  • 修复了暂停并恢复游戏后 GDK Xbox 的崩溃。
  • 更新了 PFMultiplayerCreateServerBackfillTicket ，以自动处理匹配成员已是过多票证成员的故障。 在这种情况下，SDK 会自动取消回填票证成员的现有票证并重试票证创建。

1.7.5

2024 年 7 月 17 日

Bug 修复

  • 修复了 PFMultiplayerUninitialize 在 Unix 系统上用于自定义内存挂钩时导致崩溃的潜在问题。

1.7.4

2024 年 6 月 17 日

Bug 修复

  • 修复了在 PlayStation 4 和 PlayStation®®5 上由 WebSocket 接收的消息在包含 '\0' 字符时，SDK 无法正确分析消息的问题。 无法分析这些消息可能会导致 PubSub 连接问题。 这是仅 PlayStation®4 和 PlayStation®5 版本。

“PlayStation”是索尼互动娱乐公司的注册商标或商标。

1.7.3

2024 年 4 月 23 日

Bug 修复

  • 解决了在同一应用中使用 Party 和 Multiplayer 时出现的重复类错误。 这是仅限 Android 的版本。

1.7.2

2024 年 3 月 7 日

Bug 修复

  • 修复了内部 PubSub 通知 WebSocket 检测和响应断开连接速度缓慢的问题，这可能导致创建或加入大厅和匹配票证时出错。
  • 修复了以下问题：PubSub 未能与 SignalR 服务建立连接不会触发失败状态更改，并且不允许后续多人游戏 API 调用订阅 PubSub。
  • 改进了内部诊断体验。

1.7.1

2024 年 2 月 14 日

新功能

1.6.5

2023 年 11 月 15 日

新功能

Bug 修复

  • 改进了内部诊断体验。

1.6.4

2023 年 8 月 16 日

Bug 修复

  • 修复了未对 GDK DLL 进行编码的 bug。 这是仅限 GDK 的版本。

1.6.3

2023 年 8 月 14 日

Bug 修复

  • 修复了处理更改通知时库可能会崩溃的问题。
  • 添加了新 PFLobbyMemberCountRemainingSearchKey 常量，以便更轻松地根据剩余成员计数进行搜索大厅并对其排序。

1.6.2

2023 年 7 月 14 日

Bug 修复

  • 修复了 PFMultiplayerJoinMatchmakingTicketFromId 启动的匹配操作过早超时的问题。
  • 修复了以下问题：如果在开始匹配操作后不久调用 PFMatchmakingTicketGetTicketId，则可能会提供 null 值。 现在，将按预期提供空字符串。
  • 修复了 macOS 库通过 Web 请求标头标识为 iOS 的问题。 此标识主要用于诊断。
  • 改进了内部诊断体验。

1.6.1

2023 年 6 月 14 日

  • 在 PlayStation®4 和 PlayStation®5 上，如果游戏进入桌面模式且保持超过 10 分钟，PlayFab 多人游戏会清理与之关联的所有资源并重新初始化。

“PlayStation”是索尼互动娱乐公司的注册商标或商标。

1.6.0

2023 年 6 月 14 日

新功能

1.5.3

2023 年 4 月 25 日

Bug 修复

  • 修复了特定于 iOS 和 macOS 的链接器错误，其中在运行时找不到 HttpClient.framework。

1.5.2

2023 年 4 月 1 日

Bug 修复

  • 介绍 PFMultiplayerPal.h 标头，它为非 MSVC 编译器提供支持。 此标头为非 MSVC 编译平台定义 SAL 和 HRESULT。

1.5.1

2023 年 3 月 20 日

新增功能

  • PlayFab 多人游戏 v1.5.1 支持 Linux 和 适用于 Linux 的 Windows 子系统 （WSL）。

1.5.0

2023 年 3 月 16 日

新功能

有关使用服务器拥有的大厅的详细信息，请参阅 游戏服务器和大厅。

Bug 修复

  • 缓解措施，以减少由于后台线程争用而导致的意外 PubSub 断开连接

1.4.3

2022 年 11 月 15 日

新增功能

  • PlayFab 多人游戏 v1.4.3 支持 iOS 和 macOS。

1.4.2

2022 年 10 月 26 日

Bug 修复

  • 修复了 PubSub 重新连接可能导致将来的 PubSub 取消订阅请求失败的问题。

1.4.1

2022 年 10 月 25 日

Bug 修复

  • 修复了不必要、生存期较短的线程会生成的 bug。
  • 在 Windows、Xbox 和 Android 上，修复了库可能会在之前记录的重试期限到期之前尝试 Web 请求的 bug。
  • 如果无法访问 Web 服务器，请改进错误消息。

1.4.0

2022 年 10 月 11 日

新增功能

  • PlayFab 多人游戏 v1.4.0 支持 Android。

1.3.1

2022 年 9 月 20 日

Bug 修复

  • 修复了在调用 PFMultiplayerUninitialize 或库内部处理 Xbox 主机上的应用挂起时导致 Websocket 资源泄漏内存的 bug。

1.3.0

2022 年 9 月 9 日

新增功能

  • 实现了一个新函数 PFLobbyGetMemberConnectionStatus，该函数可用于检测用户是否已连接到 PubSub 通知服务。 当用户的连接状态更改时，你会收到PFLobbyUpdatedStateChange，PFLobbyMemberUpdateSummary，其中connectionStatusUpdated字段是true。
  • 更新了用于将邮件与 PubSub 通知服务从 JSON 交换到 MessagePack 的协议，从而减小了消息大小。 此更改不会影响 API 图面。

Bug 修复

1.2.0

2022 年 8 月 17 日

新增功能

  • 如果匹配队列配置为分配多人游戏服务器，则匹配详细信息现在会报告与找到匹配时分配的多人游戏服务器关联的服务器详细信息。 有关详细信息，请参阅 PFMatchmakingMatchDetails。
  • 为 lobby/amOwner搜索键定义了新的常量 PFLobbyAmOwnerSearchKey 。 有关使用搜索键的详细信息，请参阅 PFLobbySearchConfiguration。

Bug 修复

  • 改进了由 PFMultiplayerGetErrorCode 报告的多个错误代码的消息。
  • 修复了在某些故障条件下未从通知服务取消订阅实体的 bug。

1.1.5

2022 年 7 月 13 日

Bug 修复

  • 修复了 PFLobby.h 标头中 PFLobbyMemberCountSearchKey 和 PFLobbyAmMemberSearchKey 的常量字符串值不正确
  • 修复了 Websocket 意外关闭时可能导致PFMultiplayerUninitialize()无限期阻止的错误
  • 修复了导致 PubSub 通知不可用和大厅/匹配 API 操作在意外的 Websocket 断开连接后无限期停止的错误

1.1.4

2022 年 6 月 24 日

Bug 修复

  • GDK：修复了以下 bug：如果在挂起/恢复后执行得太快，涉及网络通信的操作将以无提示方式失败。
  • 修复了 SDK 在中断调试器 10 秒以上后恢复执行时崩溃的 bug。

1.1.3

2022 年 6 月 10 日

新增功能

  • SDK 现在对意外断开连接的响应速度更高（检测到比之前快 2-3 倍）。
  • 意外的大厅断开连接现在会导致自动重新连接尝试 - 只有在这些重新连接尝试失败后，才会将断开连接传递给客户端。
  • GDK/Win32：Web 服务故障响应（429s、503s 等）现在将导致自动重试 - 只有在这些重试失败后，才会向客户端传达故障。

Bug 修复

  • 修复了连续 10 个匹配后匹配失败的问题。
  • 修复了 GetErrorMessage（...） 功能未提供与匹配相关的错误消息的 bug。
  • 修复了以下 bug：未正确填充 LobbySearchResult 结构中的两个字段（maxMemberCount 和 currentMemberCount）。
  • 修复了挂起/恢复后与行为/可靠性相关的各种 bug。

1.1.1

2022 年 4 月 13 日

Bug 修复

  • Switch：提供针对 PlayFab 多人游戏生成所需的新 PAL 标头。

1.1.0

2022 年 3 月 4 日

API 更改

  • PFMultiplayerGetErrorMessage 的 API 签名已更改。 以前，此函数返回并 HRESULT 使用输出参数返回错误消息字符串。 现在，函数直接返回字符串。

新增功能

  • GDK：添加了对在 Xbox 上自动处理挂起和恢复的支持。

Bug 修复

  • 修复了以下 bug：如果玩家重新加入大厅，则将忽略传递给 PFMultiplayerJoinLobby 的初始成员数据。

1.0.0

2021 年 11 月 23 日

PlayFab 多人游戏现提供个人预览版。 有关匹配和大厅功能的概述，请查看：