> ## 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 SDK 2023 版本发布说明

> PlayFab Services SDK 2023 年发布说明,涵盖当年推出的 SDK 版本更新、新增 API、弃用和修复。

<Note>
  有关服务发布和产品更新的发布说明,请参阅 [PlayFab 的公共 GitHub 仓库](https://github.com/PlayFab/PlayFab) 上的 [发布说明](https://github.com/PlayFab/PlayFab/releases) 部分
</Note>

## 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 添加了以下项:
  * 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 2021 版本发布说明](/zh-CN/services/playfab/release-notes/2021.md)
- [PlayFab 2015 版本发布说明](/zh-CN/services/playfab/release-notes/2015.md)
- [PlayFab 2022 版本发布说明](/zh-CN/services/playfab/release-notes/2022.md)
- [PlayFab 2019 版本发布说明](/zh-CN/services/playfab/release-notes/2019.md)
- [PlayFab 2020 版本发布说明](/zh-CN/services/playfab/release-notes/2020.md)