> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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) 的版本資訊索引，追蹤各版本的 SDK 版本、新增 API、淘汰事項和錯誤修正。

這些版本資訊適用於 **PlayFabCSdk**。如需其他 PlayFab Services SDK 的版本資訊，請參閱[其他 Services SDK 版本資訊](/zh-TW/services/playfab/release-notes)。

<Note>
  如需服務版本和產品更新的版本資訊，請參閱 [PlayFab 公開 GitHub 存放庫](https://github.com/PlayFab/PlayFab)上的[版本資訊](https://github.com/PlayFab/PlayFab/releases)區段
</Note>

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

- [版本資訊](/zh-TW/tools/tools-pc/xbox-pc-remote-tools/release-notes/index.md)
- [PlayFab 2017 版本資訊](/zh-TW/services/playfab/release-notes/2017.md)
- [PlayFab 2019 版本資訊](/zh-TW/services/playfab/release-notes/2019.md)
- [PlayFab 2022 版本資訊](/zh-TW/services/playfab/release-notes/2022.md)
- [PlayFab 2018 版本資訊](/zh-TW/services/playfab/release-notes/2018.md)