> ## 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 2016 年版本資訊

> PlayFab 2016 年的版本資訊。

## 161121

日期：2016 年 11 月 20 日

### API 變更

* 現在可以個別啟用或停用每個 Client API。
* 如需詳細資訊，請參閱我們的[部落格文章](https://blog.playfab.com/blog/permission-policies/)。
* 我們即將推出名為「排程工作」(Scheduled Tasks) 的新功能。
* 如需詳細資訊，請參閱我們的部落格文章：(即將推出)。

### 新的 API

* Client API 原則 API
* [Admin/GetPolicy](xref:titleid.playfabapi.com.admin.authentication.getpolicy)
* [Admin/UpdatePolicy](xref:titleid.playfabapi.com.admin.authentication.updatepolicy)
* 排程工作
* [Admin/AbortTaskInstance](xref:titleid.playfabapi.com.admin.scheduledtask.aborttaskinstance)
* [Admin/CreateActionsOnPlayersInSegmentTask](xref:titleid.playfabapi.com.admin.scheduledtask.createactionsonplayersinsegmenttask)
* [Admin/CreateCloudScriptTask](xref:titleid.playfabapi.com.admin.scheduledtask.createcloudscripttask)
* [Admin/DeleteTask](xref:titleid.playfabapi.com.admin.scheduledtask.deletetask)
* [Admin/GetActionsOnPlayersInSegmentTaskInstance](xref:titleid.playfabapi.com.admin.scheduledtask.getactionsonplayersinsegmenttaskinstance)
* [Admin/GetCloudScriptTaskInstance](xref:titleid.playfabapi.com.admin.scheduledtask.getcloudscripttaskinstance)
* [Admin/GetTasks](xref:titleid.playfabapi.com.admin.scheduledtask.gettasks)
* [Admin/RunTask](xref:titleid.playfabapi.com.admin.scheduledtask.runtask)
* [Admin/UpdateTask](xref:titleid.playfabapi.com.admin.scheduledtask.updatetask)

### 新的 PlayStream 事件

* [title\_permission\_policy\_changed](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/ApiAccessPolicy/title-permission-policy-changed.md)

### WindowsSDK 特定變更

* 全面翻新的新版 **WindowsSDK** 將於下週發佈。
* 如需簡要說明，請參閱我們的部落格文章。
* 如果您有興趣預覽即將推出的變更，請在此張貼：
  * [https://community.playfab.com/questions/3973/windowsc-SDK-vs2015-support.html](https://community.playfab.com/questions/3973/windowsc-SDK-vs2015-support.html)

## 161108

日期：2016 年 11 月 7 日

### HOTFIX

全面翻新的 [CSharpSDK](https://github.com/PlayFab/CSharpSDK) 1.0 版將 .NET 版本需求從 4.0 提高到 4.6。這並非預期行為。此 Hotfix 移除了僅限 4.6 的功能，使其可在 .NET 4.0 或更新版本上建置。

## 161107

日期：2016 年 11 月 6 日

### API 變更

**共用**

* `CatalogItem`
* `InitialLimitedEditionCount` (已結束 Beta)
  如果 `IsLImitedEdition` 為 `true`，則此欄位決定該項目一開始可用的數量。如果此目錄中已存在該目錄項目，或欄位值小於 1，則會忽略此欄位。
* 玩家顯示名稱的唯一性現在為選擇性。
* 玩家連線至 Photon Cloud 時，玩家顯示名稱會以 Photon「Nickname」的形式傳回。

**Server API**

* `RedeemCouponRequest`
  * 新增：`CharacterId`
  * 應接收該項目之角色的選擇性識別碼。如果為 `null`，則會將項目新增給玩家。
* **UpdatePlayerStatisticsRequest**
  * 新增：`ForceUpdate`
    * 指出是否應設定所提供的統計資料，而不論該統計資料上設定的彙總方法為何。預設值為 `false`。

### 新的 PlayStream 事件

* `Player_photon_session_authenticated`
* `Title_secret_key_changed`
* `Title_api_settings_changed`

### SDK 變更

* [CSharpSDK](https://github.com/PlayFab/CSharpSDK) 特定變更：
  * [CSharp 重大升級](https://blog.playfab.com/blog/csharpsdk-upgrade/)

## 161031

日期：2016 年 10 月 30 日

~~**Unreal Blueprints Hotfix 版本**~~ (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK))

* ~~UnrealBlueprintSDK **升級警告**：Android 與 PlayFab「SourceType」列舉之間發生命名衝突。因此，我們必須重新命名此藍圖列舉。這會中斷任何 [Client/GetStoreItems](xref:titleid.playfabapi.com.client.title-widedatamanagement.getstoreitems) 或 [Admin/GetStoreItems](xref:titleid.playfabapi.com.admin.title-widedatamanagement.getstoreitems) PlayFab API 節點。在編輯器中的升級程序是刪除並重新建立每個受影響的藍圖節點。~~

* ~~UnrealBlueprintSDK 特定變更：~~
  * ~~修正某些錯誤無法正確回報的次要錯誤~~
  * ~~修正導致無法建置 Android 版本的名稱衝突 (ESourceType)~~

## 161017

日期：2016 年 10 月 16 日

### 淘汰變更

* `Client/GetUserCombinedInfo` 已從 `Proposed` 轉換為 `Deprecated`，這表示大多數使用它的 SDK 現在都會擲回錯誤。請轉換至 [Client/GetPlayerCombinedInfo](xref:titleid.playfabapi.com.client.accountmanagement.getplayercombinedinfo)。
* 此修補程式說明中已淘汰的 API：[160822](#160822) 已依據此部落格文章從已淘汰轉換為過時：[Deprecation Visibility](https://playfab.com/blog/deprecation-visibility/)，因此這些 API 已從最新版本的 SDK 中移除。如果您更新 SDK，現在必須轉換至新的替代 API。
* `Admin UserCredentials` 物件中的 `Password` 已淘汰。您不再需要知道使用者的密碼即可呼叫 `Admin/ResetUsers` 方法。

### UnitySdk 中斷性變更

* [UnitySdk](https://github.com/PlayFab/UnitySDK)
  * 如果您對 PlayFab API 模型類型使用反映，則必須將反映邏輯從屬性轉換為欄位 (請參閱下一節中的 UnitySdk 特定變更)。

### API 變更

* **新的 PlayStream 事件：**
  * ~~`gamelobby_started`~~ (已更新：此項目已淘汰。請參閱 [Lobby-Matchmaking-Messages](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/lobby-and-matchmaking-real-time-messages.md))
  * ~~`gamelobby_ended`~~(已更新：此項目已淘汰。請參閱 [Lobby-Matchmaking-Messages](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/lobby-and-matchmaking-real-time-messages.md))
  * [Client/AttributeInstall](xref:titleid.playfabapi.com.client.advertising.attributeinstall) 要求已淘汰 `Android_Id` 並轉換為 `Adid`。所有 SDK 都更新了部分內部登入攔截程序以因應此變更。這不是中斷性變更，因為此處本來就預期使用 Google-AdvertisingId (Adid)，而在此使用 Android DeviceId 無法正常運作。此變更是為了清楚明確與一致性
  * 對於 GitHub 附加元件，CloudScript 的修訂不再立即上線。而是會建立新的修訂，再由您透過 Game Manager 使其上線
  * 此文件中所述的預設 `helloWorld` CloudScript 函式：[CloudScript 快速入門](https://docs.xbox.com/zh-TW/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart.md)已過時。已更新文件，使其更貼近目前的版本 (這只與建立新遊戲相關)

### API Server 錯誤修正

* 修正 [Server/ExecuteCloudScript](xref:titleid.playfabapi.com.server.server-sidecloudscript.executecloudscript) 中的 500 錯誤：PlayFabId 現在是必要參數。先前，如果未提供 PlayFabId，API 會擲回錯誤。
* 修正 [Server/GetSharedGroupData](xref:titleid.playfabapi.com.server.sharedgroupdata.getsharedgroupdata) 中的 500 錯誤：SharedGroupId 現在是必要參數。先前，如果未提供 SharedGroupId，API 會擲回錯誤。
* 修正 [Server/AddSharedGroupMembers](xref:titleid.playfabapi.com.server.sharedgroupdata.addsharedgroupmembers) 中的 500 錯誤：PlayFabIds 現在是必要參數。先前，如果未提供 PlayFabIds，API 會擲回錯誤。
* 修正 [Server/RemoveSharedGroupMembers](xref:titleid.playfabapi.com.server.sharedgroupdata.removesharedgroupmembers) 中的 500 錯誤：PlayFabIds 現在是必要參數。先前，如果未提供 PlayFabIds，API 會擲回錯誤。
* 修正 [Server/DeleteSharedGroup](xref:titleid.playfabapi.com.server.sharedgroupdata.deletesharedgroup) 中的 500 錯誤：SharedGroupId 現在是必要參數。先前，如果未提供 SharedGroupId，API 會擲回錯誤。

### LuaSDK 特定變更

* [LuaSDK](https://github.com/PlayFab/LuaSDK)
  * 改善 Corona 與 Defold 的識別標頭。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 將模型屬性轉換為欄位，使其在 Unity Inspector 中顯示得更好 (在適用的情況下)。
  * 修正一個錯誤：如果 CloudScript 函式傳回基本型別，現在會正確還原序列化並以 FunctionResult 傳回。先前會是 null。
  * 修正 PaperTrail 套件：[UnityPlayFabPaperTrail.unitypackage](https://github.com/PlayFab/UnitySDK/blob/master/Packages/UnityPlayFabPaperTrail.unitypackage)

### SDKGenerator 特定變更

* [SDKGenerator](https://github.com/PlayFab/SDKGenerator)
  * [SDKGenerator](https://github.com/PlayFab/SDKGenerator) 還可以從 Api-Server 或 GitHub 讀取 `Api-Specs`，讓客戶能以更少的步驟和相依性，建置與 PlayFab API 伺服器同步的自訂 SDK。

## 161003

日期：2016 年 10 月 2 日

### API 變更

* **新的 API**
  * Client/GetTime
  * Server/GetTime
  * Google OAuth 升級至 v3
  * 改善我們文件網站上的搜尋結果：[PlayFab 文件](../index.yml)。

### SDK 全域變更

* 修訂 SDK 中範例的文件，並更清楚地說明如何使用我們的測試工具：
  * [https://github.com/PlayFab/SDKGenerator/blob/master/JenkinsConsoleUtility/testTitleData.md](https://github.com/PlayFab/SDKGenerator/blob/master/JenkinsConsoleUtility/testTitleData.md)
  * [https://github.com/PlayFab/SDKGenerator/blob/master/JenkinsConsoleUtility/readme.md](https://github.com/PlayFab/SDKGenerator/blob/master/JenkinsConsoleUtility/readme.md)

### LuaSdk 特定變更

* [LuaSdk](https://github.com/PlayFab/LuaSDK)
  * Corona 外掛程式現在可從 Corona Marketplace 取得。
  * 用戶端外掛程式：[https://marketplace.coronalabs.com/plugin/playfab-client](https://marketplace.coronalabs.com/plugin/playfab-client)
  * 伺服器外掛程式：[https://marketplace.coronalabs.com/plugin/playfab-server](https://marketplace.coronalabs.com/plugin/playfab-server)
  * 組合外掛程式：[https://marketplace.coronalabs.com/plugin/playfab-combo](https://marketplace.coronalabs.com/plugin/playfab-combo)
  * Corona 讀我檔案：[https://github.com/PlayFab/LuaSdk/tree/master/Corona](https://github.com/PlayFab/LuaSdk/tree/master/Corona)

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * [UnitySDK](https://github.com/PlayFab/UnitySDK) V0 存放庫即將淘汰。所有人都應更新至我們下載頁面上提供的 UnitySDK V2。
  * `IDFA` 和 `AdvertisingId` 可在 Unity 5.5 Beta 版本上正常運作。
  * 傳回基本型別 (例如整數) 的 CloudScript 函式可正確還原序列化
  * Unity 壓縮功能的次要改善。現在可以安全地在 PlayFabSharedSettings 可編寫指令碼物件中啟用壓縮。

### WindowsSDK 特定問題

* 此存放庫發佈的 .lib 檔案現在已超過 GitHub 的檔案大小上限。
* 最新版本沒有更新的 lib 檔案，我們已開始研究替代方案。

## 160919

日期：2016 年 9 月 18 日

### 付款相關的新 API

* 我們正在擴充 Payments API，以納入退款和爭議購買的標準方式。
* [Admin/RefundPurchase](xref:titleid.playfabapi.com.admin.playerdatamanagement.refundpurchase)
* [Admin/ResolvePurchaseDispute](xref:titleid.playfabapi.com.admin.playerdatamanagement.resolvepurchasedispute)
  **已將數個好友相關 API 從 Client 複製到 Server：**

  * [Server/GetFriendLeaderboard](xref:titleid.playfabapi.com.server.playerdatamanagement.getfriendleaderboard)
  * [Server/AddFriend](xref:titleid.playfabapi.com.server.friendlistmanagement.addfriend)
  * [Server/GetFriendsList](xref:titleid.playfabapi.com.server.friendlistmanagement.getfriendslist)
  * [Server/RemoveFriend](xref:titleid.playfabapi.com.server.friendlistmanagement.removefriend)

### Server API 配對功能的小幅改善

* ~~`Server/RegisterGame`~~
* ~~`Server/DeregisterGame`~~
* ~~`Server/SetGameServerInstanceTags`~~
* ~~`Server/RefreshGameServerInstanceHeartbeat`~~
  (已更新：此項目已淘汰。請參閱[伺服器](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/servers/index.md))

### Cocos2d-xSDK 特定變更

* [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)
  * Cocos 範例已更新，因而觸發範例專案的重建。由於只套用了外觀上的變更，這應該仍會如先前設計般運作。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * Unity 遊戲伺服器的次要修正，以反映 API 變更。

### JavaScriptSDK 特定變更

* [JavaScriptSDK](https://github.com/PlayFab/JavaScriptSDK)
  * 測試範例已更新為使用 CDN。

## 160912

日期：2016 年 9 月 11 日

### Unity 和 CSharp 升級警告

* [160822](#160822) 中所述的淘汰警告已生效。在可能的情況下，已淘汰的 API 現在會擲回編譯器錯誤。
  同樣地，我們已從主要文件中篩選掉這些 API 的文件。

### API 變更

* **新的 API**
  * `Admin/GetAllActionGroups`
  * `Server/GetAllActionGroups`

### LuaSDK 特定變更

* [LuaSDK](https://github.com/PlayFab/LuaSDK)
  * 漸進式 Corona 支援：有新的/過渡性的 zip 檔案可納入 Corona 專案中。正式的 Corona 外掛程式即將推出。

## 160829

日期：2016 年 8 月 28 日

### API 變更

* **新的 API**
  * [Client/GetPlayerTags](xref:titleid.playfabapi.com.client.playstream.getplayertags)
  * [Server/AddPlayerTag](xref:titleid.playfabapi.com.server.playstream.addplayertag)
  * [Server/GetPlayerTags](xref:titleid.playfabapi.com.server.playstream.getplayertags)
  * [Server/RemovePlayerTag](xref:titleid.playfabapi.com.server.playstream.removeplayertag)
  * [Admin/AddPlayerTag](xref:titleid.playfabapi.com.admin.playstream.addplayertag)
  * [Admin/GetPlayerTags](xref:titleid.playfabapi.com.admin.playstream.getplayertags)
  * [Admin/RemovePlayerTag](xref:titleid.playfabapi.com.admin.playstream.removeplayertag)

我們推出了區段標籤，可讓您直接將玩家放入特定區段。您現在可以為每位玩家新增一或多個區段標籤。接著，在建立區段時，您可以根據區段標籤來定義區段。

區段標籤的其中一個預期用途是與外部分析提供者 (例如 Appuri) 整合。外部分析提供者可以執行自己的進階區段劃分，例如「可能流失」，然後在符合該區段的玩家上設定標籤。
已發佈所有目前的淘汰變更。如需詳細資訊，請參閱我們的部落格文章：[https://playfab.com/deprecation-visibility/](https://playfab.com/deprecation-visibility/)

### Cocos2d-xSDK 特定變更

* [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)
  * 特別感謝 Forest Ring Games 的 Max Muthig 提供下列更新：
    * 新增對 Lambda 回呼函式的支援 (先前只允許靜態函式)。

### PostmanCollection 特定變更

* [PostmanCollection](https://github.com/PlayFab/PostmanCollection)
  * 為所有 API 方法新增標頭，以協助我們的伺服器追蹤 SDK 使用量。(所有其他 SDK 上已存在此標頭)。

### UnitySDK 特定變更

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

  * Unity Editor Extensions 現已推出初始公開 Beta 版本。此外掛程式提供易於使用的介面，用於設定和管理 PlayFab SDK。我們鼓勵所有 Unity 開發人員試用 EdEx。立即註冊並開始開發。
  * 新增 `ExecuteCloudScript` 的替代實作，會使用泛型參數，自動將 `FunctionResult` 剖析為目標類型。
  * 改善 API 方法中的失敗案例：部分原本會擲回例外狀況的案例，現在會正確回報給錯誤回呼 (例如沒有網際網路連線時的 Web 要求)，而其他案例則會向錯誤回呼回報更完善的資訊。

~~**UnrealBlueprintSdk 特定變更：**~~ (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK))

* ~~修正要求中含有選擇性清單欄位的 API 無法將要求正確發佈至伺服器的問題。(例如 GetPlayerStatistics)~~

### SDKGenerator 特定變更

* [SDKGenerator](https://github.com/PlayFab/SDKGenerator)
  * 更新文件和範例專案，以便為 PlayFab 使用者更完善地說明如何為我們的 API 建立自己的 SDK。

## 160822

日期：2016 年 8 月 21 日

### 全域升級警告

部分 SDK 已針對已淘汰的 API 加入警告。
如果您看到這些警告，請盡快解決，並移轉至指示的替代 API。
其中許多 API 將在接下來的幾個月內從 SDK 中移除。
[這裡](https://blog.playfab.com/blog/deprecation-visibility/)有相關的部落格文章。 

### 淘汰通知

* **Admin 欄位**

  * `UpdateCloudScriptRequest.Version`

* **Client 欄位**

  * `GetPlayFabIDsFromSteamIDsRequest.SteamIDs`
  * `SendAccountRecoveryEmailRequest.PublisherId`
  * `SteamPlayFabIdPair.SteamId`

* **Client 資料類型**

  * `GetCloudScriptUrlRequest`
  * `GetCloudScriptUrlResult`
  * `GetFriendLeaderboardAroundCurrentUserRequest`
  * `GetFriendLeaderboardAroundCurrentUserResult`
  * `GetLeaderboardAroundCurrentUserRequest`
  * `GetLeaderboardAroundCurrentUserResult`
  * `GetUserCombinedInfoRequest`
  * `GetUserCombinedInfoResult`
  * `GetUserStatisticsRequest`
  * `GetUserStatisticsResult`
  * `LogEventRequest`
  * `LogEventResult`
  * `UpdateUserStatisticsRequest`
  * `UpdateUserStatisticsResult`

* **Client API**

  * `GetUserCombinedInfo`
  * `GetFriendLeaderboardAroundCurrentUser`
  * `GetLeaderboardAroundCurrentUser`
  * `GetUserStatistics`
  * `UpdateUserStatistics`
  * `LogEvent`
  * `GetCloudScriptUrl`
  * `RunCloudScript`

* **Server 欄位**

  * `GetPlayFabIDsFromSteamIDsRequest.SteamIDs`
  * `SteamPlayFabIdPair.SteamId`

* **Server 資料類型**

  * `GetUserStatisticsRequest`
  * `GetUserStatisticsResult`
  * `LogEventRequest`
  * `LogEventResult`
  * `UpdateUserStatisticsRequest`
  * `UpdateUserStatisticsResult`

* **Server API**

  * `GetUserStatistics`
  * `UpdateUserStatistics`
  * `LogEvent`

### API 變更

* **新的 API**
  * [Admin/BanUsers](xref:titleid.playfabapi.com.admin.accountmanagement.banusers)
  * [Admin/GetUserBans](xref:titleid.playfabapi.com.admin.accountmanagement.getuserbans)
  * [Admin/RevokeAllBansForUser](xref:titleid.playfabapi.com.admin.accountmanagement.revokeallbansforuser)
  * [Admin/RevokeBans](xref:titleid.playfabapi.com.admin.accountmanagement.revokebans)
  * [Admin/UpdateBans](xref:titleid.playfabapi.com.admin.accountmanagement.updatebans)
  * [Admin/DeleteStore](xref:titleid.playfabapi.com.admin.title-widedatamanagement.deletestore)
  * [Server/BanUsers](xref:titleid.playfabapi.com.server.accountmanagement.banusers)
  * [Server/GetUserBans](xref:titleid.playfabapi.com.server.accountmanagement.getuserbans)
  * [Server/RevokeAllBansForUser](xref:titleid.playfabapi.com.server.accountmanagement.revokeallbansforuser)
  * [Server/RevokeBans](xref:titleid.playfabapi.com.server.accountmanagement.revokebans)
  * [Server/UpdateBans](xref:titleid.playfabapi.com.server.accountmanagement.updatebans)
  * [Server/GetRandomResultTables](xref:titleid.playfabapi.com.server.playeritemmanagement.getrandomresulttables)

* **新的 PlayStream 事件**

  * [player\_tag\_added](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/player-tag-added.md)
  * [player\_tag\_removed](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/player-tag-removed.md)
  * [title\_catalog\_updated](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/CatalogV1/title-catalog-updated.md)
  * [title\_store\_updated](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/CatalogV1/title-store-updated.md)

### 全域 SDK 變更

* SDK 隨附的範例專案已全部更新，不再使用已淘汰的 API。
* 數個 SDK 具有描述 API 已淘汰元素的編譯器警告和/或註解。
* [PostmanCollection](https://github.com/PlayFab/PostmanCollection) 的內部格式略有變更。同時載入多個未來版本的 [PostmanCollection](https://github.com/PlayFab/PostmanCollection) 會較不方便 (您會收到有關重複 ID 的警告)。

### ActionScriptSDK 特定變更

* [ActionScriptSDK](https://github.com/PlayFab/ActionScriptSDK)
  * 將範例專案中的 Adobe AirSdk 從版本 18 更新至 22。

## 160815

日期：2016 年 8 月 14 日

### Unreal 升級警告

升級 Unreal 4.12 所需的語法變更
ZKShao 在協助解決問題的提取要求中說明得最清楚：`<https://github.com/PlayFab/UnrealCppSdk/pull/32>`

### API 變更

* 次要文件更新。

* **新的 PlayStream 事件：**

  * [player\_statistic\_deleted](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Leaderboards/player-statistic-deleted.md)
  * [player\_unlinked\_account](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/player-unlinked-account.md)

~~**UnrealCppSdk 和 UnrealBlueprintSdk 特定變更：**~~ (已更新：這些 SDK 已淘汰。如需新的 Unreal SDK，請參閱 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK))

* ~~已更新以支援 Unreal 4.12~~
* ~~遺憾的是，由於需求衝突，這必須停止支援 Unreal 4.11.x~~
* ~~仍維持對 Unreal 4.9 的支援~~

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 即時連線的 Pre-Alpha 版本：使用 SignalR 讓您的自訂遊戲伺服器訂閱即時 PlayStream 事件
  * 遊戲伺服器可以開始測試向 PlayStream 事件註冊回呼，並即時做出反應
  * PlayFabSDK 在 Android 上不再需要權限。(WP8 和 iOS 仍需要在建置設定中啟用網際網路)
  * 逐步為過時的 API 加入淘汰警告。
  * 這些警告日後會變成淘汰錯誤，最終將從 SDK 中移除。
  * 部分壓縮相關的錯誤修正
  * PlayFabSdk 現在可在 Unity 5.0 中運作
  * 修正特定較舊 Unity 版本上的特定裝置問題，並擴大內部測試
  * 更新 UUnit 測試架構，使其在非同步測試逾時時正確顯示
  * 我們的資產套件組合是以 Unity 5.4 建置

## 160801

日期：2016 年 7 月 31 日

### API 變更

* **新的 API**

  * [RemoveVirtualCurrencyTypes](xref:titleid.playfabapi.com.admin.title-widedatamanagement.removevirtualcurrencytypes)
  * [GetAllSegments](xref:titleid.playfabapi.com.admin.playstream.getallsegments)
  * [GetPlayerSegments](xref:titleid.playfabapi.com.admin.playstream.getplayersegments)
  * [GetPlayersInSegment](xref:titleid.playfabapi.com.admin.playstream.getplayersinsegment)
  * [GetPlayerCombinedInfo](xref:titleid.playfabapi.com.server.playerdatamanagement.getplayercombinedinfo)
  * [GetAllSegments](xref:titleid.playfabapi.com.server.playstream.getallsegments)
  * [GetPlayerSegments](xref:titleid.playfabapi.com.server.playstream.getplayersegments)
  * [GetPlayersInSegment](xref:titleid.playfabapi.com.server.playstream.getplayersinsegment)

* **新的 PlayStream 事件**

  * ~~\[session\_started]~~(已更新：此項目已淘汰。請參閱 [Lobby-Matchmaking-Messages](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/lobby-and-matchmaking-real-time-messages.md))
  * ~~\[session\_ended]~~(已更新：此項目已淘汰。請參閱 [Lobby-Matchmaking-Messages](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/lobby-and-matchmaking-real-time-messages.md))
  * 次要文件更新。

## 160726

日期：2016 年 7 月 25 日

### UnitySDK Hotfix 變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 修正較舊 Unity 版本上的特定裝置問題。
  * 修正特定 `AdminApi` 模型類別被標記為 `PlayFabResultCommon` 而非 `PlayFabRequestCommon` 的問題。
  * 已知問題：使用 PlayFab UnitySdk 時，Google advertisingID 和 iOS IDFA 在 5.3 之前的 Unity 版本上不再正確歸因。
  * 最簡單的修正方式是升級您的 Unity3D 版本，但我們會嘗試在 SDK 的後續版本中還原此功能。

## 160725

日期：2016 年 7 月 24 日

### API 變更

* **新的 PlayStream 事件**

  * [display\_name\_filtered](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Partner/display-name-filtered.md) (文件即將推出)。

  * 更新部分 API 範例。

  * 大量次要文件更新。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 推出 `PlayFabRequestCommon base-class`，可對傳遞至 API 的要求物件進行編譯時期類型檢查 (除非使用者使用非標準的要求物件，否則這應該不會影響任何使用者)。

  * 修正部分使用者回報的啟動時 null 參考錯誤。

  * 修正部分使用者回報的 `PlayFabSharedSettings` `ScriptableObject` 中 `ProductionEnvironmentUrl` 的問題。

## 160721

日期：2016 年 7 月 20 日

### UnitySDK Hotfix 變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * Unity 4.7 可再次運作 (在該版本的限制範圍內)

  * 修正社群中許多人注意到的一系列小型但高度可見的問題。

  * UnitySDK V2 先前承諾會完整支援 Windows Phone/Universal (以及主機等其他平台)。我們很高興地宣布，所有已知平台上的所有已知問題終於都已修正，PlayFab UnitySdk 應該可以在任何地方運作。

  * 由於 Unity 中非預期的副作用，我們無法將 `HideAndDontSave` 旗標套用至 PlayFab Http 物件。[詳細資訊](https://answers.unity.com/questions/1218422/hideanddontsave-disables-ondestroy.html)。

  * 我們新增了一組反映的擴充函式，可在可能的情況下，讓標準 C# 和 .NET Core C# 以相同的程式碼行執行相同的動作。此擴充功能並非用來完整解決這些平台之間所有可能的反映不一致問題。

## 160714

日期：2016 年 7 月 13 日

### UnitySDK 升級警告

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 我們已發佈 [UnitySDK](https://github.com/PlayFab/UnitySDK) 的新主要修訂版本。(更新：升級指南已過時)。

### API 變更

* 現在透過 Admin Api 授與項目時，您可以在項目上設定 CustomData：[GrantItemsToUsers](xref:titleid.playfabapi.com.admin.playeritemmanagement.grantitemstousers)，具體而言是：[ItemGrant](xref:titleid.playfabapi.com.admin.playeritemmanagement.grantitemstousers#itemgrant)。

* **Twitch 登入整合！以及 API：**
  * [LoginWithTwitch](xref:titleid.playfabapi.com.client.authentication.loginwithtwitch)
  * [LinkTwitch](xref:titleid.playfabapi.com.client.accountmanagement.linktwitch)
  * [UnlinkTwitch](xref:titleid.playfabapi.com.client.accountmanagement.unlinktwitch)
  * [GetPlayFabIDsFromTwitchIDs](xref:titleid.playfabapi.com.client.accountmanagement.getplayfabidsfromtwitchids)

* **新的 PlayStream 事件：**
  * [title\_exceeded\_limit](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Extension/title-exceeded-limit.md)
  * [title\_limit\_changed](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Extension/title-limit-changed.md)
  * [title\_requested\_limit\_change](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Title/title-requested-limit-change.md)

### LumberyardSDK 特定變更

* 已更新至 Lumberyard 1.3

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * [UnitySdk](https://github.com/PlayFab/UnitySDK) 的新主要修訂版本即將發佈 (希望是今天)。
  * 原始的 UnitySdk 在有限的時間內可於此處取得 \[更新：已移除舊連結]。
  * [UnitySdk](https://github.com/PlayFab/UnitySDK) 第二版目前可於此處取得：UnitySDKV2Beta \[更新：已移除舊連結]，並將很快成為新的 [UnitySdk](https://github.com/PlayFab/UnitySDK) \[更新：已完成]。

## 160705

日期：2016 年 7 月 4 日

### API 變更

* **新的 API**
  * [GetPlayerCombinedInfo](xref:titleid.playfabapi.com.client.accountmanagement.getplayercombinedinfo)
  * 大量更新的描述。
  * 更新所有登入呼叫，可選擇性地傳回 [GetPlayerCombinedInfo](xref:titleid.playfabapi.com.client.accountmanagement.getplayercombinedinfo#getplayercombinedinforesultpayload) 結果。
  * `GetUserCombinedInfo` API 即將淘汰，改用 [GetPlayerCombinedInfo](xref:titleid.playfabapi.com.client.accountmanagement.getplayercombinedinfo)。

### UnitySDK 特定變更

* 還原使用 `PlayFabSettings.RequestType = WebRequestType.UnityWww` 進行 API 要求時的 GZip 壓縮模式；

* 在 `SimpleJson` 中新增 `JsonProperty` 屬性，支援欄位/屬性的替代命名，以及在序列化的 JSON 中省略 null。

* 使用預設 PlayFab `SimpleJson` 策略時，TimeSpan 會序列化為以秒為單位的浮點數。先前它們會序列化為結構，而 API 或任何跨平台選項都不支援結構。

* 在 [https://github.com/PlayFab/UnitySDK/blob/master/V2UPGRADE.md](https://github.com/PlayFab/UnitySDK/blob/master/V2UPGRADE.md) 上線之前，不支援使用 Mono2x 模式建置的特定平台 (例如：主機、iOS)。

* 在 [https://github.com/PlayFab/UnitySDK/blob/master/V2UPGRADE.md](https://github.com/PlayFab/UnitySDK/blob/master/V2UPGRADE.md) 上線之前，不支援 Windows Universal。

* 如需詳細資訊，請參閱此部落格文章：[https://blog.playfab.com/blog/new-and-improved-unity-SDK-beta-preview](https://blog.playfab.com/blog/new-and-improved-unity-SDK-beta-preview)
  (獨立版本和 Android 可正常運作，且所有選項都受支援)

* 所有可使用 IL2CPP 的平台在該模式下都受支援。

* 此版本最初推出時有一個問題，導致壓縮無法一致地運作。此問題已於 7 月 8 日以 Hotfix 修正。在此日期之前的初始下載可能會有壓縮問題，可透過更新或停用壓縮來解決：(PlayFabSettings.CompressApiData = false;)

## 160627

日期：2016 年 6 月 26 日

### UnitySDK 升級警告

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 將 `PlayFab.Internal.Util` 重新命名為 `PlayFab.Internal.PlayFabUtil`。「Util」是常見的名稱，存在於許多專案的根層級，因而導致這些客戶發生名稱衝突。

  * 更新 PlayFab-UnitySdk 時，如果您使用 PlayFab 的 SimpleJson 實作，可能會看到一些淘汰警告。您可以在方便時解決這些警告。

### API 變更

* **新的 Admin API**

  * [GetTitleInternalData](xref:titleid.playfabapi.com.admin.title-widedatamanagement.gettitleinternaldata)
  * [SetTitleInternalData](xref:titleid.playfabapi.com.admin.title-widedatamanagement.settitleinternaldata)

* **新的 PlayStream 事件**

  * [character\_consumed\_item](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Character/character-consumed-item.md)
  * [character\_created](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/character-created.md)
  * [character\_inventory\_item\_added](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Character/character-inventory-item-added.md)
  * [character\_statistic\_changed](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Leaderboards/character-statistic-changed.md)
  * [character\_vc\_item\_purchased](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Character/character-vc-item-purchased.md)
  * [character\_virtual\_currency\_balance\_changed](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Character/character-virtual-currency-balance-changed.md)
  * [player\_redeemed\_coupon](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Player/player-redeemed-coupon.md)

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 已知問題：Windows 市集應用程式和非 IL2CPP 建置選項尚無法運作。請持續關注有關這些問題以及我們新存放庫的部落格文章：UnitySDKV2Beta \[更新：已移除舊連結]。
  * 我們發現與核心 `UnityEngine` DLL 的名稱衝突，具體而言是名為 `SimpleJson` 的空白命名空間。因此，我們必須再次重新命名並重新組織 JSON 類別。深感抱歉。

## 160613

日期：2016 年 6 月 12 日

### 全域 SDK 升級警告

* PlayFabSettings 和 PlayFabVersion：已將這些檔案及其內容合併至 PlayFabSettings。
* 如果您先前參考了 PlayFabVersion 變數，請更新為 PlayFabSettings 中的類似變數。

### API 變更

* **新的 API**

  * ~~**SetGameServerInstanceData**~~(已更新：此項目已淘汰。請參閱[伺服器](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/servers/index.md))
* **API 的錯誤修正：**
  * ~~**Server/SetGameServerInstanceState**~~(已更新：此項目已淘汰。請參閱[伺服器](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/servers/index.md))
  * ~~**Client/GetCurrentGames**~~(已更新：此項目已淘汰。請參閱[伺服器](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/servers/index.md))

### SDK 全域變更

* 我們自 2016 年 3 月起已淘汰 `RunCloudScript`，且即將從 SDK 中移除。請盡快轉換至 [ExecuteCloudScript](xref:titleid.playfabapi.com.client.server-sidecloudscript.executecloudscript)。

* 請持續關注一篇關於我們稱為 Jenkernaught 的內部測試系統的部落格文章。我們的範例專案包含一些以更深入測試為導向的變更，以改善 SDK 的穩定性和可靠性。部分具體內容：

* 由於 RunCloudScript 已淘汰，已將 CloudScript 的所有測試和範例更新為 [ExecuteCloudScript](xref:titleid.playfabapi.com.client.server-sidecloudscript.executecloudscript)。

* 已將成功登入的所有測試和範例更新為 `LoginWithCustomID`，讓內部測試更容易。

### Cocos2d-xSDK 特定變更

* [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)
  * `MultitypeVar` 可包含 `PlayFabBaseModel`，以用於撰寫要求物件。它仍無法接收任意 JSON 物件作為結果。
  * 初始版本化發行。

~~**UnrealBlueprintSdk 特定變更：**~~ (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK))

* ~~從大量標頭註解中移除版本資訊，以避免大量無意義的簽入 (因此，這是最後一次無意義的簽入)~~
* ~~現在會提供先前缺少的 HTTP 標頭。~~

## 160606

日期：2016 年 6 月 5 日

### 全域 SDK 升級警告

為了讓所有 SDK 保持一致，我們將 `sdkRevision` 變數重新命名為 `sdkVersion` ([ActionScriptSDK](https://github.com/PlayFab/ActionScriptSDK)、[JavaSDK](https://github.com/PlayFab/JavaSDK)、[UnitySdk](https://github.com/PlayFab/UnitySDK))。
如果您先前存取的是 `sdkRevision`，請改用 `sdkVersion`。

### API 變更

* 部分文件更新，並改善錯誤通知。

### SDK 全域變更

* 朝淘汰 `RunCloudScript` 又邁進了幾步，因此客戶應規劃將上線專案移轉至 [ExecuteCloudScript](xref:titleid.playfabapi.com.client.server-sidecloudscript.executecloudscript)。

* 在內部，我們改善所有 SDK 多平台測試的工作已完成一半。[SDKGenerator](https://github.com/PlayFab/SDKGenerator) 使用者可能會看到 `Jenkernaught` 和 `buildIdentifier` 的參考。`Jenkernaught` 是實現此改善平台測試之技術的代號。`buildIdentifier` 是所有 SDK 中的新變數，指出產生特定 SDK 版本的特定 PlayFab-Jenkins 作業。

* 將會有一篇部落格文章說明 `Jenkernaught` 的用途，以及此處省略的更詳細測試架構變更，敬請持續關注。

### ActionScriptSDK 特定變更

* [ActionScriptSDK](https://github.com/PlayFab/ActionScriptSDK)
  * 範例/測試專案中與 `Jenkernaught` 相關的 `ASyncUnitTest` 架構變更。

### CSharpSDK 特定變更

* [CSharpSDK](https://github.com/PlayFab/CSharpSDK)
  * 為了與 UnitySDK 一致，我們將 JSON 特定程式碼從 `PlayFabSettings` 移至 `PlayFabUtil`。我們也擴充了 `PlayFabUtil`，使其功能更接近 UnitySDK。
  * 改善其餘 `PlayFabSettings` 選項中的文件，使其更清楚。
  * 範例/測試專案中與 `Jenkernaught` 相關的 Unit 架構變更。

### JavaScriptSDK 特定變更

* [JavaScriptSDK](https://github.com/PlayFab/JavaScriptSDK)
  * 在 `PlayFabClientSDK: IsClientLoggedIn()` 中新增公用程式函式。使用此函式來判斷此狀況。
  * 範例/測試專案中與 `Jenkernaught` 相關的次要測試變更。

### NodeSDK 特定變更

* [NodeSDK](https://github.com/PlayFab/NodeSDK)
  * 在 `PlayFabClientSDK: IsClientLoggedIn()` 中新增公用程式函式。使用此函式來判斷此狀況。
  * 範例/測試專案中與 `Jenkernaught` 相關的次要測試變更。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 修正變更場景時 PlayFab API 呼叫停止運作的重大錯誤。
  * 調整時間戳記格式的預設值，使其與其他 PlayFab SDK 一致。
  * Unity 5.3 或更新版本在 Windows-Phone 和 Windows-Universal 上仍有問題，我們希望能盡快修正。

## 160523

日期：2016 年 5 月 22 日

### 全域 SDK 升級警告

多個儲存版本化資料的 API (UserData、CharacterData 等) 的資料類型從 int 變更為 uint。這需要部分使用者在我們的 API 先前不一致之處移除/修改某些轉換。部分開發人員可能需要將某些區域變數從 int 變更為 uint。

~~**UnrealBlueprintSdk 升級警告：**~~ ~~Xcode 與部分 PlayFab 列舉之間發生命名衝突。因此，我們必須再次修訂藍圖列舉，這會中斷所有使用列舉的 PlayFab API 節點。在編輯器中的升級程序是刪除並重新建立每個受影響的藍圖節點 (如果受到影響，它們會擲回編輯器內編譯器警告)。~~ (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK))

### API 變更

* 部分 `DataVersion` 變數使用不一致的資料類型 (在各種 API 中為 int 和 uint)。為了一致性，我們已將這些全部變更為 uint。

* 為配對相關 API 新增更多選項。

* 配對器現在接受額外參數 (`StartNewIfNoneFound`)，可讓遊戲決定在配對過程中找不到結果時，是否應啟動新的伺服器。根據預設，`StartNewIfNoneFound` 為 `true`，表示如果找不到符合需求的工作階段，就會建立新的工作階段。這可讓採用技能型配對的遊戲有機會「放寬」配對需求，讓技能等級位於鐘形曲線兩端的玩家能更快進入遊戲。

* 使用 `GameInstanceState` 更新自訂遊戲伺服器邏輯，此狀態會決定遊戲工作階段是否可供配對。`Closed` 的遊戲無法用於配對，讓開發人員可以建立專屬於某群玩家的遊戲工作階段，並防止在遊戲工作階段進行中於開始後加入。根據預設，遊戲伺服器會以 Open 狀態啟動。

* -~~新的 API：伺服器可以使用 `SetGameServerInstanceState` 呼叫來設定其狀態，並且已在呼叫 `ModifyMatchmakerGameModes` 時使用的 `GameModeInfo` 中新增 `StartOpen`，以便指定遊戲模式中的工作階段以 `Open` (預設值) 或 `Closed` 啟動。~~(已更新：此項目已淘汰。請參閱[伺服器](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/servers/index.md))

~~**UnrealBlueprintSdk 特定變更：**~~ (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK))

* ~~內部 SDK 更新，讓從 C++ 執行和處理 API 呼叫更容易。~~
* ~~新增內部測試套件，可在所有目標裝置上徹底驗證 PlayFab 功能。(僅限範例專案，不含核心外掛程式)~~
* ~~大量 C++ 程式碼清理，並改善記錄和警告。~~
* ~~解決 Blueprints 和 C++ 呼叫中多個同步 API 呼叫的並行問題。~~

## 160502

日期：2016 年 5 月 1 日

### 全域 SDK 升級警告

如果您先前設定了 `ConfirmationMessage` 和 `ForceLink` 欄位，請將其移除。

### API 變更

* 新的 Admin API：
  * ~~**SetStoreSegmentOverrides**~~ (更新：此 API 已移除)
  * 部分已淘汰和內部欄位不再隨 SDK 發佈：ConfirmationMessage 和 ForceLink。

~~**UnrealBlueprintSdk 特定變更：**~~ (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK))

* ~~修訂讀我檔案和範例專案，以使用較簡單的登入程序，以及更簡單的新 ExecuteCloudScript 方法。~~
* ~~發生 API 錯誤時，該錯誤的詳細資料會更精確地回報，並顯示更完善的偵錯資訊。~~
* ~~我們將移除 Unreal SDK 的「Beta」標記，它們現在是我們 SDK 系列的正式成員，享有完整支援與品質檢查。~~

## 160425

日期：2016 年 4 月 24 日

~~**UnrealBlueprintSdk 升級警告：** 許多具有列舉欄位的藍圖 API 呼叫必須更新為使用列舉下拉式清單。舊值將會遺失，必須重新設定。這會影響數十個 PlayFab 藍圖節點。~~ (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK))&#x20;

### API 變更

* 大量文件更新。
* 修正 `AndroidDevicePushNotificationRegistrationRequest` 中的錯字。
* 新的伺服器 API：
  * [EvaluateRandomResultTable](xref:titleid.playfabapi.com.server.playeritemmanagement.evaluaterandomresulttable)

### Cocos2d-xSDK 特定變更

* [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)
  * 全面翻新 Cocos SDK。
  * 新的測試架構，並轉換了內部 Http 功能。
  * Android、iOS 和 Win32 平台全都可以運作。
  * 許多其他小型修正與改善。

~~**UnrealBlueprintSdk 特定變更：**~~ (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK))

* ~~UnrealBlueprintSdk 的有限支援 Beta 期即將結束。因此，接下來幾個版本中可能會有一些潛在的中斷性變更。~~
* ~~Api 規格中有定義為列舉的資料欄位。先前，UnrealBlueprintSdk 將這些欄位顯示為任意字串，並預期使用者輸入正確的選項。此問題已修正。這些欄位全都已在藍圖中轉換為列舉下拉式清單。~~

## 160414

日期：2016 年 4 月 13 日

### API 變更

* PlayStream API 現已在 SDK 中提供。
* 部分文件修訂。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 更多自動化測試以改善 SDK 的穩定性 (以及部分相關的錯誤修正)
  * 具體而言，新增 PlayStream 測試，並讓所有 SDK 的測試更一致。

## 160328

日期：2016 年 3 月 27 日

### API 變更

* 對新的可重設排行榜和其他玩家統計資料調整進行次要的漸進式改善。

* 透過 Admin-API 上傳 CloudScript 的方式略有修訂。

* 持續在需要時修訂並定義 API 限制和超額定義。

* 從少數幾個從未使用該值的用戶端 API 文件中移除「PlayFabId」輸入。

* 大量次要文件更新。

* 新的 `ExecuteCloudScript` API，取代較舊的 `GetCloudScriptUrl+RunCloudScript` 模式。

* 這應該能讓新手使用者更容易正確呼叫 CloudScript。

### Cocos2d-xSDK 特定變更

* [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)
  * 已更新專案資料夾結構，使其在所有平台上保持一致。
  * 這修正了 iOS 建置無法匯入部分程式碼檔案的問題。
  * Cocos 現已在 Win32 和 iOS 上經過測試並可運作。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 修正導致 `ReadAllText` 函式發生錯誤的不一致 `#define` 選項。
  * 已知問題 (未解決)：使用 Player Setting Scripting Back end 選項 `Mono2x` 時，`SimpleJson` 無法正確序列化。在修正此問題之前，請盡可能使用 `IL2CPP`。
  * (為 PlayStation® 建置時可能也會出現類似問題。)

「PlayStation」是 Sony Interactive Entertainment Inc. 的註冊商標或商標。

## 160307

日期：2016 年 3 月 6 日

### API 變更

* 新增 `Server.GetPlayFabIDsFromSteamIDs`。

* 修正 `Server.GetPlayerStatistics` 中的次要錯誤。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 次要 SDK 重構，以便建置至多個目標。

### WindowsSDK 和 Cocos2d-xSDK 特定變更

* WindowsSDK 和 [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)
  * 次要 SDK 重構，以便建置至多個目標。
  * 重新命名數個類型，使其與其他 SDK 更一致。

### SDK 新增項目

* ~~Amazon 的 LumberyardSdk 現已推出！~~

## 160222

日期：2016 年 2 月 21 日

### API 變更

* 新增 `Server.GetPlayFabIDsFromSteamIDs`。

* 修正 `Server.GetPlayerStatistics` 中的次要錯誤。

* 修正 `Server.UpdatePlayerStatistics` 中的次要錯誤。

### CSharpSDK 特定變更

* [CSharpSDK](https://github.com/PlayFab/CSharpSDK)
  * 更新測試控管中的協助程式函式簽章。

  * 更新 Server CloudScript 協助程式類別。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 更新測試控管中的協助程式函式簽章。
  * 新增結構性變更，將我們的內部 JSON 序列化程式從 JSON.NET 切換為 SimpleJson (這是為了支援 Universal Windows 建置)。

## 160215

日期：2016 年 2 月 14 日

### API 變更

* 可重設排行榜和玩家統計資料現已上線。

* `GetPlayFabIDsFromSteamIDs` 可接受並傳回字串 ID，供無法處理 ulong 值的語言使用。

* 支援 Parse 移轉的次要變更。

* 次要文件調整。

## 160208

日期：2016 年 2 月 7 日

### API 變更

* `SteamID` 類型從 `Uint32` 更新為 `Uint64`。

* **新增的 API**
  * `server.UnlockContainerInstance`
  * `server.UnlockContainerItem`
  * `server.UnlockContainerItem`
  * `server.UnlockContainerInstance`

* 新增 `admin.StatisticResetIntervalOption`，以用於可重設排行榜。

### UnitySdk 特定變更

* [UnitySdk](https://github.com/PlayFab/UnitySDK)
  * 稍微修改了專案資料夾結構，這可能會導致部分檔案衝突。如需詳細資訊，請參閱此[論壇文章](https://community.playfab.com/questions/321/206711137-Best-way-to-update-the-PlayFab-Unity-SDK-.html)。

## 160201

日期：2016 年 1 月 31 日

### API 變更

* **新的 API**
  * `server.ConsumeItem`
  * SteamID 類型從 `Uint64` 更新為 `Uint32`。
  * `GetContentListResult` ItemCounts 從 `Int64` 更新為 `Int32`。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 新增事件回呼系統，用於監視 PlayFab API 要求和回應。

## 160125

日期：2016 年 1 月 24 日

### API 變更

* **新的 API**
  * `Client.GetPlayFabIDsFromKongregateIDs`
  * `Client.GetCharacterStatistics`
  * `Client.UpdateCharacterStatistics`
  * `Server.RevokeInventoryItem`
  * 修正 `PurchaseItem___` -> `PurchaseItem___` 中的錯字。
  * 更新 `UserAccountInfo` 以包含更多帳戶詳細資料。

~~**UnrealBlueprintSdk 特定變更：**~~ (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK))

* ~~修正導致登入後後續呼叫無法運作的 Client 問題。~~

## 160118

日期：2016 年 1 月 17 日

### API 變更

* 推出新的排行榜 API：
  * `GetLeaderboardAroundPlayer`
  * `GetFriendLeaderboardAroundPlayer`
* 舊的排行榜 API 已淘汰：
  * `GetFriendLeaderboardAroundCurrentUser`
  * `GetLeaderboardAroundCurrentUser`
* 大量次要文件改善。

### ActionScriptSDK 特定變更

* [ActionScriptSDK](https://github.com/PlayFab/ActionScriptSDK)
  * 修正在錯誤回呼中無法存取 errorDetails 的問題。

### JavaSDK 特定變更

* [JavaSDK](https://github.com/PlayFab/JavaSDK)
  * `AndroidStudioExample`：系統會在適當時機 (且僅限適當時機) 自動擷取 Android `advertisingId` 並傳送至 PlayFab。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 從公開 SDK 中刪除部分內部測試系統 (DemoScene 資料夾)。
  * 我們正在建立新範例和事件系統的原型。部分基礎 SDK 變更可在差異中看到，但目前都還無法存取。即將完成，敬請持續關注。
  * 用戶端上提供替代版本的單元測試，其中僅包含用戶端 API 呼叫。

### Cocos2d-xSDK 和 WindowsSDK/C++ 特定變更

* [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK) 和 WindowsSDK/C++
  * 將兩者都更新為使用 RapidJson 1.0.2 (在適用之處更新 C++ 語法和程式碼)
  * 其他一些修正，包括 IOS
  * 由 [https://mingle-games.com/](https://mingle-games.com/) 提供


## Related topics

- [PlayFab 2016 年版本資訊](https://docs.xbox.com/zh-TW/services/playfab/release-notes/2016.md)