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

> PlayFab 2015 年的发行说明。

## 151221

日期：2015-12-20

### JavaSDK 特定变更

* [JavaSDK](https://github.com/PlayFab/JavaSDK)

  * 现在会在需要时自动以适当方式获取 Google advertisingId。

### NodeSDK 特定变更

* [NodeSDK](https://github.com/PlayFab/NodeSDK)

  * 已对 0.7.151210 版本进行热修复，修正了一个小 bug。

## 151210

日期：2015-12-08

### API 变更

* 改进了 **PlayerStatistic** 的 API。
* XBOX 身份验证。
* PS4™ 身份验证。
* 文档的小幅改进。
* 改进了 [SDKGenerator](https://github.com/PlayFab/SDKGenerator)，清理了生成器和所有 SDK 中的代码，更好地分离了客户端/服务器 SDK。
* 在所有 SDK 中为即将推出的功能新增了自动化测试。

"PS4" 是 Sony Interactive Entertainment Inc. 的注册商标或商标。

### WindowsSDK/C++/Cocos2d-xSDK 特定变更

* WindowsSDK/C++/[Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)

  * SDK 的结构已更改。从旧版本更新的用户需要比平时多做一些工作。

### UnitySDK 特定变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 在下一个版本中，将自动以适当方式获取 **Google advertisingId** 和 iOS IDFA。

### 特定热修复（2015 年 12 月 11 日）

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 现在会在需要时自动以适当方式获取 **Google advertisingId** 和 iOS IDFA。

## 151130

日期：2015-11-29

### API 变更

* `LoginWithGameCenter` - 此方法之前已发布，现在取消隐藏。
* `GetLeaderboardAroundUser` - 修复了返回结果数量不正确的一些问题。
* `GetFriendLeaderboardAroundUser` - 新的 API 方法，其作用类似于 `GetLeaderboardAroundUser`，但会将排行榜结果限制为当前玩家的好友列表。
* **常规登录** - 所有登录结果都会返回新数据。公开新数据的工作仍处于原型阶段，尚未完全可用。敬请期待！

## 151123

日期：2015-11-22

### API 变更

* 改进了 Steam 错误消息响应。
* 更新了 SDK 的自动化测试系统。
* 文档的小幅更新。

### ActionScriptSDK 特定变更

* [ActionScriptSDK](https://github.com/PlayFab/ActionScriptSDK)

  * 修复了测试调试输出中的一个小拼写错误。

### Cocos2d-xSDK 特定变更

* [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)

  * 示例项目现在使用较新版本的 cocos 生成：3.7 -> 3.8.1。

### JavaSDK 特定变更

* [JavaSDK](https://github.com/PlayFab/JavaSDK)
  * 重新整理了文件结构，使其更符合 Web 标准。
  * 新增了一个仅限客户端的 AndroidStudio 示例项目。
  * 进行了小幅更改，以确认此示例能够生成并正常运行。
  * 对 Client/Server/Combo 文件进行了一些自定义，使其更贴合各自用途，不含多余的变量/函数。
  * 常规清理。

### PostmanCollection 特定变更

* [PostmanCollection](https://github.com/PlayFab/PostmanCollection)
  * 修复了服务器/管理员身份验证问题。

### UnitySDK 特定变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)

  * 清理了 Android 插件中的清单。

## 151116

日期：2015-11-15

### API 变更

* 文档更新。
* 版本编号格式略有更改。

### PostmanCollection 特定变更

* [PostmanCollection](https://github.com/PlayFab/PostmanCollection)

  * Postman Versioned Collection 的首次发布。

## 151109

日期：2015-11-08

### API 变更

* 更好地执行了某些数据使用上限，并在超出上限时提供更好的报告。
* 文档的小幅更改。
* 新增 `API-RedeemCouponRequest:`
* [RedeemCoupon API 文档](xref:titleid.playfabapi.com.server.playeritemmanagement.redeemcoupon)
* 修复了 Steam 物品 ID 必须为数字字符串的问题。
* 改进了 OpenGraph 产品的错误报告。
* 新增了第三方请求实用工具，用于跟踪 Google Play 和 Facebook 等第三方 API 的错误率和响应时间。

### WindowsSDK 特定变更

* 现在可以使用数据更新请求对象中的 `KeysToRemove` 字段删除 `UserData`、`CharacterData`、`ItemCustomData`、`SharedGroupData` 及其只读和仅限服务器的变体。

## 151026

日期：2015-10-25

### API 变更

* 进行了大量后台改进，但均不面向公众。
* **API\_Specs** 包含更多信息，将来可用于生成更完整的文档和示例。
* 大幅加快了授予大量物品的速度。

## 151019

日期：2015-10-18

### API 变更

* 更新了多个 API 说明。
* 更新了多个 `SeeAlso` 链接。
* `FailedByUber` 事务错误已弃用，并且
* 由 `FailedByPlayFab` 事务错误取而代之。
* 改进了 Game Manager 中的工作室管理。
* 新增了针对 API 调用速率、大小和计时的实时指标计数器。

### UnitySDK 特定变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 移除对 Unity 4.x 的支持。今后的所有更新仅支持 Unity 5.x 或更高版本：[Unity 博客](https://blogs.unity3d.com/2015/09/16/unity-patch-release-plan/)。
  * 清理了 Client-SDK 中不应再存在的文件。
  * 清理了编辑器下拉选项，并修复了文档链接。
  * 首次提供深入的 PlayFab API 用法示例。这些示例尚未完善到可以正式发布，但有经验的用户可能有兴趣查看早期版本。
  * 更新了 Android GCM 插件以提高可用性：
    * 在适当位置添加了注释。
    * 重命名了变量，以更好地反映其用途。
  * 功能：
    * 修复了未正确实例化时导致空引用的问题。
    * 修复了针对 Android 目标生成时隐藏公共方法的问题。

## 151012

日期：2015-10-11

### API 变更

* 移除了在 Game Manager 中删除 VC 定义的功能，以与 API 保持一致。
* 新增了支持原子递增/递减的后端代码。
* 更改了自定义数据版本，以使用新的原子递增。
* 修复了用户的 VC 超过 Int32 最大值时会回绕的问题。现在 VC 的上限为 Int32 最大值。
* 新增了对区分大小写的 VC 名称的支持，以防止罕见问题。

## 151005

日期：2015-10-04

### API 变更

* 修复了 PSN™ 未正确使用代理的问题。
* 在 Game Manager 中新增了角色库存管理。

"PSN" 是 Sony Interactive Entertainment Inc. 的注册商标或商标。

## 150928

日期：2015-09-27

### API 变更

* **Client/Server-API**：`GetCharacterInventory` 可能返回新的错误类型：`CharacterNotFound`。
* **Admin-API**：通过在请求中提供角色 ID，`RevokeInventoryItemRequest` 可以对角色库存进行操作。
* **全部**：极小幅度的 API 文档更新。
* 当 `GetUserData` API 调用指定了筛选键时绕过缓存。
* 在撤销物品 API 调用中新增了可选的角色 ID。
* 修复了版本化数据调用返回 null 而不是空值的问题。
* 更改了 API，将虚拟货币名称限制为 2 个字符。

### ActionScriptSDK 特定变更

* [ActionScriptSDK](https://github.com/PlayFab/ActionScriptSDK)

  * ActionScript Versioned SDK 的首次发布。

### Cocos2d-xSDK 特定变更

* [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)

  * 新增了 CloudScript 测试。

### CSharpSDK 特定变更

* [CSharpSDK](https://github.com/PlayFab/CSharpSDK)
  * 单元测试框架的小幅更新。
  * 新增了 CloudScript 测试。

### JavaSDK 特定变更

* [JavaSDK](https://github.com/PlayFab/JavaSDK)

  * CloudScript 修复，新增了 CloudScript JUnit 测试。
  * 改进了错误/失败 API 调用的错误报告。

### UnitySDK 特定变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 单元测试框架的小幅更新。
  * 新增了 CloudScript 测试。
  * 修复了 Android 推送通知。

### WindowsSDK/C++ 特定变更

* 新增了 CloudScript 测试。

## 150921

日期：2015-09-20

### API 变更

* **All-APIs**：函数文档的小幅更改。
* **All-APIs**：CatalogItem 新增了一个与 Facebook 购买关联的可选参数。
* **Client and Server API**：`GetCharacterInventoryResult` 中新增了 VC 充值时间。
* **Client-API**：`LinkFacebookAccountRequest` 新增了一个可选参数，用于覆盖旧连接。
* **Client-API**：修复了 `LinkKongregateAccountRequest` 和 `LoginWithKongregateRequest` 的参数。
* 移除了角色名称的 `[a-zA-Z0-9] regex`。
* 改进了内部错误处理，以防止返回无用的服务器错误。
* 新增了测试，以验证 CDN API 按说明工作。
* 更改了 `AddFriend` API，以防止将自己添加为好友。
* 修复了 `AddFriend` 服务器 API 始终返回错误的问题。
* 更新了推送通知内部代码，以便从远程推送服务报告更好的错误。
* 修复了 API 使用情况报告中的错误计数问题：某些错误不会在摘要中报告，但会在详细信息中显示。
* 为 CloudScript 新增了速率限制，并新增了让 CloudScript -> PlayFab API 调用绕过速率限制器的功能

## 150908

日期：2015-09-07

### API 变更

* 某些 API 曾返回 `UserisNotValid` 错误，此错误已重命名为 `AccountNotFound`。
* 改进了 PlayFab ID 与 Facebook ID 的匹配集成，并将它们匹配到同一帐户。
* 服务器 API 现在定义了客户端 `GetTitleNews` API。
* `Feature not configured` 错误已拆分为更具体的错误，例如 `Facebook not configured`。
* 改进了与 Paypal API 异常相关的错误。
* 修复了创建优惠券时的问题。

### UnitySDK 特定变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 修复了一些 iOS 生成问题。
  * 文档的轻微改进。
  * Android GCM 修复/更新。

## 150901

日期：2015-08-31

### API 变更

* **新的 Client API**：

  * `ListUsersCharacters`
  * `ConsumeItemRequest` 接受可选的 `CharacterId` 参数。
  * `PurchaseItemRequest` 接受可选的 `CharacterId` 参数。
  * `UnlockContainerItemRequest` 接受可选的 `CharacterId` 参数。
  * 提供 `CharacterId` 时，`PurchaseItem` 现在可能返回新的错误类型 `CharacterNotFound`。
  * 更新了 `UnlockContainerItem` 函数文档。
  * **Client 和 Server**：`GetCharacterInventoryRequest` 参数 `PlayFabId` 现在为可选。
  * 新增了跨登录历史记录跟踪标识提供者的功能。

### UnitySDK 特定变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 新的 meta 文件

### Cocos2d-xSDK 特定变更

* [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)
  * Android 项目现在应可编译。
  * Android 项目默认使用 x86 处理器，但可以在 **Application.mk** 中轻松切换为 armeabi 或其他处理器。

### WindowsSDK 特定变更

* 由于压缩存在问题，已将其禁用。

### JavaScriptSDK 特定变更

* [JavaScriptSDK](https://github.com/PlayFab/JavaScriptSDK)

  * 全面改版 – *与以前的版本不兼容*，请务必注意！

## 150824

日期：2015-08-23

### API 变更

* 更新了 API 文档的部分说明。
* `GetUserInventoryResult` 包含新的可选参数：`PlayFabId`、`CharacterId`。
* `GetCharacterStatisticsResult` 包含新的可选参数：`PlayFabId`、`CharacterId`。
* 调用 `GetTitleData` 时，如果未提供筛选键，将返回所有游戏数据，而不是不返回任何数据。
* 重构了与 Facebook 登录和支付相关的代码，以统一对 Facebook 的 API 调用。
* 新增了 `GetAllUsersCharacters` API。

### UnitySDK 特定变更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 如果在没有 Internet 连接的情况下尝试进行 API 调用，错误回调会包含更详细的信息。

### WindowsSDK 特定变更

* 针对 Android 进行编译时不再引发错误（但执行时尚无法正常工作）。

## 150817 iOS

日期：2015-08-16

### API 变更

* 修复了 CloudScript 管理员 API 返回不当错误代码的问题。
* 新增了对自定义 ID 身份验证的支持。
* 修复了在授予包含掉落表的物品时出现服务器错误的问题，这些掉落表在我们添加掉落表验证之前已被删除。
* 在内部重建了与 iTunes 和 Google Play 收据验证相关的代码。
* 改进了对 API 请求中无效 JSON 的处理。
* 修复了堆叠超过 Int32 最大值导致的问题（现在堆叠上限为 Int32 最大值）。

### SDK 特定变更

* 版本化 SDK 的首次发布。

## 150810

日期：2015-08-09

### API 变更

* 新增了 API 的跨域设置。
* 为新的游戏监视服务添加了基础。
* 在 Game Manager 的游戏密钥编辑器中新增了 Kongregate API 密钥。
* 更新了 SDK 生成器，以考虑接口和继承。
* 修复了 Game Manager 中掉落表的 JSON 上传/下载。
* 为文档生成器新增了单元测试覆盖。
* 新增了在发生 Web 错误时重试 iTunes 收据验证的功能。
* 新增了对 Facebook 支付的支持。
* 新增了货币转换服务。

## 150727

日期：2015-07-26

### API 变更

* 改进了用于生成 ID 的随机数生成器。
* 新增了在验证 Google Play 收据时对 **Base64** 解码错误的捕获。

## 150720

日期：2015-07-19

### API 变更

* 新增了对用于购买的 PayPal 支付提供商的支持。
* 从 `GetUserInventory` API 调用中移除了 `CatalogVersion`。
* 新增了 Kongragate 身份验证 API。

## 150713

日期：2015-07-12

### API 变更

* 新增了从 Game Manager 终止游戏和大厅的审核日志条目。
* 修复了修改商店时商店索引不会更新的问题。
* 新增了跨发布者迁移工作室的内部实用工具。
* 新增了在文档网站中启用查看 Beta 功能的开关。
* 更新了留存报告，以生成按日历周划分的群组。
* 在 Top Spenders Report 中新增了 PlayFab ID，而不仅仅是用户名。
* 修复了 Game Manager 审核日志，以显示用户的显示名称或电子邮件。
* 在 Game Manager 中新增了 User Title Data 编辑器。

## 150706

日期：2015-07-05

### API 变更

* 修复了使用字符串数组的 API 在客户端为 PlayFab ID 列表传入 null 或空值时出现的错误。

## 150629

日期：2015-06-28

### API 变更

* 新增了将 API 标记为 Beta 的功能。
* 修复了堆叠有时无法正常执行的问题。


## Related topics

- [PlayFab 2017 年发行说明](https://docs.xbox.com/zh-CN/announcements/playfab/2017.md)
- [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 2016 年发行说明](https://docs.xbox.com/zh-CN/announcements/playfab/2016.md)
- [PlayFab 2018 年发行说明](https://docs.xbox.com/zh-CN/announcements/playfab/2018.md)