PlayFab Services C/C++ SDK 版本資訊

這些版本資訊適用於 PlayFabCSdk。如需其他 PlayFab Services SDK 的版本資訊，請參閱其他 Services SDK 版本資訊。

​

2604.0.1

日期：2026 年 9 月 4 日

​

重大變更

• 由於服務 API 已停用，因此移除 PFInventoryGetMicrosoftStoreAccessTokensAsync、其結果函式，以及其要求和回應類型。
• 由於服務 API 已停用，因此移除 PFSegmentsServerGetPlayersInSegmentAsync、其結果函式，以及其支援類型。
• 從 PFAuthenticationGetEntityRequest 移除過時的 entity 成員。PFAuthenticationGetEntityAsync 現在會為呼叫實體簽發權杖。
• 重新命名兩個 Account Management 要求類型，以區分 Client 和 Server 模型：
  • PFAccountManagementUnlinkAppleRequest 現在是 PFAccountManagementClientUnlinkAppleRequest。
  • PFAccountManagementUnlinkGameCenterAccountRequest 現在是 PFAccountManagementClientUnlinkGameCenterAccountRequest。
• 移除已停用的 E_PF_COPILOT_DISABLED、E_PF_COPILOT_INVALID_REQUEST、E_PF_GET_PLAYERS_IN_SEGMENT_DEPRECATED 和 E_PF_GET_PLAYERS_IN_SEGMENT_RATE_LIMIT_EXCEEDED 錯誤碼。
• 將 PFGameSaveInitOptions 的基礎類型從 uint32_t 變更為 uint64_t。
• 在 PFMultiplayerServerAzureVmSize 中新增值。插入點之後的現有值會有新的數值表示法，因此應用程式不應跨 SDK 版本保存或傳輸此列舉的數值。

​

API 更新

• 在 PFFriendsClientGetFriendsListRequest 和 PFFriendsServerGetFriendsListRequest 中新增選用的 namespaceWide 成員。它會包含同一命名空間中尚未登入目前遊戲的好友。
• 透過在相關 Authentication、Account Management 和使用者資訊模型上新增 authVersion、sandboxId 和 psnSandboxId 成員，新增 PlayStation Network 驗證版本和沙箱支援。
• 在 PFAccountManagementGetPlayFabIDsFromNintendoServiceAccountIdsRequest 中新增 issuer。
• 透過 includeStatistics 以及新的 PFStatisticColumn、PFStatisticColumnCollection 和 PFStatisticColumnCollectionDictionaryEntry 類型，在實體設定檔中新增統計資料。
• 在 PFStatisticsStatisticUpdate 中新增 aggregationTargetEntityKeys，並新增 PFStatisticAggregationMethod 列舉。
• 在 PFInventoryRedemptionSuccess 中新增 expirationTimestamp、在 PFMultiplayerServerRequestPartyServiceResponse 中新增 region，並新增其他 Azure VM 大小。
• 新增對應新的 PlayStation Network、Nintendo、Economy、Experiments、Statistics、Segments、實體成員資格、IP 位址和 Game Save 狀況的服務錯誤碼。
• PFEntityRegisterTokenRefreshedEventHandler 現在接受選用的工作佇列。
• 新增 E_PF_GAMESAVE_OPERATION_IN_PROGRESS，用於因另一個互斥作業正在進行而遭拒的 Game Save 作業。
• 新增 PF_GAMESAVE_MAX_SHORT_SAVE_DESCRIPTION_LENGTH，將可接受的簡短存檔描述長度上限定義為 768 個字元。

​

執行階段與平台更新

• 修正在內部 HTTP 作業或事件管線排清進行中時，PFUninitializeAsync 停止回應的問題。
• 在初始化期間將 SDK 版本新增至追蹤記錄。
• 更新 PlayFab::Wrappers::Exception::what()，使其訊息包含 HRESULT。
• 在 iOS 和 macOS 上以預設可見性匯出 PF_API 符號，並修正使用 Apple Unified SDK 時 macOS 啟動當機的問題。
• 修正 Clang 型工具鏈上大小化 operator delete 覆寫的問題，讓自訂記憶體攔截程序得以生效。
• 更新 GDK 專案以使用 GDK 2510 配置所需的 x64 專案平台，並新增將專案重定目標至 Visual Studio 2026 v145 工具組的支援。
• 將 Android com.google.android.gms:play-services-games-v2 相依性固定為 21.0.0 版，以保留 minSdkVersion 21 相容性。

​

Game Save 更新

• 修正非 PlayFab Blob 傳輸失敗被回報為成功的問題。HTTP 失敗現在會傳回失敗的 HRESULT，而不是允許針對未寫入的 Blob 完成資訊清單。
• 修正涉及過時延伸資訊清單 URL、不完整的遠端檔案集、下載期間刪除資料夾、遺失 localstate.json，以及為新存檔建立標記檔案的資料遺失和同步問題。
• 修正上傳、鎖定和衝突失敗，包括無限重新鎖定迴圈、過時的資訊清單版本、不正確的基底版本鏈、衝突落敗者選取、不可重試服務錯誤處理不當，以及刪除目錄後上傳速度不必要地緩慢等問題。
• 修正共用 Game Save 內容管理中的 GDK 記憶體損毀和競爭狀況，並新增驗證以防止延伸資訊清單路徑逸出存檔資料夾。
• 在同步進入 Uploading 狀態時，還原遊戲對存檔資料夾的寫入存取權。原始檔案僅在 PreparingForUpload 期間為唯讀。
• 釐清進度行為：PFGameSaveFilesUiProgressCallback 會回報狀態轉換，而 PFGameSaveFilesUiProgressGetProgress 可供輪詢以取得位元組層級的進度。總計為零現在表示總計未知。
• 修正 GRTS 取消和離線行為、接受 Unreal Engine 等引擎產生的正斜線路徑，並修正數個 Windows 和 GDK 初始化、關機、裝置身分識別和存檔載入失敗的問題。
• 修正 Game Save 遙測錯誤識別 Steam Deck 裝置的問題。

​

2504.0.0

日期：2025 年 4 月 22 日

• 將 JSON 剖析從 rapidjson 移轉至 nlohmann::json，以提升安全性和可維護性。
• 解決初始化 PFCore 會覆寫遊戲所設定之追蹤回呼的問題。
• 變更記憶體攔截函式，新增 API 以擷取預設記憶體攔截程序，並修改現有的記憶體配置函式以包含記憶體類型識別碼。
• 修正涉及多個用戶端時與追蹤清除相關的錯誤。
• 在 PlayFab.C 中啟用 PFAccountManagementSetDisplayNameAsync API。
• 為 nlohmann JSON 程式庫引進自訂記憶體配置，以及 new/delete 運算子的全域覆寫。

​

2410.0.0

日期：2024 年 10 月 4 日

• 在 GitHub 版本中新增可搭配 Microsoft GDK 使用的公用標頭、原始程式碼和程式庫
• HTTP 程式庫 libHttpClient 現在在所有平台上都是動態程式庫相依性。 遊戲出貨的套件中必須包含此程式庫，PlayFab Services 才能運作。
• 新增 Leaderboards 和 Statistics 的公開預覽 API
• 在 PFAuthenticationLoginWithFacebookRequest 中新增選用參數 authenticationToken
• 新增對新服務錯誤碼的支援
• 從 Economy API 的兌換回應中移除 OfferId，改為新增欄位 MarketplaceAlternateId。 呼叫端應改用新欄位；為了回溯相容性，服務仍會在回應中同時傳回這兩個欄位。
• 解決 PFFriendsExternalFriendSources 不允許多重選取的問題

​

2406.0.0

日期：2024 年 7 月 2 日

• 在 Linux 和 Android 的 PFEventPipelineConfig 中新增選用 gzip 壓縮支援
• 新增使用 PFHttpSettings 進行自動回應 gzip 壓縮 (和解壓縮) 的支援
• 嘗試記錄 XCurl 追蹤時啟用列印截斷
• 修正各種靜態程式碼分析警告

​

2403.0.0

日期：2024 年 2 月 28 日

• 發行支援 Linux、Android、iOS 和 macOS 的新 SDK 投影。此版本公開的新 API 如下：
  • Android：
    • LoginWithFacebook
    • ClientLinkGoogleAccount
    • ClientLinkGooglePlayGamesServicesAccount
    • ClientUnlinkGoogleAccount
    • ClientUnlinkGooglePlayGamesServicesAccount
    • ClientAndroidDevicePushNotificationRegistration
    • RedeemGooglePlayInventoryItems
  • iOS：
    • LoginWithFacebook
    • ClientLinkApple
    • ClientUnlinkApple
    • ClientLinkGameCenterAccount
    • ClientUnlinkGameCenterAccount
    • ClientRegisterForIOSPushNotification
    • RedeemAppleAppStoreInventoryItems
• 在事件管線中新增事件緩衝支援。

​

2310.0.1

日期：2023 年 9 月 28 日

• 在 Win32 中新增 PFAccountManagementServerLinkNintendoServiceAccountSubjectAsync

​

2310.0.0

日期：2023 年 9 月 28 日

• 新增 Nintendo Switch 支援 (若要要求存取權，請參閱「Request access for secured SDKs and samples - PlayFab | Microsoft Learn」)
• 在 PFEventPipelineConfig 中新增選用的 gzip compressionLevel
• 從 PFEvents 移除 TelemetryKey 管理呼叫
• 新增遺漏的舊版 PFCloudScript Client 呼叫：
  • ClientExecuteCloudScript
  • ExecuteEntityCloudScript
• 新增遺漏的 PFAccountManagement Client 呼叫：
  • ClientAddOrUpdateContactEmail
  • ClientAddUsernamePassword
  • ClientGetPlayFabIDsFromFacebookIDs
  • ClientGetPlayFabIDsFromFacebookInstantGamesIds
  • ClientGetPlayFabIDsFromGameCenterIDs
  • ClientGetPlayFabIDsFromGoogleIDs
  • ClientGetPlayFabIDsFromGooglePlayGamesPlayerIDs
  • ClientGetPlayFabIDsFromKongregateIDs
  • ClientGetPlayFabIDsFromNintendoServiceAccountIds
  • ClientGetPlayFabIDsFromNintendoSwitchDeviceIds
  • ClientGetPlayFabIDsFromPSNAccountIDs
  • ClientGetPlayFabIDsFromTwitchIDs
  • ClientLinkAndroidDeviceID
  • ClientLinkApple
  • ClientLinkFacebookAccount
  • ClientLinkFacebookInstantGamesId
  • ClientLinkGameCenterAccount
  • ClientLinkGoogleAccount
  • ClientLinkGooglePlayGamesServicesAccount
  • ClientLinkIOSDeviceID
  • ClientLinkKongregate
  • ClientLinkNintendoServiceAccount
  • ClientLinkNintendoSwitchDeviceId
  • ClientLinkPSNAccount
  • ClientLinkTwitch
  • ClientRemoveContactEmail
  • ClientSendAccountRecoveryEmail
  • ClientUnlinkAndroidDeviceID
  • ClientUnlinkApple
  • ClientUnlinkFacebookAccount
  • ClientUnlinkFacebookInstantGamesId
  • ClientUnlinkGameCenterAccount
  • ClientUnlinkGoogleAccount
  • ClientUnlinkGooglePlayGamesServicesAccount
  • ClientUnlinkIOSDeviceID
  • ClientUnlinkKongregate
  • ClientUnlinkNintendoServiceAccount
  • ClientUnlinkNintendoSwitchDeviceId
  • ClientUnlinkPSNAccount
  • ClientUnlinkTwitch
  • ClientUpdateUserTitleDisplayName
• 新增許多供遊戲伺服器使用的呼叫 (僅適用於 Win32)
  • PFAuthentication
    • ServerLoginWithServerCustomId
    • ServerLoginWithSteamId
    • ServerLoginWithXbox
    • ServerLoginWithXboxId
    • AuthenticateGameServerWithCustomId
    • Delete
    • GetEntity
    • ValidateEntityToken
  • PFAccountManagement
    • ServerBanUsers
    • ServerDeletePlayer
    • ServerGetPlayerCombinedInfo
    • ServerGetPlayerProfile
    • ServerGetPlayFabIDsFromFacebookIDs
    • ServerGetPlayFabIDsFromFacebookInstantGamesIds
    • ServerGetPlayFabIDsFromNintendoServiceAccountIds
    • ServerGetPlayFabIDsFromNintendoSwitchDeviceIds
    • ServerGetPlayFabIDsFromPSNAccountIDs
    • ServerGetPlayFabIDsFromSteamIDs
    • ServerGetPlayFabIDsFromTwitchIDs
    • ServerGetPlayFabIDsFromXboxLiveIDs
    • ServerGetServerCustomIDsFromPlayFabIDs
    • ServerGetUserAccountInfo
    • ServerGetUserBans
    • ServerLinkNintendoServiceAccount
    • ServerLinkNintendoSwitchDeviceId
    • ServerLinkPSNAccount
    • ServerLinkServerCustomId
    • ServerLinkSteamId
    • ServerLinkXboxAccount
    • ServerRevokeAllBansForUser
    • ServerRevokeBans
    • ServerSendCustomAccountRecoveryEmail
    • ServerSendEmailFromTemplate
    • ServerUnlinkNintendoServiceAccount
    • ServerUnlinkNintendoSwitchDeviceId
    • ServerUnlinkPSNAccount
    • ServerUnlinkServerCustomId
    • ServerUnlinkSteamId
    • ServerUnlinkXboxAccount
    • ServerUpdateAvatarUrl
    • ServerUpdateBans
    • GetTitlePlayersFromXboxLiveIDs
  • PFCloudScript
    • ServerExecuteCloudScript
  • PFFriends
    • ServerAddFriend
    • ServerGetFriendsList
    • ServerRemoveFriend
    • ServerSetFriendTags
  • PFInventory
    • GetTransactionHistory
  • PFLocalization
    • GetLanguageList
  • PFPlatformSpecific
    • ServerAwardSteamAchievement
  • PFPlayerDataManagement
    • ServerGetUserData
    • ServerGetUserInternalData
    • ServerGetUserPublisherData
    • ServerGetUserPublisherInternalData
    • ServerGetUserPublisherReadOnlyData
    • ServerGetUserReadOnlyData
    • ServerUpdateUserData
    • ServerUpdateUserInternalData
    • ServerUpdateUserPublisherData
    • ServerUpdateUserPublisherInternalData
    • ServerUpdateUserPublisherReadOnlyData
    • ServerUpdateUserReadOnlyData
  • PFPushNotifications
    • ServerSendPushNotification
    • ServerSendPushNotificationFromTemplate
  • PFSegments
    • ServerAddPlayerTag
    • ServerGetAllSegments
    • ServerGetPlayerSegments
    • ServerGetPlayersInSegment
    • ServerGetPlayerTags
    • ServerRemovePlayerTag
  • PFTitleDataManagement
    • ServerGetPublisherData
    • ServerGetTime
    • ServerGetTitleData
    • ServerGetTitleInternalData
    • ServerGetTitleNews
    • ServerSetPublisherData
    • ServerSetTitleData
    • ServerSetTitleInternalData

​

2306.0.0

日期：2023 年 7 月 26 日

• SDK 初始版本，支援 Win32 和 GDK