> ## 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 SDK 2023 年发行说明

> PlayFab Services SDK 2023 年的发行说明。

> [!NOTE]
>
> 有关服务版本和产品更新的发行说明，请参阅 [PlayFab 的公共 GitHub 存储库](https://github.com/PlayFab/PlayFab)中的[发行说明](https://github.com/PlayFab/PlayFab/releases)部分

## 231208

日期：2023 年 12 月 8 日

* 向 Multiplayer API 中添加了以下 Lobby 调用：
  * JoinLobbyAsServer
  * LeaveLobbyAsServer
  * UpdateLobbyAsServer
* 为 Segment 的 Create、Get、Update 添加了对以下 Actions 的支持：
  * AddInventoryItemsV2SegmentAction
  * DeleteInventoryItemsV2SegmentAction
  * SubtractInventoryItemsV2Action

## 231124

日期：2023 年 11 月 24 日

* 更新了部分与 Lobby 相关的错误代码的名称

## 231110

日期：2023 年 11 月 10 日

* 向 Admin/CreateActionsOnPlayersInSegmentTask 中的可用 Actions 添加了以下 Actions：
  * AddInventoryItemV2Content
  * DeleteInventoryItemV2Content
  * SubtractInventoryItemV2Content

## 231027

日期：2023 年 10 月 27 日

* Admin API 的 CreateActionsOnPlayersInSegmentTask 方法中 BanPlayerContent 的 BanDurationHours 属性现在是可选的

## 231013

日期：2023 年 10 月 13 日

* 向 Admin API 中的 Create 和 Update OpenIdConnection 请求添加了 IgnoreNonce 和 IssuerOverride
* 向 Multiplayer API 中的 AzureRegion 添加了 SwedenCentral

## 230929

日期：2023 年 9 月 29 日

* 添加了 Actions 数组，以支持获取和设置计划任务的操作
* 为所有计划任务操作类型添加了模型
* 向 Multiplayer API 中添加了 RequestPartyService 调用
* 为 InvalidStatisticScore 添加了新的错误代码
* 为 Lobby 场景添加了新的错误代码：
  * LobbyAssociatedServerMismatch
  * LobbyAssociatedServerNotFound
  * LobbyAssociatedToDifferentServer
  * LobbyServerAlreadyAssociated
  * LobbyIsNotClientOwned
  * LobbyDoesNotUseConnections

## 230915

日期：2023 年 9 月 15 日

* 向 Multiplayer API 中的 ListContainerImageTagsRequest 和 Response 添加了 PageSize 和 SkipToken
* 向 Profile API 返回的 Profile 对象的 Statistics 字段添加了 AttributeStatistics 和 Scores 属性
* 向 Server API 中添加了 LinkNintendoServiceAccountSubject 调用

## 230901

日期：2023 年 9 月 1 日

* 添加了新的 Admin API 调用：DeleteMasterPlayerEventData
* 为 LeaderboardColumnLengthMismatch 添加了新的错误代码
* 向 Economy API 中的 TransferInventoryItemsResponse 添加了 OperationStatus

## 230818

日期：2023 年 8 月 18 日

* 添加了多个与 Managed Events 相关的错误代码：
  * ManageEventNamespaceInvalid
  * ManageEventNameInvalid
  * ManagedEventNotFound
  * ManageEventsInvalidRatio
  * ManagedEventInvalid
* 向 UserAccountInfo 添加了 ServerCustomIdInfo
* 向 ContinentCode 和 CountryCode 添加了 "Unknown"

## 230804

日期：2023 年 8 月 4 日

* 对多个 API 的参考文档进行了少量更新

## 230721

日期：2023 年 7 月 21 日

* 更新了 Economy V1 调用的参考文档

## 230707

日期：2023 年 7 月 7 日

* 向 Events API 中添加了 TelemetryKey 管理
* 从 GetEntity 调用中的 EntityProfile 移除了 LeaderboardMetadata - 此值未被使用，因此不存在中断性变更的风险
* 向 Server API 中添加了 LinkPSNId

## 230623

日期：2023 年 6 月 23 日

* 添加了与 Addon 管理相关的错误代码
* 向 Economy API 中的 SearchItemsRequest 添加了 Language
* 向 Unity SDK 添加了对 TelemetryKey 身份验证的支持
* 添加了对 Unreal Engine 5.2 的支持

## 230609

日期：2023 年 6 月 9 日

* 为 PartySerializationError 添加了错误代码
* 向 Client API 中的 LoginWithSteam 添加了 TicketIsServiceSpecific
* 向 Economy API 中的 CatalogPrice 添加了 UnitAmount
* 向 Unreal、XplatCpp 和 C# SDK 添加了对 TelemetryKey 身份验证的支持

## 230529

日期：2023 年 5 月 29 日

* 向 Multiplayer API 中添加了 Dadsv5 作为有效的 AzureVmFamily，以及相关的 AzureVmSize 选项
* 向 Multiplayer API 中的 GetMultiplayerServerDetails 响应添加了 PublicIPV4Addresses

## 230512

日期：2023 年 5 月 12 日

* 为 TelemetryKeyLongInsightsRetentionNotAllowed 添加了错误代码
* 向 XplatCpp SDK 添加了对 macOS 生成目标的支持

## 230428

日期：2023 年 4 月 28 日

* 添加了多个与 PlayerCustomProperties 相关的错误代码：
  * PlayerCustomPropertiesPropertyNameTooLong
  * PlayerCustomPropertiesPropertyNameIsInvalid
  * PlayerCustomPropertiesStringPropertyValueTooLong
  * PlayerCustomPropertiesValueIsInvalidType
  * PlayerCustomPropertiesVersionMismatch
  * PlayerCustomPropertiesPropertyCountTooHigh
  * PlayerCustomPropertiesDuplicatePropertyName
  * PlayerCustomPropertiesPropertyDoesNotExist
* 向 Multiplayer API 中的 GetBuild 响应添加了 VmStartupScriptConfiguration

## 230403

日期：2023 年 4 月 3 日

* 移除了 Admin API 中的旧版服务器托管调用 GetServerBuildUploadUrl
* 为 AnalyticsSegmentCountOverLimit 添加了错误代码
* 向 Economy API 中的 AddInventoryItemsOperation 添加了 DurationInSeconds
* 向 Economy API 中的 RedeemPlayStationStoreInventoryItems 添加了 RedirectUri
* 向 Profiles API 中添加了 GetTitlePlayersFromXboxLiveIDs
* 向 Server API 中添加了 LinkSteamId 和 UnlinkSteamId

## 230320

日期：2023 年 3 月 20 日

* 支持 [2023 年 3 月 13 日 PlayFab 服务版本](https://github.com/PlayFab/PlayFab/releases/tag/untagged-ee9d08281cf8b7b22c9c)
* 为 TelemetryKeyDeactivated 添加了错误代码
* 从各个 API 中移除了以下与旧版服务器托管相关的调用：
  * Admin/GetMatchmakerGameInfo
  * Admin/GetMatchmakerGameModes
  * Admin/ModifyServerBuild
  * Client/GetCurrentGames
  * Client/GetGameServerRegions
  * Client/Matchmake
  * Matchmaker/AuthUser
  * Matchmaker/PlayerJoined
  * Matchmaker/PlayerLeft
  * Matchmaker/UserInfo
  * Server/DeregisterGame
  * Server/NotifyMatchmakerPlayerLeft
  * Server/RedeemMatchmakerTicket
  * Server/RefreshGameServerInstanceHeartbeat
  * Server/RegisterGame
  * Server/SetGameServerInstanceData
  * Server/SetGameServerInstanceState
  * Server/SetGameServerInstanceTags
* 从 Admin API 中的 RefundPurchaseResponse 移除了 Region
* 从 Multiplayer API 中的多个调用移除了 UseStreamingForAssetDownloads

## 230306

日期：2023 年 3 月 6 日

* 为以下错误添加了错误代码：
  * EntityAPIKeysNotSupported
  * IpAddressBanned
  * EntityLineageBanned
  * NamespaceMismatch
  * InvalidServiceConfiguration
  * InvalidNamespaceMismatch
  * TelemetryKeyNotFound
  * TelemetryKeyInvalidName
  * TelemetryKeyAlreadyExists
  * TelemetryKeyInvalid
  * TelemetryKeyCountOverLimit
* 向 Client API 中的 LoginWithGoogleAccountRequest 添加了 SetEmail
* 对 Economy API 进行了以下添加：
  * 向多个与物品相关的请求和操作添加了 DurationInSeconds
  * 向 CatalogPrice 添加了 UnitDurationInSeconds
  * 向 CatalogIte 添加了 DefaultStackId
  * 向 InventoryItem 添加了 ExpirationDate

## 230220

日期：2023 年 2 月 20 日

* 为 InvalidNintendoSwitchAccountId 添加了错误代码
* 向 Multiplayer API 中的多个调用添加了 VmStartupScriptConfiguration

## 230206

日期：2023 年 2 月 6 日

* 为以下错误添加了错误代码：
  * AnalysisSubscriptionNotFound
  * AnalysisSubscriptionFailed
  * AnalysisSubscriptionFoundAlready
  * AnalysisSubscriptionManagementInvalidInput
  * InvalidGameCenterId
* 移除了 Economy API 中多个调用对 Amount 作为必需值的要求

## 230123

日期：2023 年 1 月 23 日

* 修复了 Unity Editor Extensions 中的内存泄漏
* 向 XplatCpp SDK 添加了在关闭时发送未发送事件的支持

## 230109

日期：2023 年 1 月 9 日

* 修复了 C# SDK 中 ValidateEntityToken 的 bug


## Related topics

- [PlayFab Services SDK 2026 年发行说明](https://docs.xbox.com/zh-CN/announcements/playfab/release-notes.md)
- [PlayFab Services SDK 2024 年发行说明](https://docs.xbox.com/zh-CN/announcements/playfab/2024.md)
- [PlayFab Services SDK 2025 年发行说明](https://docs.xbox.com/zh-CN/announcements/playfab/2025.md)
- [PlayFab Services C/C++ SDK 发行说明](https://docs.xbox.com/zh-CN/announcements/playfab/playfab-c/release-notes.md)
- [PlayFab Multiplayer C++ SDK 发行说明](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)