1.9.5
2026 年 8 月 13 日Bug 修复
- GDK:修复了一个 Bug:较长的 PubSub 连接关闭过程可能阻塞后台工作线程,使其无法在独立的连接工作上继续推进。
- GDK:修复了活动的 HTTP 请求在 XBOX 上会阻止游戏挂起的 Bug。
- PlayStation® 平台:修复了大厅 PubSub 订阅生命周期中的内存泄漏。
1.9.3
2026 年 6 月 23 日Bug 修复
- 修复了一个问题:在网络中断期间离开的大厅成员在连接恢复后可能会错误地重新显示为已连接到大厅所有者。
- 修复了一个崩溃问题:如果游戏在大厅、匹配或通知操作期间清除当前进程任务队列,可能会发生崩溃。
- 修复了拆卸过程中的一个竞争条件:如果 HTTP 请求在 SDK 关闭时完成,可能会导致内存损坏或崩溃。
- 修复了清理过程中的一个死锁问题:该问题可能导致使用手动调度进程任务队列的游戏挂起。
- 修复了在没有活动的大厅或匹配订阅时重新连接可能发生的 PubSub 会话恢复失败问题。
- 修复了 SDK 未在 HTTP 请求上发送其 User-Agent 标头的问题。
- 公共的 PFLobby、PFMatchmaking 和 PFMultiplayer API 函数现在会验证指针参数,并在传入空指针时返回
E_POINTER,而不是可能崩溃。
1.9.2
2026 年 6 月 1 日Bug 修复
- 修复了库的 Nintendo Switch 和 Nintendo Switch 2 版本中，当 websocket 被网络意外断开时发生的崩溃。
1.9.0
2026 年 3 月 26 日新功能
- 添加了 PFLobbyGetRestrictInvitesToLobbyOwner,用于检索大厅当前的策略,该策略指示是否仅允许大厅所有者发送加入大厅的邀请。
- 向 PFLobbyArrangedJoinConfiguration、PFLobbyCreateConfiguration 和 PFLobbyDataUpdate 结构中添加了
restrictInvitesToLobbyOwner字段,用于控制是仅大厅所有者还是任何成员可以发送加入大厅的邀请。如果你对这些结构使用默认初始化器,则无需更改代码。如果你未使用默认初始化器,请务必初始化这些新字段。
Bug 修复
- 修复了一个问题:在连接丢失且 SDK 无法重新建立连接时,SDK 未自动生成已断开连接的状态变更。
1.8.8
2026 年 3 月 23 日Bug 修复
- 修复了 Linux 上对 DeriveWorkQueue 的未定义引用。
- 改进了 PlayFab Multiplayer 的 Linux 链接器加固。
1.8.7
2026 年 2 月 26 日Bug 修复
- 修复了当库在调试器中暂停时丢失 WebSocket 连接后可能崩溃的问题。
1.8.6
2026 年 2 月 13 日Bug 修复
- 修复了以下问题:在首次尝试大厅或匹配 24 小时后,如果未清理库,则可能无法创建后续大厅、加入后续大厅、订阅大厅邀请或创建后续匹配票据。
- 修复了以下问题:PlayFab Lobby 服务失败可能导致 PlayFabMultiplayer 库在调用 PFMultiplayerUninitialize() 并使用
PFMultiplayerInitialize重新初始化库之前无法创建新的大厅。 - 修复了非 GDK 平台上的以下问题:在通过 PFMultiplayerUninitialize() 清理库后,库仍保留了内部进程任务队列内存分配。
- 修复了以下问题:多个 PubSub 服务错误被合并成一个通用 HTTP 4XX 错误消息 0x89236409。现在,库会为不同的服务错误提供不同的错误代码,更便于诊断和排查问题。
1.8.5
2026 年 1 月 21 日Bug 修复
- 在 iOS 平台上隐藏了符号以防止符号冲突。此版本仅为 iOS 版本。
1.8.4
2025 年 11 月 5 日Bug 修复
- 修复了 Android 上暴露的 U 符号导致运行时崩溃的问题。除 Microsoft 提供的符号外,所有符号均已隐藏。此版本仅适用于 Android。
1.8.3
2025 年 10 月 10 日Bug 修复
- 修复了 Android 上暴露的
libHttpClient符号导致符号冲突的问题。添加了一个选项,允许需要特定版本libHttpClient的游戏提供自己的动态libHttpClient,并使用.dynLHC包以避免符号冲突。.dynLHC包取代了 1.8.2 版本中的.hideLHC包。此版本仅适用于 Android。
1.8.2
2025 年 9 月 5 日Bug 修复
- 修复了 Android 上暴露的
libHttpClient符号导致符号冲突的问题。添加了一个选项,允许需要特定版本libHttpClient的游戏提供自己的动态libHttpClient,并使用.hideLHC包以避免符号冲突。此版本仅适用于 Android。
新增支持
- 添加了对 16-KB 页面大小的支持,以满足新的 Android 页面大小要求。
1.8.1
2025 年 8 月 20 日Bug 修复
- Switch:修复了线程初始化期间发生的崩溃。
1.8.0
2025 年 6 月 11 日新功能
- 添加了新函数 PFMultiplayerConnectToLobby。
- 向 PFLobbyInviteReceivedStateChange 结构添加了
lobbyId字段,以支持仅使用大厅 ID 加入。
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 修复
- 修复了 Sony(PlayStation®4 和 PlayStation®5)SDK 版本上的一个问题:在网络重新连接后,第二个本地用户无法加入由第一个用户创建的大厅。
1.7.12
2025 年 4 月 15 日Bug 修复
- 修复了在创建并加入多用户大厅后发生意外断开连接、随后网络重新连接时发生的崩溃。
- 修复了对不存在的大厅调用 PFLobbyPostUpdate 不会自动生成断开连接状态变更的问题。
- 修复了 Android 上加载库时的崩溃以及
libc++_shared.so的暴露问题。 - 在 Android 的发布包中包含了
libHttpClient。有关使用详情,请参阅 PlayFab Multiplayer Android 入门。 - 修复了 Apple 平台上符号暴露的问题。
1.7.11
2025 年 4 月 9 日Bug 修复
- 修复了 Sony(PlayStation®4 和 PlayStation®5)SDK 版本上的崩溃:在创建并加入多用户大厅后发生意外断开、随后网络重新连接时发生崩溃。
1.7.10
2025 年 3 月 6 日Bug 修复
- 修复了以下问题:如果应用在本地用户断开连接的同时挂起,库可能会崩溃。此修复仅适用于 GDK 版本。
1.7.9
2025 年 2 月 11 日Bug 修复
- 修复了以下问题:当库收到 HTTP 401 时,错误地重试了一些与实时消息服务相关的操作。
- 修复了 1.7.8 版本中引入的一个回归问题,该问题将
PFMultiplayerServerDetails::region值赋给了PFMultiplayerServerDetails::fqdn。 - 修复了以下问题:与新成员关联的属性不会立即可用,直到后续的
Updated状态变更之后才可用。现在,只要将MemberAdded状态变更提供给游戏,PFLobbyGetMemberConnectionStatus()、PFLobbyGetMemberPropertyKeys() 和 PFLobbyGetMemberProperty() 就会提供与该成员相关的最新信息。为了保持依赖先前行为的游戏的兼容性,成员被添加后的第一个Updated状态变更仍会像它们是新属性一样提供此初始属性键列表。 - 修复了几个问题:当 PFMultiplayerUninitialize() 在清理内部 Web 请求资源时被调用,库可能会崩溃。
- 修复了 GDK XBOX 的一个问题:在挂起期间清理与邀请侦听器关联的内部状态时,库可能会崩溃。
- 修复了 Android 的一个问题:在 PFMultiplayerUninitialize() 清理 JavaVM 附加线程时,库可能会崩溃。
- 修复了 macOS 上库被错误地符号链接的问题,这可能在集成库时以构建中断的形式出现。
1.7.8
2024 年 11 月 5 日Bug 修复
- 修复了对使用 PFMultiplayerCreateServerBackfillTicket 创建的回填票据调用 PFMatchmakingTicketCancel 失败的问题。
- 修复了 SDK 将 PFMultiplayerServerDetails 中的所有值视为必需的问题。
- 修复了 Sony(PlayStation®4 和 PlayStation®5)SDK 版本未正确处理来自 Sony(PlayStation®4 和 PlayStation®5)HTTP 库间歇性 HTTP 请求失败的问题。此外,改进的错误报告现在为这些情况提供更详细的信息。
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 修复
- 修复了在 Unix 系统上与自定义内存钩子一起使用时 PFMultiplayerUninitialize 可能导致崩溃的潜在问题。
1.7.4
2024 年 6 月 17 日Bug 修复
- 修复了在 PlayStation®4 和 PlayStation®5 上,如果消息中包含
'\0'字符,SDK 未正确解析 WebSocket 接收的消息的问题。无法解析这些消息可能导致 PubSub 连接问题。此修复仅适用于 PlayStation®4 和 PlayStation®5。
1.7.3
2024 年 4 月 23 日Bug 修复
- 解决了在同一应用中同时使用 Party 和 Multiplayer 时的重复类错误。此修复仅适用于 Android。
1.7.2
2024 年 3 月 7 日Bug 修复
- 修复了内部 PubSub 通知 WebSocket 在检测和响应断开连接时较慢的问题。此问题可能导致在创建或加入大厅和匹配票据时发生错误。
- 修复了 PubSub 未能与 SignalR 服务建立连接时,不会触发失败状态变更并且不允许后续 Multiplayer API 调用订阅 PubSub 的问题。
- 改进了内部诊断。
1.7.1
2024 年 2 月 14 日新功能
- 添加了新的 API,使 PlayFab GameServer 实体能够加入客户端所拥有的大厅并与之交互:
1.6.5
2023 年 11 月 15 日新功能
- 添加了新的 PFMatchmakingTicketGetCustomContext 和 PFMatchmakingTicketSetCustomContext API,用于将自定义上下文与匹配票据关联。
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 Multiplayer 会清理与之关联的所有资源并重新初始化。
1.6.0
2023 年 6 月 14 日新功能
- 向 PFLobbySearchResult 结构添加了
membershipLock字段,以便你可以读取 PFMultiplayerFindLobbies() 提供的搜索结果中所返回大厅的锁定状态。
1.5.3
2023 年 4 月 25 日Bug 修复
- 修复了 iOS 和 macOS 上特有的链接器错误,该错误表现为运行时找不到 HttpClient.framework。
1.5.2
2023 年 4 月 4 日Bug 修复
- 引入了
PFMultiplayerPal.h头文件,为非 MSVC 编译器提供支持。此头文件为非 MSVC 编译的平台定义了 SAL 和 HRESULT。
1.5.1
2023 年 3 月 20 日新功能
- PlayFab Multiplayer v1.5.1 增加了对 Linux 和 Windows Subsystem for Linux (WSL) 的支持。
1.5.0
2023 年 3 月 16 日新功能
- 添加了新的 API 及对服务器所拥有大厅的支持:
- 通过 PFMultiplayerCreateServerBackfillTicket 添加了对创建匹配服务器回填票据的新支持。
- 添加了新的 PFLobbyMembershipLockSearchKey 常量,以便在调用
PFMultiplayerFindLobbies()时更容易地仅搜索已锁定或已解锁的大厅。
Bug 修复
- 添加了一个修复,减少因后台线程争用而导致的意外 PubSub 断开连接。
1.4.3
2022 年 11 月 15 日新功能
- PlayFab Multiplayer v1.4.3 增加了对 iOS 和 macOS 的支持。
1.4.2
2022 年 10 月 26 日Bug 修复
- 修复了 PubSub 重新连接可能导致后续 PubSub 取消订阅请求失败的 Bug。
1.4.1
2022 年 10 月 25 日Bug 修复
- 修复了库生成不必要的短生命周期线程的 Bug。
- 在 Windows、XBOX 和 Android 上,修复了库可能在先前记录的 retry-after 期限到期前就尝试 Web 请求的 Bug。
- 改进了无法访问 Web 服务器时的错误消息。
1.4.0
2022 年 10 月 11 日新功能
- PlayFab Multiplayer 1.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 修复
- 改进了 PFMultiplayerGetErrorCode 针对若干与速率限制相关错误报告的消息。
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()可能无限期阻塞的 Bug。 - 修复了在意外的 WebSocket 断开连接后,PubSub 通知不可用以及 Lobby/Matchmaking API 操作无限期停滞的 Bug。
1.1.4
2022 年 6 月 24 日Bug 修复
- GDK:修复了如果在挂起或恢复后过早启动涉及网络通信的操作,操作会静默失败的 Bug。
- 修复了在调试器中中断执行超过 10 秒后恢复执行时 SDK 崩溃的 Bug。
1.1.3
2022 年 6 月 10 日新功能
- SDK 现在对意外断开连接的响应更加迅速(检测速度比以前快 2-3 倍)。
- 意外的大厅断开连接现在会导致自动尝试重新连接。客户端仅在这些重新连接尝试失败后才会得知断开连接。
- GDK/Win32:Web 服务失败响应(429、503 等类似响应)现在会触发自动重试。客户端仅在这些重试失败后才会得知失败。
Bug 修复
- 修复了在连续 10 次匹配后匹配失败的 Bug。
- 修复了
GetErrorMessage(...)未提供与匹配相关错误消息的 Bug。 - 修复了
LobbySearchResult结构中两个字段(maxMemberCount和currentMemberCount)未正确填充的 Bug。 - 修复了在挂起和恢复后与行为和可靠性有关的各种 Bug。
1.1.1
2022 年 4 月 13 日Bug 修复
- Switch:提供了一个新的 PAL 头文件,该文件是根据 PlayFab Multiplayer 构建所必需的。
1.1.0
2022 年 3 月 4 日API 变更
- 更改了
PFMultiplayerGetErrorMessage的 API 签名。以前,此函数返回HRESULT,并使用输出参数返回错误消息字符串。现在,该函数直接返回字符串。
新功能
- GDK:添加了对 XBOX 上自动处理挂起和恢复的支持。
Bug 修复
- 修复了如果玩家重新加入大厅,API 会忽略传递给
PFMultiplayerJoinLobby的初始成员数据的 Bug。
1.0.0
2021 年 11 月 23 日 PlayFab Multiplayer 现已提供预览版。有关 Matchmaking 和 Lobby 功能的概述,请查看:- PlayFab Lobby 概览
- PlayFab Multiplayer Lobby 快速入门
- PlayFab Matchmaking 概览
- PlayFab Multiplayer Matchmaking 快速入门