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

> PlayFab Services SDK 2019 年发布说明,包括当年提供的 SDK 版本、新增 API、弃用和平台改进。

## 191218

2019 年最后一次 SDK 发布!

### API 更改:

* 新方法:[GetMultiplayerServerLogs](https://learn.microsoft.com/en-us/rest/api/services/playfab/multiplayer/multiplayerserver/getmultiplayerserverlogs) 和 [UntagContainerImage](https://learn.microsoft.com/en-us/rest/api/services/playfab/multiplayer/multiplayerserver/untagcontainerimage)
* 大多数 SDK 的许多小 bug 修复,包括:[ActionScriptSdk](https://github.com/PlayFab/ActionScriptSDK)、[CloudScript](https://github.com/PlayFab/SdkTestingCloudScript)、[CSharpSdk](https://github.com/PlayFab/CSharpSDK)、[UnitySDK](https://github.com/PlayFab/UnitySdk)、[UnrealSDK](https://www.unrealengine.com/marketplace/product/playfab-sdk)

### [NodeSDK](https://github.com/PlayFab/NodeSDK) 相关更改:

* \[小破坏性更改] 错误情况现在抛出 error() 对象而非纯字符串

### [UnitySDK](https://github.com/PlayFab/UnitySdk) 相关更改:

* 为 Unity 创建了 asmdef 文件,以将 PlayFab 与 Unity 运行时 DLL 解耦
* 在 Unity: 5.6.Latest 以及 2017.1.Latest 到 2019.3.Latest 的所有版本上验证正常工作

### [UnrealSDK](https://www.unrealengine.com/marketplace/product/playfab-sdk) 相关更改:

* 添加了对 Unreal 4.24 的支持
* 在 4.22、4.23、4.24 上验证正常工作

### [XplatCppSdk](https://github.com/PlayFab/XPlatCppSdk) 相关更改:

* 此发布有小破坏性更改,你的项目将需要一些代码更改
  * 请参阅我们的[升级指南](https://github.com/PlayFab/XPlatCppSdk/blob/master/upgrade3.22.191111.md)
* (破坏性更改 - 所有客户) 一些 PlayFabSettings 变量已被移动
  * 所有客户都需要小的代码更改。请参阅我们的[升级指南](https://github.com/PlayFab/XPlatCppSdk/blob/master/upgrade3.22.191111.md)
* 对实例 API 数据隔离的重大修复,其中包括一些签名和用法更改
  * 如果你使用了实例 API,则需要客户代码更改,
* C++ 语法改进(为了 const 正确性以及指针与引用)
  * 客户代码调整的可能性很小
* 对所有平台上时间戳的重大修复
  * 如果你在 PlayFab API、模型或 PlayFab 时间戳工具方法中读取或写入时间戳,则需要客户代码更改
  * 大多数客户只会观察到所有平台上现在时间戳都正确且线程安全
* 对大多数平台特定项目/解决方案的小项目更新和已解决的警告

## 191122

日期:2019-11-22

### [CSharpSdk](https://github.com/PlayFab/CSharpSDK) 相关热修复:

* 修复了进行 API 调用时请求身份验证并非始终正确应用的问题
* 修复了一些警告
* 从主 GUI 线程发出的 API 调用会使程序卡顿(因为这是反模式),但不再会使程序死锁

## 191121

日期:2019-11-21

### API 更改:

* 已更新许多方法的错误代码文档

### [CSharpSdk](https://github.com/PlayFab/CSharpSDK) 相关更改:

* 删除了对默认 Json 序列化器 SimpleJson 的硬编码引用。
  * 这将修复客户使用自己的序列化器替换默认序列化器时的一些问题。

### [NodeSDK](https://github.com/PlayFab/NodeSdk) 相关更改:

* typescript 定义的小更新
* 一些以前抛出字符串的位置,现在抛出正确的 Errors
* Phaser 3 兼容性修复

### [UnitySDK](https://github.com/PlayFab/UnitySdk) 相关更改:

* 删除了对默认 Json 序列化器 SimpleJson 的硬编码引用。
  * 这将修复客户使用自己的序列化器替换默认序列化器时的一些问题。
* 在 Unity: 5.6.Latest 以及 2017.1.Latest 到 2019.2.Latest 的所有版本上验证正常工作

### [UnrealSDK](https://www.unrealengine.com/marketplace/product/playfab-sdk) 相关更改:

* 在 4.21、4.22、4.23 上验证正常工作

### [XplatCppSdk](https://github.com/PlayFab/XPlatCppSdk) 发布延迟:

* 我们有一些重大改进和即将进行的更改,但尚未完成。因此,此次发布无法发布 XPlat。
* 将有新功能、性能和签名改进。
* 将有非常小的破坏性更改和升级指南。
* 敬请期待下一次发布!

## 191029

日期:2019-10-29

### API 更改:

* 在客户端 "Login With ..." 方法调用中使用的 [TreatmentAssignment](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/authentication/loginwithandroiddeviceid)。
* [XplatCppSdk](https://github.com/PlayFab/XPlatCppSdk) 中的小 bug 修复
* [PythonSDK](https://github.com/PlayFab/PythonSdk) 的小 bug 修复
* 已解决一些 [NodeSDK](https://github.com/PlayFab/NodeSdk) 问题

### [UnrealSDK](https://github.com/PlayFab/UnrealMarketplacePlugin/) 相关更改:

* 关于请求容器中必需成员变量的小问题修复
* 在 4.21、4.22、4.23 上验证正常工作

### [UnitySDK](https://github.com/PlayFab/UnitySdk) 相关更改:

* 在 Unity: 5.6.Latest 以及 2017.1.Latest 到 2019.2.Latest 的所有版本上验证正常工作

## 191015

日期:2019-10-15

### API 更改:

* [XplatCppSdk](https://github.com/PlayFab/XPlatCppSdk) 中的小 bug 修复 - PlayFab 枚举现在应为枚举类,因此对 PlayFab 枚举将开始强制执行严格的类型化(参见开源 cppCoreGuidelines 中关于枚举类的部分)
* Profiles 现在具有 ExperimentVariants(PlayerProfiles 和 ProfilesAPI,以及对 Admin 和 Server API 的更新)
* 更新 AccountNotFound 的 Client 错误消息
* Events API 添加了阐明性描述,说明允许自定义 PlayStream 事件的哪些命名空间
* [MultiplayerAPI](https://github.com/PlayFab/XPlatCppSdk) 添加了带有 [CreateBuildAlias](xref:titleid.playfabapi.com.multiplayer.multiplayerserver.createbuildalias)、[DeleteBuildAlias](xref:titleid.playfabapi.com.multiplayer.multiplayerserver.deletebuildalias)、[GetBuildAlias](xref:titleid.playfabapi.com.multiplayer.multiplayerserver.getbuildalias)、[UpdateBuildAlias](xref:titleid.playfabapi.com.multiplayer.multiplayerserver.updatebuildalias) 的别名

### [UnrealSDK](https://github.com/PlayFab/UnrealMarketplacePlugin) 相关更改:

* 在 4.21、4.22、4.23 上验证正常工作

### [UnitySDK](https://github.com/PlayFab/UnitySDK) 相关更改:

* 在 Unity: 5.6.Latest 以及 2017.1.Latest 到 2019.2.Latest 的所有版本上验证正常工作

## 191001

日期:2019-10-01

### API 更改:

* Unity 的小 bug 修复,我们在升级 SDK 时不应再看到无害的错误
* C++ 的小 bug 修复,nuget 包不应再需要额外工作即可让 lib\_json 工作
* 文档描述的小更新

### [UnrealSDK](https://github.com/PlayFab/UnrealMarketplacePlugin) 相关更改:

* 在 4.21、4.22、4.23 上验证正常工作

### [UnitySDK](https://github.com/PlayFab/UnitySDK) 相关更改:

* 在 Unity: 5.6.Latest 以及 2017.1.Latest 到 2019.2.Latest 的所有版本上验证正常工作

## 190916

日期:2019-09-16

### API 更改:

* 错误代码更新

### [UnrealSDK](https://github.com/PlayFab/UnrealMarketplacePlugin) 相关更改:

* 小的构建警告修复
* 为 4.23 兼容性做了更新
* 在 4.21、4.22、4.23 上验证正常工作

### [UnitySDK](https://github.com/PlayFab/UnitySDK) 相关更改:

* 在 Unity: 5.6.Latest 以及 2017.1.Latest 到 2019.1.Latest 的所有版本上验证正常工作

## 190903

日期:2019-09-03

### API 更改:

* 向 Server API 添加了 [GetStoreItems](xref:titleid.playfabapi.com.client.title-widedatamanagement.getstoreitems)
* 各种小语法 bug 修复

### [UnrealSDK](https://github.com/PlayFab/UnrealMarketplacePlugin) 相关更改:

* 在 4.20、4.21、4.22 上验证正常工作

### [UnitySDK](https://github.com/PlayFab/UnitySDK) 相关更改:

* 在 Unity: 5.6.Latest 以及 2017.1.Latest 到 2019.1.Latest 的所有版本上验证正常工作

## 190821

日期:2019-08-21

### API 更改

* [Authentication API](https://learn.microsoft.com/en-us/rest/api/services/playfab/authentication/authentication?) 有一个新的 LoginIdentityProvider
* 向收据验证 API 添加了 CatalogVersion 参数
* PurchaseReceiptFulfillment - 收据验证 API 返回已履行的物品,例如 [Restore IOS Purchases](https://learn.microsoft.com/en-us/rest/api/services/playfab/client/platform-specific-methods/restoreiospurchases)

### [UnrealSDK](https://github.com/PlayFab/UnrealMarketplacePlugin) 相关更改:

* 在 4.20、4.21、4.22 上验证正常工作

### [UnitySDK](https://github.com/PlayFab/UnitySDK) 相关更改:

* 在 Unity: 5.6.Latest 以及 2017.1.Latest 到 2019.1.Latest 的所有版本上验证正常工作

## 190717

日期:2019-07-17

### API 更改:

* [WriteTelemetry](xref:titleid.playfabapi.com.events.playstreamevents.writetelemetryevents) 现在已脱离 Beta 阶段,成为公开 API
* [Multiplayer APIs](https://learn.microsoft.com/en-us/rest/api/services/playfab/multiplayer/multiplayerserver) 已脱离 Beta 阶段,进入 CSharpOnly
* 小 API 错误代码更新

### [UnrealSDK](https://github.com/PlayFab/UnrealMarketplacePlugin) 相关更改:

* 在 4.20、4.21、4.22 上验证正常工作

### [UnitySDK](https://github.com/PlayFab/UnitySDK) 相关更改:

* 在 Unity 5.6.Latest 以及 2017.1.Latest 到 2019.1.Latest 的所有版本上验证正常工作

## 190625

日期:2019-06-25

### API 更改:

* 小 API 更改
* [Authentication](https://learn.microsoft.com/en-us/rest/api/services/playfab/authentication/authentication) bug 修复

### [UnrealSDK](https://github.com/PlayFab/UnrealMarketplacePlugin) 相关更改:

* 在 4.20、4.21、4.22 上验证正常工作

### [UnitySDK](https://github.com/PlayFab/UnitySDK) 相关更改:

* 在 Unity 5.6.Latest 以及 2017.1.Latest 到 2019.1.Latest 的所有版本上验证正常工作

## 190610

日期:2019-06-10

### API 更改:

* 小 bug 修复

### [Authentication](https://learn.microsoft.com/en-us/rest/api/services/playfab/authentication/authentication/validateentitytoken) API 更改:

* [EntityLineage](https://learn.microsoft.com/en-us/rest/api/services/playfab/authentication/authentication/validateentitytoken?)
* [ValidateEntityToken](https://learn.microsoft.com/en-us/rest/api/services/playfab/authentication/authentication/validateentitytoken)

## 190520

### API 更改:

* 小 bug 修复

### [UnrealSDK](https://github.com/PlayFab/UnrealMarketplacePlugin) 相关更改:

* 在 4.20、4.21、4.22 上验证正常工作

### [UnitySDK](https://github.com/PlayFab/UnitySDK) 相关更改:

* 在 Unity 5.6.Latest 以及 2017.1.Latest 到 2019.1.Latest 的所有版本上验证正常工作

## 190509

日期:2019-05-09

### API 更改:

#### 新方法

* multiplayer.[GetTitleMultiplayerServersQuotas](xref:titleid.playfabapi.com.multiplayer.multiplayerserver.gettitlemultiplayerserversquotas)
* server.[AddGenericID](xref:titleid.playfabapi.com.server.accountmanagement.addgenericid)
* server.[GetPlayFabIDsFromGenericIDs](xref:titleid.playfabapi.com.server.accountmanagement.getplayfabidsfromgenericids)
* server.[LinkServerCustomId](xref:titleid.playfabapi.com.server.accountmanagement.linkservercustomid)
* server.[RemoveGenericID](xref:titleid.playfabapi.com.server.accountmanagement.removegenericid)
* server.[UnlinkServerCustomId](xref:titleid.playfabapi.com.server.accountmanagement.unlinkservercustomid)

#### 新的推送模板方法

* 三个新的推送通知 API 使开发人员能够删除、创建、保存和发送推送通知模板
* server.[DeletePushNotificationTemplate](xref:titleid.playfabapi.com.server.accountmanagement.deletepushnotificationtemplate)
* server.[SavePushNotificationTemplate](xref:titleid.playfabapi.com.server.accountmanagement.savepushnotificationtemplate)
* server.[SendPushNotificationFromTemplate](xref:titleid.playfabapi.com.server.accountmanagement.sendpushnotificationfromtemplate)

### [UnitySdk](https://github.com/PlayFab/UnitySDK) 相关更改:

* 在 2019.1 上验证正常工作

### [CSharpSdk](https://github.com/PlayFab/CSharpSDK) 和 [XPlatCppSdk](https://github.com/PlayFab/XPlatCppSdk) 相关更改:

* 小 bug 修复

## 190424

日期:2019-04-24

### API 更改:

]

* 更新了 [PlayFab API](/services/playfab/api-references) 中以下 API 的错误代码:**Admin**、**Authentication**、**CloudScript**、**Groups**、**Matchmaker** 和 **Multiplayer**。

## 190410

日期:2019-04-10

### [Profiles](https://learn.microsoft.com/en-us/rest/api/services/playfab/profiles/account-management?) API 更改:

* [EntityStatisticValue](https://learn.microsoft.com/en-us/rest/api/services/playfab/profiles/account-management/getprofiles?)
* [EntityStatisticChildValue](https://learn.microsoft.com/en-us/rest/api/services/playfab/profiles/account-management/getprofiles)

## 190312

日期:2019-03-12

### API 更改:

* 新的 [Multiplayer](https://learn.microsoft.com/en-us/rest/api/services/playfab/multiplayer/multiplayerserver?) API

## 190304

日期:2019-03-04

### API 更改:

* Windows C++ SDK 现已弃用。对于任何 Windows C++ 开发,我们建议使用 [XPlatCppSdk](https://github.com/PlayFab/XPlatCppSdk)

## 190219

日期:2019-02-19

小 bug 修复

## 190205

日期:2019-02-05

### API 更改:

* 更新了过时的文档元数据
* 在大多数 API 中添加了 TypeString 作为 Type 的备用名称
* 向 [Admin](/services/playfab/api-references) API 添加了 AddLocalizedNews
* 向 [Server](/services/playfab/api-references) API 添加了 GetPlayFabIDsFromPSNAccountIDs

## 190123

日期:2019-01-23

### API 更改:

* 添加了另一个 MatchmakingEntityInvalid 原因 - NoLeaderboardForStatistic
* 向 [Multiplayer](https://learn.microsoft.com/en-us/rest/api/services/playfab/multiplayer/multiplayerserver) 模型添加了 **CurrentServerStats**
* Unity 上的各种 bug 修复
* XBOX xplat nugets 也可用:[https://www.nuget.org/packages/com.playfab.xplatxboxsdk.v141/](https://www.nuget.org/packages/com.playfab.xplatxboxsdk.v141/)


## 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 2020 版本发布说明](/zh-CN/services/playfab/release-notes/2020.md)
- [PlayFab 2018 版本发布说明](/zh-CN/services/playfab/release-notes/2018.md)
