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

> PlayFab 2018 年的发行说明。

## 181218

日期：2018 年 12 月 18 日

### XPlatCppSdk 特定变更

* [XPlatCppSdk](https://github.com/PlayFab/XPlatCppSdk)
  -**SDK 中断性变更**：更新了 `XPlatCppSdk` 存储库的文件夹结构。如果你通过项目引用使用该 SDK，则需要更新 vcxproj 文件路径。
  * 为 `XPlatCppSdk` 添加了 XBOX 支持。请参阅适用于 XBOX 的 C++ 快速入门。
  * **新增 API**
  * 添加了 `PlayFabEventApi`，以支持重量级（低吞吐量）和轻量级（高吞吐量）自定义事件。

### UnrealMarketplacePlugin 特定变更

* [UnrealMarketplacePlugin](https://github.com/PlayFab/UnrealMarketplacePlugin)
  * 添加了对 Unreal Engine 4.21 的支持

## 181204

日期：2018 年 12 月 4 日

### XPlatCppSDK 特定变更

* [XPlatCppSDK](https://github.com/PlayFab/XPlatCppSDK)
  * 添加了对生成外部依赖项的支持。
  * 更新了 NuGet 组成。这不是中断性变更。已将外部依赖项的二进制文件添加到 NuGet 中，并更新了属性表。
  * 修复了 **QoSAPI** 的 bug。

### CSharpSDK 特定变更

* [CSharpSDK](https://github.com/PlayFab/CSharpSDK)
  * 添加了 .NET Standard 1.1/2.0（以及 .NET Core）支持。
  * 更新了 NuGet 组成。该包现在包含 .NET Standard 1.1/2.0 的二进制文件以及可移植库。
  * 已将 VS 项目文件迁移到 VS 2017 标准。

### UnitySDK 特定变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * **SDK 中断性变更**：`SimpleGet` 成功回调的签名已更改，现在必须接受一个新的 byte\[] 类型的单一参数。
  * 添加了 `SimplePost`。

## 181105

日期：2018 年 11 月 5 日

### API 变更

* PlayFab 现在支持使用 `OpenID` 进行登录和帐户关联。
* 更多 XboxLive ID 支持，并支持通过服务器进行 XBOX 登录。

为了准备更广泛地发布该服务，我们正在推出 PlayFab Multiplayer Servers 2.0 API。有关详细信息，请参阅 [PlayFab Multiplayer Servers 2.0 (Thunderhead)](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/servers/index.md)

## 181001

日期：2018 年 10 月 1 日

### API 变更

* 多项弃用已生效，我们已从 SDK 和文档中删除这些元素。
  * 隐藏了一些与未发布功能相关的 Admin API 方法。
  * `server.DeleteUsers` 的弃用已生效。
  * 分布在 admin、client、matchmaker 和 server API 中各种与匹配相关的调用里的 `ServerHostname` 字段弃用已生效。替代字段为 `ServerIPV4Address`。

### UnitySDK 变更

* 对 `ScreenTime` 分析进行了小幅修复/改进。

### 所有 SDK

* GitHub 存储库的自动生成分支结构正在发生变化。
  * 面向客户的常规分支“versioned”和“master”保持不变。

## 180924

日期：2018 年 9 月 24 日

### API 变更

* 向 [DeleteMasterPlayerAccountRequest](xref:titleid.playfabapi.com.admin.accountmanagement.deletemasterplayeraccount#deletemasterplayeraccountrequest) 模型添加了元数据。
* 修复了 Unreal Marketplace Plugin 中的 bug，以扩展支持的版本。

## 180917

日期：2018 年 9 月 17 日

### API 变更

* Server API 方法 `DeleteUsers` 已弃用，并由 [DeletePlayer](xref:titleid.playfabapi.com.server.accountmanagement.deleteplayer) 替代
* Unreal Marketplace Plugin：
  * 更新了 Marketplace Plugin，以包含我们的蓝图接口。
  * [新的 Unreal Engine 快速入门指南](https://docs.xbox.com/zh-CN/services/playfab/sdks/unreal/quickstart.md)
  * [在 Unreal Marketplace 中查看](https://www.unrealengine.com/marketplace/playfab-SDK)

## 180906

日期：2018 年 9 月 6 日

### 新增 API

* **本地化**

### 新增 PlayStream 事件文档

* [client\_focus\_change](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/Session/client-focus-change.md)
* [client\_session\_start](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/Session/client-session-start.md)
* [player\_device\_info](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/PlayerIdentity/player-device-info.md)

## 180829

日期：2018 年 8 月 29 日

### API 变更

* 将 `Entity.TypeString` 重命名为 `Entity.Type`。
* 将 `EmptyResult` 重命名为 \[EmptyResponse].(`xref:titleid.playfabapi.com.groups.groups.removemembers#emptyresponse`)
* 重命名了大多数身份验证函数调用，例如将 `GameServer` 重命名为 `MutliplayerServer`。
* [Admin.GetUserAccountInfo](xref:titleid.playfabapi.com.admin.accountmanagement.getuseraccountinfo) 提供了更详细的平台信息。

### Objective C 特定变更

* 各种 bug 修复和重构。
* 将 AttributeInstallRequest 更改为特定于 API。

### Unreal Engine 特定变更

* 在 SDK 生成器中添加了 UE Marketplace 插件。

## 180809

日期：2018 年 8 月 9 日

### API 组变更

* 我们已将 Entity API 组拆分为多个新的 API 组。
* 对于使用以前的 Entity API 的任何人来说，这是一项重大的 SDK 中断性变更。
* 请参阅我们的[升级指南](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/game-configuration/entities/entity-api-restructure-upgrade-tutorial.md)！
* （注意：博客和升级指南的链接可能暂时无法使用，它们即将完成。）

### API 变更

* **新增 API 方法：**
  * 以下 API 已发布并在 SDK 中可见，但配套文档尚未准备就绪：
    * client.[LoginWithNintendoSwitchDeviceId](xref:titleid.playfabapi.com.client.authentication.loginwithnintendoswitchdeviceid)
    * client.[UnlinkNintendoSwitchDeviceId](xref:titleid.playfabapi.com.client.accountmanagement.unlinknintendoswitchdeviceid)
    * server.[GetPlayFabIDsFromNintendoSwitchDeviceIds](xref:titleid.playfabapi.com.client.accountmanagement.getplayfabidsfromnintendoswitchdeviceids)
    * client.[LoginWithFacebookInstantGamesId](xref:titleid.playfabapi.com.client.authentication.loginwithfacebookinstantgamesid)（尚不可用）
    * client.[UnlinkFacebookInstantGamesId](xref:titleid.playfabapi.com.client.accountmanagement.unlinkfacebookinstantgamesid)（尚不可用）
    * server.[GetPlayFabIDsFromFacebookInstantGamesIds](xref:titleid.playfabapi.com.client.accountmanagement.getplayfabidsfromfacebookinstantgamesids)（尚不可用）。
* **新增 PlayStream 事件**
  * `title_hopper_config_updated` 事件已重命名为 [title\_queue\_config\_updated](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/Matchmaking/title-queue-config-updated.md)
* **常规变更**
  * 在许多模型中弃用了参数 `ServerAddress`，改用新的 `ServerIPV4Address`。

### Unreal（多个 SDK）特定变更

* 对两个 SDK/插件进行了小幅更新，为最终合并到 Marketplace 插件做准备。（即将推出！）

### PythonSDK! 特定变更

* [PythonSDK!](https://github.com/PlayFab/PythonSdk)
  * bug 修复和改进。

### UnitySDK 和 CSharpSDK 特定变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK) 和 [CSharpSDK](https://github.com/PlayFab/CSharpSDK)
  * 添加了一个名为 Plugin Manager 的新结构。目前，这只是为将来的变更打下基础。我们将一些旧的函数签名标记为已过时，你应该更新它们。（不过没有中断性变更。）
  * 发现并解决了 HTTPS.Put 的多个问题，使 Entity Files 可以在更多平台上使用。
  * 修复了 ScreenTime 功能中的 bug。

## 180716

日期：2018 年 7 月 16 日

### UnitySDK 变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 修复了 ScreenTime 在某些罕见情况下的小问题。

### CSharpSDK 变更

* [CSharpSDK](https://github.com/PlayFab/CSharpSDK)
  * 向 C# SDK 添加了 [Plugin Manager API](https://github.com/PlayFab/CSharpSDK/blob/master/PluginManager.md)，以支持 JSON 序列化程序和 HTTP 客户端的可选自定义实现。

  * ~~**UnrealCppSdk 变更：**~~（更新：此 SDK 已弃用。有关新的 Unreal SDK，请参阅 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK)）

  * Unreal 4 C++ SDK 也已在 [Unreal Marketplace 上发布！](https://www.unrealengine.com/marketplace/playfab-SDK)

## 180710

日期：2018 年 7 月 10 日

### Unity 修补程序版本

* 进一步优化和改进了 ScreenTime 事件。

## 180709

日期：2018 年 7 月 9 日

### 修补程序版本

* 修复了上周部署中的一些小问题。
* 上周发行说明中的所有内容现在应按预期工作。

## 180706

日期：2018 年 7 月 6 日

### API 变更

* **新增 API 方法：**
  * entity.[WriteEvents](xref:titleid.playfabapi.com.events.playstreamevents.writeevents)

### UnitySdDK 特定变更

* [UnitySdDK](https://github.com/PlayFab/UnitySDK)
  * 上一版本中所述的屏幕时间跟踪不再仅限于 Beta 版。

## 180705

日期：2018 年 7 月 5 日

### API 变更

* EntityAPI.[ExecuteEntityCloudScript](xref:titleid.playfabapi.com.cloudscript.server-sidecloudscript.executeentitycloudscript)
* `PlayStreamEventModel.title_hopper_config_updated`

### 新的 PythonSDK! 变更

* [PythonSDK!](https://github.com/PlayFab/PythonSdk)
  * 已使用 2.7 进行测试

### UnitySDK 变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 将一些实用工具包装在命名空间中，以避免与第三方冲突。
  * Editor Extensions 的异常行为应会减少，并显示更少的警告。
  * 新功能 - 请阅读我们的 [Sessions](https://docs.xbox.com/zh-CN/services/playfab/data-analytics/ingest-data/sessions.md) 教程。

### JavaScriptSDK 变更

* [JavaScriptSDK](https://github.com/PlayFab/JavaScriptSDK)
  * `customData` 中继参数现在应可用于登录函数。

### XPlatCppSDK 特定变更

* [XPlatCppSDK](https://github.com/PlayFab/XPlatCppSdk)
  * 现在可以正确分析大型结果。

## 180618

日期：2018 年 6 月 18 日

### API 变更

* 在各种 API 方法中添加了新的错误代码。
* 多个与实体相关的 PlayStream 事件现在会描述其 [EntityLineage](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/entitylineage.md)。

## 180528

日期：2018 年 5 月 28 日

### API 变更

* **新增 API 方法：**
  * Admin.[GetPlayedTitleList](xref:titleid.playfabapi.com.admin.accountmanagement.getplayedtitlelist)
  * Admin.[DeleteMasterPlayerAccount](xref:titleid.playfabapi.com.admin.accountmanagement.deletemasterplayeraccount)
  * Admin.[ExportMasterPlayerData](xref:titleid.playfabapi.com.admin.accountmanagement.exportmasterplayerdata)
  * 这是新的 GDPR 发布的一部分。请参阅我们的博客[此处](https://blog.playfab.com/blog/gdpr) 
* 更新了各种 API 方法中的错误代码
* 新增 PlayStream 事件：
  * [player\_data\_exported](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/PlayerIdentity/player-data-exported.md)

## 180514

日期：2018 年 5 月 14 日

### XPlatCppSDK 特定变更

* [XPlatCppSDK](https://github.com/PlayFab/XPlatCppSdk)
  * 修复了 JSON 序列化中的问题。

## 180507

日期：2018 年 5 月 7 日

### API 变更

* **新增 API 方法：**
  * entity.[GetProfiles](xref:titleid.playfabapi.com.profiles.accountmanagement.getprofiles)
* **新增 PlayStream 事件：**
  * [entity\_executed\_cloud\_script](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/CloudScript/entity-executed-cloud-script.md)
* **更新的 API 方法：**
  * client.[RegisterPlayFabUser](xref:titleid.playfabapi.com.client.authentication.registerplayfabuser) 现在返回 [result](xref:titleid.playfabapi.com.client.authentication.registerplayfabuser#registerplayfabuserresult).[EntityToken](xref:titleid.playfabapi.com.client.authentication.registerplayfabuser#entitytokenresponse)

### UnitySDK 特定变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 提高了 `HttpWebRequest` 证书验证的安全性。
  * 默认情况下不再忽略所有证书。
  * 客户应自行实现证书验证，或调用 `PlayFab.Internal.PlayFabWebRequest.SkipCertificateValidation()`。

### WindowsSdk 特定变更

* 修复了数百个 4 级警告。
* 更正了 `PlayFabSettings.cpp` 中发布的版本号。
* 以前的大多数版本在代码和调用标头中嵌入的版本号都是错误的。

### 创建了 XPlatCppSDK

* [XPlatCppSDK](https://github.com/PlayFab/XPlatCppSDK)
  * 目前处于 Beta 版阶段。
  * 以 Windows SDK 为模板生成。
  * 可能会取代 Windows SDK（至少还需要几个月）。
  * 升级应该几乎不需要中断性变更。
  * 一些 `cpprestsdk` 字符串应转换为 `std::string`。
  * 将一些 `web::json::value` 类型转换为 `json::value`。
  * 时间戳尚未在 Linux 中经过全面测试。
  * NuGet 包
  * 使用更轻量级的依赖项
  * 具体来说是 `jsoncpp` 和 curl，而不是 `cpprestsdk`。
  * 在所有位置都使用 `std::string`，而不是混用两种字符串类型。
  * 添加了 Linux 支持。

## 180414

日期：2018 年 4 月 14 日

~~**UnrealCppSdk 修补程序：**~~（更新：此 SDK 已弃用。有关新的 Unreal SDK，请参阅 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK)）

* ~~在 UnrealCppSdk 的 Entity API 版本中发现了问题。这些问题已通过修补程序修复，Entity API 现在应按预期工作。~~

## 180409

日期：2018 年 4 月 9 日

### API 变更

* **修补程序：**
  * 仅更新了日期，未更新主/次版本号。
* **公会：**
  * client.[GetAccountInfo](xref:titleid.playfabapi.com.client.accountmanagement.getaccountinfo).[UserAccountInfo](xref:titleid.playfabapi.com.client.accountmanagement.getaccountinfo#useraccountinfo).[UserTitleInfo](xref:titleid.playfabapi.com.client.accountmanagement.getaccountinfo#usertitleinfo).[TitlePlayerAccount](xref:titleid.playfabapi.com.client.accountmanagement.getaccountinfo#entitykey) 现在包含识别其他玩家并将其添加到你的公会/群组所需的信息。
  * 也可以通过 [admin.GetUserAccountInfo](xref:titleid.playfabapi.com.admin.accountmanagement.getuseraccountinfo) 和 [server.GetUserAccountInfo](xref:titleid.playfabapi.com.server.accountmanagement.getuseraccountinfo) 找到相同的信息。

### [UnitySDK](https://github.com/PlayFab/UnitySDK) 特定变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 针对长时间运行的进程，提高了默认 HTTP 设置 (UnityWWW) 的性能。

## 180403

日期：2018 年 4 月 3 日

### Unreal SDK 已更新为支持 v4.17 到 4.19

* 删除了对 UE 4.14 到 4.16 的支持（请更新！）

## 180329

日期：2018 年 3 月 29 日

### Unreal SDK 已更新为支持 Entity API

* 抱歉耽搁了！
* 此版本仍面向 UE 4.17，而不是 4.18 或 4.19。我们正在努力更新版本。

## 180316

日期：2018 年 3 月 16 日

### API 变更

* 实体！[博客](https://api.playfab.com/blog/introducing-entities-objects-and-files)！[快速入门指南](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/game-configuration/entities/quickstart.md)！
* 如果 `request.LoginTitlePlayerAccountEntity` 设置为 `true`，所有 Client 登录方法都会返回实体凭据。
* 公会！[博客](https://api.playfab.com/blog/announcing-groups-for-guilds-friends-clans-and-more)！[指南](https://docs.xbox.com/zh-CN/services/playfab/community/associations/groups/quickstart.md)！
* 更新了许多 API 方法的错误代码以提高准确性（数十个！）。

### 新增 API 方法

* [admin.RevokeInventoryItems](xref:titleid.playfabapi.com.admin.playeritemmanagement.revokeinventoryitems) 和 [server.RevokeInventoryItems](xref:titleid.playfabapi.com.server.playeritemmanagement.revokeinventoryitems)。
* 全新的 [Entity API](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/game-configuration/entities/quickstart.md)。
* 许多新的 [Entity PlayStream 事件](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/index.md)（在链接页面上搜索“entity”）。

### 大多数 SDK 已更新为支持 Entity API

* **完全支持：**
  * [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * [JavaScriptSDK](https://github.com/PlayFab/JavaScriptSDK)
  * [ActionScriptSDK](https://github.com/PlayFab/ActionScriptSDK)
  * [CSharpSDK](https://github.com/PlayFab/CSharpSDK)
  * [NodeSDK](https://github.com/PlayFab/NodeSDK)
  * [PostmanCollection](https://github.com/PlayFab/PostmanCollection)
  * WindowsSDK
  * [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)
  * [JavaSDK](https://github.com/PlayFab/JavaSDK)
  * [LuaSdk](https://github.com/PlayFab/LuaSDK)（包括 Corona 和 Defold）
  * [PhpSdk](https://github.com/PlayFab/PhpSdk)
  * CloudScript
* **即将支持：** Unreal Bp 和 Cpp。（抱歉 - 由于技术困难而延迟！）

## 180213

日期：2018 年 2 月 13 日

### API 变更

* 当请求参数中传入自定义帐户恢复电子邮件模板 ID 时，`SendAccountRecoveryEmail` 现在支持自定义帐户恢复电子邮件模板。
* 所有 Client 登录机制现在都可以选择返回 Entity API 凭据。
  （这是即将推出的功能的一部分。）

### UnitySDK 特定变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 我们将停止支持较旧的 Unity 版本，请参阅我们的[博客文章](https://blog.playfab.com/blog/unity-version-support)。
  * 生成文件现在使用 Unity 2017.3.0f3 版本发布。

## 180131

日期：2018 年 1 月 31 日

### JavaSDK 变更

* [JavaSDK](https://github.com/PlayFab/JavaSDK)
  * Java 现已发布到 Maven。

## 180129

日期：2018 年 1 月 29 日

### UnitySDK 特定变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 修复了压缩方面的问题。
  * 现在应该可以安全地为所有版本和所有平台重新启用压缩。

## 180123

日期：2018 年 1 月 23 日

### UnitySDK 修补程序

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * PlayFab UnitySDK 在 Unity 2017.1 版本中存在问题。
  * 有关详细信息，请参阅[论坛帖子](https://community.playfab.com/questions/16734/error-cs1061-no-definition-for-sendwebrequesterror.html)。
  * 我们已解决此问题。PlayFab UnitySDK 应该再次适用于所有版本。

## 180122

日期：2018 年 1 月 22 日

### API 文档更新

* 更新了许多 API 方法的错误代码。

### CSharpSDK 和 UnitySDK 特定变更

* [CSharpSDK](https://github.com/PlayFab/CSharpSDK) 和 UnitySDK
  * 添加了 PlayFabException 类，以便更轻松地捕获 PlayFab 特定的异常。

### NodeSDK 特定变更

* [NodeSDK](https://github.com/PlayFab/NodeSDK)
  * SDK 中断性变更：NodeSDK NPM 包的 require 语法已更改。
  * 主要升级侧重于 NPM 包。
  * 以前的 require 语句不遵循 NPM 约定，需要多个非标准 require 语句。
  * 现在只需要一个 require 语句，并遵循 NPM 约定。
  * 主版本号已更改，此版本现在为 2.0。
  * 1.x 到 2.x [升级指南](https://github.com/PlayFab/NodeSDK/blob/master/upgrade.md)。

### CloudScript 示例

* 为 API Error 异常添加了 TypeScript 定义。

## 180103

日期：2018 年 1 月 3 日

### LuaSDK 特定更新

* [LuaSDK](https://github.com/PlayFab/LuaSDK)/Defold/Corona
  * bug 修复更新。
  * 某些平台生成了无法解析的格式错误的 URL。

## 180102

日期：2018 年 1 月 2 日

### UnitySDK 特定更新

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * bug 修复更新。
  * 为了避免响应标头出现问题，应为所有设备版本禁用压缩。此更新使这成为可能。
  * 或者，切换到 Web Request 也可以避免此问题。
  * 为 Unity 2017 以上版本添加了新的 HTTP 选项。


## Related topics

- [PlayFab 2019 年发行说明](https://docs.xbox.com/zh-CN/announcements/playfab/2019.md)
- [PlayFab 2020 年发行说明](https://docs.xbox.com/zh-CN/announcements/playfab/2020.md)
- [PlayFab 2015 年发行说明](https://docs.xbox.com/zh-CN/announcements/playfab/2015.md)
- [PlayFab 2016 年发行说明](https://docs.xbox.com/zh-CN/announcements/playfab/2016.md)
- [PlayFab 2017 年发行说明](https://docs.xbox.com/zh-CN/announcements/playfab/2017.md)