> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

這些版本資訊適用於 **PlayFabCSdk**。如需其他 PlayFab Services SDK 的版本資訊，請參閱[其他 Services SDK 版本資訊](https://docs.xbox.com/zh-TW/announcements/playfab/release-notes.md)。

> [!NOTE]
>
> 如需服務版本與產品更新的版本資訊，請參閱 [PlayFab 公開 GitHub 存放庫](https://github.com/PlayFab/PlayFab)上的[版本資訊](https://github.com/PlayFab/PlayFab/releases)一節

## 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


## Related topics

- [PlayFab Services C/C++ SDK 版本資訊](https://docs.xbox.com/zh-TW/services/playfab/release-notes/playfab-c/index.md)
- [PlayFab Services SDK 2026 版本資訊](https://docs.xbox.com/zh-TW/services/playfab/release-notes/index.md)
- [PlayFab Services SDK 2023 版本資訊](https://docs.xbox.com/zh-TW/services/playfab/release-notes/2023.md)
- [PlayFab Services SDK 2024 版本資訊](https://docs.xbox.com/zh-TW/services/playfab/release-notes/2024.md)
- [PlayFab Services SDK 2025 版本資訊](https://docs.xbox.com/zh-TW/services/playfab/release-notes/2025.md)