1.9.5
2026 年 8 月 13 日錯誤修正
- GDK:修正一個錯誤:PubSub 連線關閉時間過長可能會封鎖背景工作者執行緒,使其無法就各自獨立的連線工作繼續推進。
- GDK:修正一個錯誤:作用中的 HTTP 要求會封鎖標題在 XBOX 上暫停。
- PlayStation® 平台:修正大廳 PubSub 訂閱生命週期期間的記憶體洩漏。
1.9.3
2026 年 6 月 23 日錯誤修正
- 修正一個問題:在網路中斷期間離開的大廳成員,在連線恢復後可能會不正確地在大廳擁有者處重新顯示為已連線。
- 修正一個當標題清除目前處理程序工作佇列時,大廳、配對或通知作業期間可能發生的當機。
- 修正拆解期間的競爭情況:若 HTTP 要求在 SDK 關閉時完成,可能導致記憶體損毀或當機。
- 修正清除期間的死結:使用手動分派處理程序工作佇列的標題可能因此掛起。
- 修正在沒有作用中大廳或配對訂閱時重新連線可能發生的 PubSub 工作階段復原失敗。
- 修正一個問題:SDK 在 HTTP 要求上未傳送 User-Agent 標頭。
- 公開的 PFLobby、PFMatchmaking 以及 PFMultiplayer API 函式現在會驗證指標參數,並在傳入空指標時傳回
E_POINTER,而不會發生潛在當機。
1.9.2
2026 年 6 月 1 日錯誤修正
- 修正了函式庫的 Nintendo Switch 及 Nintendo Switch 2 版本中，當 websocket 被網路意外中斷連線時發生的當機問題。
1.9.0
2026 年 3 月 26 日新功能
- 新增 PFLobbyGetRestrictInvitesToLobbyOwner,用於擷取大廳目前的政策,指出是否僅有大廳擁有者可傳送邀請以加入大廳。
- 於 PFLobbyArrangedJoinConfiguration、PFLobbyCreateConfiguration 與 PFLobbyDataUpdate 結構中新增
restrictInvitesToLobbyOwner欄位,以控制是否僅由大廳擁有者或任何成員都可傳送加入大廳的邀請。如果您使用這些結構的預設初始設定式,則不需要變更程式碼。如果您沒有使用預設初始設定式,請務必初始化新欄位。
錯誤修正
- 修正一個問題:在連線中斷且 SDK 無法重新建立連線之後,SDK 未自動產生已中斷連線的狀態變更。
1.8.8
2026 年 3 月 23 日錯誤修正
- 修正 Linux 上對 DeriveWorkQueue 未定義參考的問題。
- 為 PlayFab Multiplayer 改善 Linux 連結器強化。
1.8.7
2026 年 2 月 26 日錯誤修正
- 修正一個問題:在偵錯工具中暫停時遺失 WebSocket 連線之後,程式庫可能會當機。
1.8.6
2026 年 2 月 13 日錯誤修正
- 修正一個問題:在首次嘗試大廳或配對後 24 小時,如果程式庫未清除,則可能無法建立後續大廳、加入後續大廳、訂閱大廳邀請或建立後續配對票證。
- 修正一個問題:PlayFab Lobby 服務失敗可能導致 PlayFabMultiplayer 程式庫無法建立新大廳,直到呼叫 PFMultiplayerUninitialize() 並以
PFMultiplayerInitialize重新初始化程式庫為止。 - 修正在非 GDK 平台上的一個問題:透過 PFMultiplayerUninitialize() 清除程式庫後,程式庫仍保有已配置的內部處理程序工作佇列記憶體。
- 修正一個問題:數個 PubSub 服務錯誤被彙整為單一泛用的 HTTP 4XX 錯誤訊息 0x89236409。現在,程式庫會為不同的服務錯誤提供不同的錯誤碼,方便診斷與排除。
1.8.5
2026 年 1 月 21 日錯誤修正
- 在 iOS 平台上隱藏符號以避免符號衝突。此版本僅為 iOS 版本。
1.8.4
2025 年 11 月 5 日錯誤修正
- 修正一個問題:曝露的 U 符號會在 Android 上造成執行階段當機。除了 Microsoft 提供的符號之外,其餘皆已隱藏。此版本僅為 Android 版本。
1.8.3
2025 年 10 月 10 日錯誤修正
- 修正一個問題:曝露的
libHttpClient符號會在 Android 上造成符號衝突。新增一個選項,讓需要特定版本libHttpClient的遊戲可提供自己的動態libHttpClient,並使用.dynLHC套件以避免符號衝突。.dynLHC套件取代版本 1.8.2 中的.hideLHC套件。此版本僅為 Android 版本。
1.8.2
2025 年 9 月 5 日錯誤修正
- 修正一個問題:曝露的
libHttpClient符號會在 Android 上造成符號衝突。新增一個選項,讓需要特定版本libHttpClient的遊戲可提供自己的動態libHttpClient,並使用.hideLHC套件以避免符號衝突。此版本僅為 Android 版本。
新支援
- 新增對 16-KB 頁面大小的支援,以滿足新的 Android 頁面大小需求。
1.8.1
2025 年 8 月 20 日錯誤修正
- Switch:修正執行緒初始化期間發生的當機。
1.8.0
2025 年 6 月 11 日新功能
- 新增全新的 PFMultiplayerConnectToLobby 函式。
- 於 PFLobbyInviteReceivedStateChange 結構中新增
lobbyId欄位,以支援僅使用大廳 ID 加入。
錯誤修正
- 修正 PubSub 連線失敗可能導致程式庫當機的錯誤。
1.7.16
2025 年 5 月 7 日錯誤修正
- 修正一個問題:曝露的符號在 Android 平台上造成符號衝突。此版本僅支援 Android。
1.7.15
2025 年 5 月 2 日錯誤修正
- 修正一個問題:iOS 與 macOS 的 Info.plist 檔案缺少必要欄位,現已確保符合 Apple 的規範。
1.7.14
2025 年 4 月 28 日錯誤修正
- 修正一個問題:第二位本機使用者在網路重新連線後,無法加入第一位使用者建立的大廳。
執行緒變更
- SDK 將其自訂的網路執行緒改為執行緒集區實作,以提升 CPU 使用效率。
1.7.13
2025 年 4 月 22 日錯誤修正
- 修正 Sony(PlayStation®4 與 PlayStation®5)SDK 版本的問題:第二位本機使用者在網路重新連線後,無法加入第一位使用者建立的大廳。
1.7.12
2025 年 4 月 15 日錯誤修正
- 修正一個當機:建立並加入多使用者大廳後發生非預期斷線,並在其後發生網路重新連線時所出現的當機。
- 修正一個問題:對不存在的大廳呼叫 PFLobbyPostUpdate 時,未自動產生已中斷連線的狀態變更。
- 修正在 Android 上載入程式庫時發生的當機以及
libc++_shared.so的曝露。 - 於 Android 的發行套件中包含
libHttpClient。使用細節請見 PlayFab Multiplayer Android 入門。 - 修正 Apple 平台上的符號曝露問題。
1.7.11
2025 年 4 月 9 日錯誤修正
- 修正 Sony(PlayStation®4 與 PlayStation®5)SDK 版本的當機:在建立並加入多使用者大廳後發生非預期斷線,其後發生網路重新連線時。
1.7.10
2025 年 3 月 6 日錯誤修正
- 修正一個問題:程式庫在應用程式暫停且本機使用者正在中斷連線的同時可能會當機。此修正僅適用於 GDK 版本。
1.7.9
2025 年 2 月 11 日錯誤修正
- 修正一個問題:當程式庫在即時訊息服務接收到 HTTP 401 時,錯誤地重試部分作業。
- 修正版本 1.7.8 中引入的回歸問題:將
PFMultiplayerServerDetails::region值指派至PFMultiplayerServerDetails::fqdn。 - 修正一個問題:新成員相關的屬性在後續的
Updated狀態變更之前無法立即取得。現在,一旦向遊戲提供MemberAdded狀態變更,PFLobbyGetMemberConnectionStatus()、PFLobbyGetMemberPropertyKeys() 與 PFLobbyGetMemberProperty() 便會提供該成員最新的相關資訊。為保留對相依於先前行為的遊戲之相容性,成員加入後的第一個Updated狀態變更仍會提供這份最初的屬性索引鍵清單,就像它們是新屬性一樣。 - 修正數個問題:當 PFMultiplayerUninitialize() 於清除內部 Web 要求資源時被呼叫,程式庫可能當機。
- 修正 GDK XBOX 的一個問題:程式庫在暫停期間清除與邀請接聽程式相關的內部狀態時可能當機。
- 修正 Android 的一個問題:當在清除 JavaVM 附加執行緒時呼叫 PFMultiplayerUninitialize(),程式庫可能當機。
- 修正 macOS 的一個問題:程式庫的符號連結不正確,在整合程式庫時可能造成建置失敗。
1.7.8
2024 年 11 月 5 日錯誤修正
- 修正一個問題:對以 PFMultiplayerCreateServerBackfillTicket 建立的補位票證呼叫 PFMatchmakingTicketCancel 時失敗。
- 修正一個問題:SDK 將 PFMultiplayerServerDetails 中所有值視為必填。
- 修正一個問題:Sony(PlayStation®4 與 PlayStation®5)SDK 版本未能正確處理 Sony(PlayStation®4 與 PlayStation®5)HTTP 程式庫產生的間歇性 HTTP 要求失敗。此外,已改善錯誤回報,提供更詳細的資訊。
1.7.7
2024 年 10 月 25 日錯誤修正
- 修正 macOS 平台上曝露的 OpenSSL 符號問題。此版本僅支援 macOS。
1.7.6
2024 年 8 月 12 日錯誤修正
- 修正 GDK XBOX 的一個問題:標題暫停並回復後,某些事件未加入佇列。
- 修正 GDK XBOX 的一個當機:標題暫停並回復後發生。
- 更新 PFMultiplayerCreateServerBackfillTicket,於某位對局成員已加入過多票證時自動處理失敗。在此情境下,SDK 會自動取消補位票證成員既有的票證,並重試票證建立。
1.7.5
2024 年 7 月 17 日錯誤修正
- 修正在 Unix 系統上搭配自訂記憶體掛勾使用 PFMultiplayerUninitialize 時可能造成當機的問題。
1.7.4
2024 年 6 月 17 日錯誤修正
- 修正一個問題:如果訊息包含
'\0'字元,SDK 未能正確剖析 PlayStation®4 與 PlayStation®5 上透過 WebSocket 接收的訊息。無法剖析這些訊息可能導致 PubSub 連線問題。此修正僅適用於 PlayStation®4 與 PlayStation®5。
1.7.3
2024 年 4 月 23 日錯誤修正
- 解決在同一個應用程式中同時使用 Party 與 Multiplayer 時發生的重複類別錯誤。此修正僅適用於 Android。
1.7.2
2024 年 3 月 7 日錯誤修正
- 修正一個問題:內部 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,可為配對票證關聯自訂內容。
錯誤修正
- 改善內部診斷。
1.6.4
2023 年 8 月 16 日錯誤修正
- 修正一個錯誤:GDK DLL 沒有經過程式碼簽署。此修正僅適用於 GDK 版本。
1.6.3
2023 年 8 月 14 日錯誤修正
- 修正一個問題:處理變更通知時程式庫可能當機。
- 新增全新的 PFLobbyMemberCountRemainingSearchKey 常數,以便更輕鬆地依據剩餘成員數搜尋並排序大廳。
1.6.2
2023 年 7 月 14 日錯誤修正
- 修正一個問題:透過
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 日錯誤修正
- 修正僅發生於 iOS 與 macOS 的連結器錯誤:執行階段找不到 HttpClient.framework。
1.5.2
2023 年 4 月 4 日錯誤修正
- 引入
PFMultiplayerPal.h標頭,提供對非 MSVC 編譯器的支援。此標頭為非 MSVC 編譯的平台定義 SAL 與 HRESULTs。
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()時更輕鬆地僅搜尋鎖定或未鎖定的大廳。
錯誤修正
- 新增修正,以減少因背景執行緒競用而導致的非預期 PubSub 斷線。
1.4.3
2022 年 11 月 15 日新功能
- PlayFab Multiplayer v1.4.3 帶來 iOS 與 macOS 的支援。
1.4.2
2022 年 10 月 26 日錯誤修正
- 修正一個錯誤:PubSub 重新連線可能導致未來的 PubSub 取消訂閱要求失敗。
1.4.1
2022 年 10 月 25 日錯誤修正
- 修正一個錯誤:程式庫產生了不必要且短生命週期的執行緒。
- 於 Windows、XBOX 與 Android 上,修正一個錯誤:程式庫可能在先前記錄的重試等待期間屆滿前就嘗試進行 Web 要求。
- 改善 Web 伺服器無法連線時的錯誤訊息。
1.4.0
2022 年 10 月 11 日新功能
- PlayFab Multiplayer 版本 1.4.0 新增對 Android 的支援。
1.3.1
2022 年 9 月 20 日錯誤修正
- 修正一個錯誤:呼叫 PFMultiplayerUninitialize 或程式庫在 XBOX 主機內部處理應用程式暫停時,WebSocket 資源會發生記憶體洩漏。
1.3.0
2022 年 9 月 9 日新功能
- 新增函式 PFLobbyGetMemberConnectionStatus,用於偵測使用者是否連線至 PubSub 通知服務。當使用者的連線狀態變更時,您會收到 PFLobbyUpdatedStateChange,其 PFLobbyMemberUpdateSummary 中
connectionStatusUpdated欄位為true。 - 將與 PubSub 通知服務交換訊息所使用的通訊協定由 JSON 更新為 MessagePack,可減少訊息大小。此變更對 API 介面沒有影響。
錯誤修正
- 針對數個與速率限制相關的錯誤,改善由 PFMultiplayerGetErrorCode 回報的訊息。
1.2.0
2022 年 8 月 17 日新功能
- 現在,當配對佇列設定為配置多人伺服器時,對局細節會回報找到對局時所配置的多人伺服器相關伺服器詳細資訊。如需詳細資訊,請見 PFMatchmakingMatchDetails。
- 為
lobby/amOwner搜尋鍵定義新的常數PFLobbyAmOwnerSearchKey。如需搜尋鍵使用資訊,請見 PFLobbySearchConfiguration。
錯誤修正
- 針對數個錯誤碼,改善由 PFMultiplayerGetErrorCode 回報的訊息。
- 修正一個錯誤:在某些失敗情況下,通知服務未取消訂閱實體。
1.1.5
2022 年 7 月 13 日錯誤修正
- 修正 PFLobby.h 標頭中
PFLobbyMemberCountSearchKey與PFLobbyAmMemberSearchKey的常數字串值錯誤。 - 修正一個錯誤:若 WebSocket 意外關閉,
PFMultiplayerUninitialize()可能會無限期封鎖。 - 修正一個錯誤:在 WebSocket 發生非預期斷線後,PubSub 通知變得無法使用,且 Lobby/Matchmaking API 作業無限期停滯。
1.1.4
2022 年 6 月 24 日錯誤修正
- GDK:修正一個錯誤:如果作業在暫停或回復後太快啟動,涉及網路通訊的作業會靜默失敗。
- 修正一個錯誤:當於偵錯工具中中斷超過 10 秒後回復執行時,SDK 會當機。
1.1.3
2022 年 6 月 10 日新功能
- SDK 現在對非預期斷線的反應更為敏捷(偵測速度比先前快 2-3 倍)。
- 非預期的大廳斷線現在會導致自動重新連線嘗試。用戶端只有在這些重新連線嘗試失敗後才會得知斷線。
- GDK/Win32:Web 服務失敗回應(429、503 及類似回應)現在會觸發自動重試。用戶端只有在這些重試失敗後才會得知失敗。
錯誤修正
- 修正一個錯誤:連續配對 10 場後配對失敗。
- 修正一個錯誤:
GetErrorMessage(...)未提供與配對相關的錯誤訊息。 - 修正一個錯誤:
LobbySearchResult結構中兩個欄位(maxMemberCount與currentMemberCount)未正確填入。 - 修正暫停與回復後行為與可靠性的多項錯誤。
1.1.1
2022 年 4 月 13 日錯誤修正
- Switch:提供建置 PlayFab Multiplayer 所需的新 PAL 標頭。
1.1.0
2022 年 3 月 4 日API 變更
- 變更
PFMultiplayerGetErrorMessage的 API 簽章。以前,此函式傳回HRESULT,並使用輸出參數傳回錯誤訊息字串。現在,此函式直接傳回字串。
新功能
- GDK:新增於 XBOX 上自動處理暫停與回復的支援。
錯誤修正
- 修正一個錯誤:若玩家為重新加入大廳,API 會忽略傳入
PFMultiplayerJoinLobby的初始成員資料。
1.0.0
2021 年 11 月 23 日 PlayFab Multiplayer 目前開放預覽。如需 Matchmaking 與 Lobby 功能概觀,請參閱:- PlayFab Lobby 概觀
- PlayFab Multiplayer Lobby 快速入門
- PlayFab Matchmaking 概觀
- PlayFab Multiplayer Matchmaking 快速入門