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