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

> PlayFab 2017 年的版本資訊。

## 171204

日期：2017 年 12 月 4 日

### Unreal SDK 變更 (Cpp 與 Bp)

* 已將兩個 SDK 更新至 **Unreal 4.18.1**。
* 舊版仍可運作，但需要取消註解 \_.build.cs 檔案中的 `#defines`。

## 171127

日期：2017 年 11 月 27 日

### API 變更

* 允許「限量版」(Limited Edition) 物品的庫存功能現已結束搶鮮版並正式發行。

* 此功能可讓您定義遊戲中特定 `itemId` 僅提供固定數量。

* 已從使用「[ProfileModel](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#playerprofilemodel)」的 API 方法中移除虛擬貨幣屬性，因為該資訊從未提供過，也從未正確過。它總有一天會回來的。

### 新的 API 方法

* admin.[CheckLimitedEditionItemAvailability](xref:titleid.playfabapi.com.admin.playeritemmanagement.checklimitededitionitemavailability)
* admin.[IncrementLimitedEditionItemAvailability](xref:titleid.playfabapi.com.admin.playeritemmanagement.incrementlimitededitionitemavailability)
* client.[GetPaymentToken](xref:titleid.playfabapi.com.client.playeritemmanagement.getpaymenttoken)
  * 用於 [XSolla 專屬的付款處理](https://docs.xbox.com/zh-TW/services/playfab/economy-monetization/economy/tutorials/non-receipt-payment-processing.md)
* client.[ReportDeviceInfo](xref:titleid.playfabapi.com.client.analytics.reportdeviceinfo)
  * 此 API 方法並非設計為直接呼叫。它目前是 Unity 與 Lumberyard SDK 的內建功能。您可以使用 [API 原則](https://docs.xbox.com/zh-TW/services/playfab/api-references/api-access-policy.md)將其停用。此外，我們即將在 Game Manager 的標題設定頁面中新增另一個停用選項。

### 已更新的 API 方法錯誤碼

* client.[AddOrUpdateContactEmail](xref:titleid.playfabapi.com.client.accountmanagement.addorupdatecontactemail)
* client.[GetLeaderboardAroundPlayer](xref:titleid.playfabapi.com.client.playerdatamanagement.getleaderboardaroundplayer)
* client.[LoginWithAndroidDeviceID](xref:titleid.playfabapi.com.client.authentication.loginwithandroiddeviceid)
* client.[LoginWithCustomID](xref:titleid.playfabapi.com.client.authentication.loginwithcustomid)
* client.[LoginWithIOSDeviceID](xref:titleid.playfabapi.com.client.authentication.loginwithiosdeviceid)

### SDK 特定更新

* [UnitySdk](https://github.com/PlayFab/UnitySDK)：我們現在使用 Unity 2017.2.0f3 建置所有發佈的 Unity 套件檔案。
* 為了進行測試，我們在內部將每個 major.minor 版本更新至最新版本，範圍從 Unity 4.7.2f1 到 2017.1.2f1。
* Unity 範例測試遊戲伺服器：已對 `HttpHelper` 套用修正，以修正 `SignalR` 要求的 SSL 驗證。
* [ActionScriptSDK](https://github.com/PlayFab/ActionScriptSDK)：範例中的 AirSdk 已更新至 v27。
* [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)：儘管 Cocos 已發行 3.16，我們仍以 3.15.1 為目標 (敬請期待)。
* SdkTestingCloudScript 與 [NodeSDK](https://github.com/PlayFab/NodeSDK)：已更新範例 VS 專案以支援 VS/msbuild 2017。
* WindowsSDK：這是以 Visual Studio 2013 為目標的 NuGet 套件的最後一個組建：
  * [WindowsSdk VS 2013 NuGet 套件](https://www.NuGet.org/packages/com.playfab.windowssdk.v120/1.19.171127)
  * 我們正在更新自動化建置機器，且新機器不會安裝 VS 2013。
  * [較新的 NuGet 套件](https://www.NuGet.org/packages/com.playfab.windowssdk.v140/)將繼續在 VS 2015 與 2017 上運作。

## 171106

日期：2017 年 11 月 6 日

### 新的 API 方法

* admin.[GetPlayerProfile](xref:titleid.playfabapi.com.admin.accountmanagement.getplayerprofile)
* server.[SendEmailFromTemplate](xref:titleid.playfabapi.com.server.accountmanagement.sendemailfromtemplate)

### 已更新的 PlayStream 事件

* [sent\_email](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/TitleCommunications/sent-email.md) 新增了欄位：Body 與 Subject。

### 所有 SDK

* **次要 SDK 中斷性變更：**`ForgetClientCredentials()` 已重新命名為 `ForgetAllCredentials()`。
* 這是「即將推出」功能的一部分，完成時將會公告。

## 171102

日期：2017 年 11 月 2 日

### 新的 PlayFab 功能

* 使用範本傳送電子郵件給您的玩家。

### 新的 API 方法

* admin.[ResetPassword](xref:titleid.playfabapi.com.admin.accountmanagement.resetpassword)
* admin.[GetPlayerIdFromAuthToken](xref:titleid.playfabapi.com.admin.accountmanagement.getplayeridfromauthtoken)
* client.[AddOrUpdateContactEmail](xref:titleid.playfabapi.com.client.accountmanagement.addorupdatecontactemail)
* client.[RemoveContactEmail](xref:titleid.playfabapi.com.client.accountmanagement.removecontactemail)
* server.[SendCustomAccountRecoveryEmail](xref:titleid.playfabapi.com.server.accountmanagement.sendcustomaccountrecoveryemail)

### 文件更新

* [與每個 PlayFab API 呼叫相關的新錯誤碼清單](https://docs.xbox.com/zh-TW/services/playfab/api-references/global-api-method-error-codes.md)
* 已更新下列項目的錯誤碼：client.[LoginWithGoogleAccount](xref:titleid.playfabapi.com.client.authentication.loginwithgoogleaccount)、client.[UpdatePlayerStatistics](xref:titleid.playfabapi.com.client.playerdatamanagement.updateplayerstatistics)、server.[ConsumeItem](xref:titleid.playfabapi.com.server.playeritemmanagement.consumeitem)

### 新的 PlayStream 事件

* [auth\_token\_validated](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/auth-token-validated.md)
* [player\_updated\_contact\_email](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/player-updated-contact-email.md)
* [sent\_email](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/TitleCommunications/sent-email.md)

### Unreal 特定更新

* 我們的自動建置器未能發佈組建編號 171016 與 171026 的 Unreal SDK。我們已解決自動建置器的問題，事後發佈了 171026 版，且發行作業已恢復正常

### Unity 特定變更

* \*\*次要中斷性變更：\*\*已將 `ForgetClientCredentials` 重新命名為 `ForgetAllCredentials`。
* 這是即將推出之新功能的一部分。在接下來的幾個版本中，我們會在所有 SDK 中將 `ForgetClientCredentials` 重新命名為 `ForgetAllCredentials`。

## 171026

日期：2017 年 10 月 26 日

### API 文件變更

* 正在更新 API 方法的錯誤碼。

* 已從各 API 方法的清單中移除許多適用於所有 API 方法的通用錯誤碼。新的頁面會說明通用錯誤碼。

* **已移除的通用錯誤碼：**
  * InvalidParams
  * OverLimit
  * DataUpdateRateExceeded
  * AccountBanned

* 這些錯誤 (以及其他將在另一份文件中發佈的錯誤) 可能從任何 API 方法傳回，且應妥善處理。

* 已為數十個 API 方法新增錯誤碼，並移除一些錯誤的錯誤碼。錯誤碼清單對於方法特定的錯誤傳回應會更加準確。這仍是持續進行中的工作，因此還會有更多更新。

* 數個涉及虛擬貨幣的 API 方法可能會將餘額減少至低於零。我們已為這些方法加上適當的標示。

### API 變更

* **新的 API 方法：**
  * admin.[DeleteTitle](xref:titleid.playfabapi.com.admin.accountmanagement.deletetitle)
  * 託管的遊戲伺服器同時支援 **IPv4** 與 **IPv6**。
  * 自訂遊戲伺服器現在支援 **IPV6**。所有新啟動的遊戲伺服器執行個體都會同時獲指派 **IPV4** 與 **IPV6** 位址，這些位址會顯示在 Game Manager 的 **Servers** 索引標籤中，並由配對 API 傳回。用戶端可以連線至所指派伺服器的 **IPV4** 或 **IPV6** 位址。
  * 所有傳回伺服器位址的 API 方法現在都會傳回這兩個選項：client.[StartGame](xref:titleid.playfabapi.com.client.matchmaking).[StartGameResult](xref:titleid.playfabapi.com.client.matchmaking)

### Game Manager 變更

* 您現在可以使用新的 Admin/DeleteTitle API，或在 Game Manager 的工作室頁面上刪除標題，如下圖所示。

  ![DelTitleGameManager](https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/release-notes/images/171026-DelTitleGameManager.png?fit=max\&auto=format\&n=N3T1ucKV7zIMBudj\&q=85\&s=e05b5b1b05161e4730923e705349b890)

## 171016

日期：2017 年 10 月 16 日

### API 變更

* 已在 server.[SendPushNotification](xref:titleid.playfabapi.com.server.accountmanagement.sendpushnotification).[SendPushNotificationRequest](xref:titleid.playfabapi.com.server.accountmanagement.sendpushnotification#sendpushnotificationrequest).[PushNotificationPackage](xref:titleid.playfabapi.com.server.accountmanagement.sendpushnotification#pushnotificationpackage) 中新增 iOS Badge 的參數。
* 已釐清各種參數的裝置特定性質。

### 新的 PlayStream 事件

* [player\_started\_purchase](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Player/player-started-purchase.md)
* [player\_paid\_for\_purchase](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Player/player-paid-for-purchase.md)

### JavaScriptSDK 特定變更

* [JavaScriptSDK](https://github.com/PlayFab/JavaScriptSDK)
  * 我們的 SDK 現在已與 [Phaser.io](https://phaser.io/) 整合。

### LuaSDK 特定變更

* [LuaSDK](https://github.com/PlayFab/LuaSDK)
  * 已修正我們的 Lua 發佈管線，LuaSDK 再次正常更新。

### UnitySdk 特定變更

* [UnitySdk](https://github.com/PlayFab/UnitySDK)
  * 我們已在自己這端處理 [Unity 中的迴歸問題](https://issuetracker.unity3d.com/issues/unitywebrequest-getresponseheaders-method-returns-null-on-android-devices)，此問題應不會再影響 PlayFab 客戶。

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

* ~~我們的一位客戶為我們的 SDK 製作了附加元件外掛程式，整合了 Unreal OnlineSubsystem 與 PlayFab SDK~~
* ~~您可以在[這裡](https://gitlab.com/mtuska/OnlineSubsystemPlayFab)查看。~~ 

### Unicorn Battle 範例

* 已刪除 PlayFab 自訂推播外掛程式，並更新為 FCM 推播訊息。

## 170925

日期：2017 年 9 月 5 日

### API 變更

* 已移除少數從未公開的搶鮮版 API。這應不會影響任何現有客戶或已上線的標題。
* 我們略過了 CloudScript 引擎中預設的語言層級標頭檢查。這表示先前遭到拒絕的數個 CloudScript http.request() 標頭現在應可正常運作。

### 全域推播通知更新

* 如需推播通知改進的詳細資訊，請參閱[我們的部落格](https://blog.playfab.com/blog/push-sep-17)

### 新的 PlayStream 事件

* [player\_device\_info](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/player-device-info.md)
* 使用最新 UnitySDK 的遊戲現在可以查看其客戶的一些基本分析資料。SnowFlake 非常適合用來檢視與分析這些資訊，但您也可以在 PlayStream 事件歷程記錄中取得。
* player\_updated\_membership

### JavaScriptSDK 特定變更

* [JavaScriptSDK](https://github.com/PlayFab/JavaScriptSDK)
  * 已將其他 SDK 中既有的少數小功能新增至 JavaScriptSDK：
  * 您現在可以將額外的標頭插入要求中 (移除了此 SDK 支援雙重加密登入的其中一個障礙)。
  * 新增了一個函式：`PlayFabClientSDK.ForgetClientCredentials()`
  * 這是一個便利函式，可在關閉或登出後重設用戶端。
  * `PlayFab.GenerateErrorReport()`
  * 這是一個便利函式，可將失敗之 PlayFab 呼叫的錯誤結果轉換成單一且完整的呼叫失敗說明。
* 已在 PlayFab API 要求中新增選用的資料轉送：
  * `result.customData`
    * 這是您可以附加至要求的任何內容物件，可為結果提供內容。例如，您可以將本機用戶端玩家物件提供為 **UpdatePlayerStatistics** 呼叫的 `customData`，並在遠端呼叫成功後，於該玩家上設定更新後的統計資料。
  * `result.request`
    * 您的 API 呼叫要求現在會轉送至結果，可為結果提供內容。例如，當您呼叫 `UpdatePlayerStatistics` 時，可以在更新本機玩家物件時，從要求中讀取更新後的統計資料。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 新的實驗性功能：此版本的 PlayFab UnitySDK 現在可讓您選擇性地查看玩家的裝置資訊。您可以查看的資訊範例包括：記憶體、解析度、使用者代理程式、裝置類型、作業系統版本等。

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

* ~~已更新至 Unreal 4.17~~
* ~~拆分成三個獨立的外掛程式，各自具有不同的功能~~
* ~~整體大幅升級~~

## 170828

日期：2017 年 8 月 28 日

### Client API 變更

* ~~client.\[GetCurrentGames].\[result].Games\[i].GameServerState 已淘汰，並由 \[GameServerStateEnum] 取代~~。
  ~~- GameServerState 先前序列化為整數，這是一個錯誤。新欄位是正確的列舉字串。~~ (已更新：此項目已淘汰。請參閱 [Servers](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/servers/index.md))

### 其他 API 變更

* 已淘汰 Admin 與 Server API 上的下列 API 方法。
  * [GetActionsOnPlayersInSegmentTaskInstance](xref:titleid.playfabapi.com.admin.scheduledtask.getactionsonplayersinsegmenttaskinstance) - 此方法意外被標示為已淘汰，但這是一個錯誤，已予以還原。
* [SendPushNotification](xref:titleid.playfabapi.com.server.accountmanagement.sendpushnotification) 現在可以指定 [TargetPlatforms](xref:titleid.playfabapi.com.server.accountmanagement.sendpushnotification#sendpushnotificationrequest)
* 已針對 [SendPushNotificationRequest](xref:titleid.playfabapi.com.server.accountmanagement.sendpushnotification#sendpushnotificationrequest) 新增一些說明，釐清哪些參數適用於哪些平台 (不建議使用目標平台不支援的參數)。
* 已在共用群組文件中新增一些關於 [Shared Group](xref:titleid.playfabapi.com.client.sharedgroupdata.createsharedgroup) [限制](https://docs.xbox.com/zh-TW/services/playfab/community/associations/groups/using-shared-group-data.md)的資訊 (特別是它們無法用於公會之類的用途)。
* [玩家設定檔](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#playerprofilemodel)現在可以儲存玩家的[連絡人電子郵件地址](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#contactemailinfomodel)。

### 新的 PlayStream 事件

* [entity\_created](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/entity-created.md)
* [entity\_logged\_in](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/entity-logged-in.md)

## 170814

日期：2017 年 8 月 14 日

### API 更新

* server.[GetFriendsList](xref:titleid.playfabapi.com.server.friendlistmanagement.getfriendslist) 與 client.[GetFriendsList](xref:titleid.playfabapi.com.client.friendlistmanagement.getfriendslist) API 方法現在會為您的每位好友傳回 [PlayerProfile](xref:titleid.playfabapi.com.client.friendlistmanagement.getfriendslist#playerprofilemodel)。

### CSharpSdk 特定更新

* SDK 現在包含名為 [NewtonSoftJsonWrapper.cs](https://github.com/PlayFab/CSharpSDK/blob/master/PlayFabSDK/source/Json/NewtonsoftWrapper.cs) 的檔案，可讓您將我們內含的 SimpleJson 序列化程式替換為 NewtonSoft NuGet 套件。
* 該檔案包含使用說明。

## 170807

日期：2017 年 8 月 7 日

### 新的 API 方法

* admin.[DeletePlayer](xref:titleid.playfabapi.com.admin.accountmanagement.deleteplayer)

### 已淘汰的 API 方法

* 這些 API 方法從未如預期般完整運作。為了改善這個情況，我們重新開始，建置了上一節中新的 [DeletePlayer](xref:titleid.playfabapi.com.admin.accountmanagement.deleteplayer) API，而下列方法已淘汰：
* `admin.ResetUsers`
* `admin.DeleteUsers`

### API 更新

* `PlayerProfile` (位於 [Admin](xref:titleid.playfabapi.com.admin.accountmanagement.getplayerprofile#playerprofilemodel)/[Server](xref:titleid.playfabapi.com.server.accountmanagement.getplayerprofile#playerprofilemodel)/[PlayStream](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#playerprofilemodel)) 包含新欄位 `ContactEmailAddresses`，其中包含您可能已儲存的玩家電子郵件地址資訊。

### PlayStream 事件

* 新事件：[auth\_token\_validated](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/auth-token-validated.md)
* 新事件：[player\_removed\_title](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/player-removed-title.md)
* 新事件：[player\_updated\_contact\_email](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/player-updated-contact-email.md)
* 新事件：[player\_verified\_contact\_email](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/player-verified-contact-email.md)
* 新事件：[sent\_email](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/TitleCommunications/sent-email.md) (仍處於搶鮮版，但事件已公開)
* 事件中的新欄位：[player\_realmoney\_purchase](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Player/player-realmoney-purchase.md).TransactionId

~~**LumberyardSdk 變更：**~~

* ~~\*\*升級警告：\*\*此 SDK 不再與舊版 Lumberyard 相容。~~
* ~~此版本的 PlayFab LumberyardSdk 不再適用於 Lumberyard 1.3 版。它已升級，現在以 Lumberyard 1.9 為目標。我們可能很快就會以 1.10 為目標，但同樣不會回溯相容於 1.9 或更早版本。如需詳細資訊，請參閱[我們的部落格](https://blog.playfab.com/blog/cpp-SDK-updates)。~~

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

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

* ~~PlayFab UnrealBlueprintSdk 現已重新命名為「Unreal SDK」~~
* ~~Unreal SDK 已更新至 4.16，並包含一些次要修正~~
* ~~我們也將移除對舊版 Unreal 的支援，這些版本需要舊版 Visual Studio~~
* ~~我們現在支援 4.14 到 4.16~~
* ~~您的專案可能仍可在舊版 Visual Studio 上運作，但我們只能支援及測試 Visual Studio 2015 及更新版本~~
* ~~如需詳細資訊，請閱讀[我們的部落格](https://blog.playfab.com/blog/visual-studio-2013-deprecation-notice)~~

### Unity Editor Extensions

* 已修正下載與上傳 CloudScript 修訂版本的問題。
* 已修正系統語言使用非 ASCII 字母之使用者的問題。

## 170710

日期：2017 年 7 月 10 日

### API 變更

* 雙重加密登入的 Enterprise 功能已結束搶鮮版並正式上線。
* **新的 API 方法：**
  * admin.[CreatePlayerSharedSecret](xref:titleid.playfabapi.com.admin.authentication.createplayersharedsecret)
  * admin.[DeletePlayerSharedSecret](xref:titleid.playfabapi.com.admin.authentication.deleteplayersharedsecret)
  * admin.[GetPlayerSharedSecrets](xref:titleid.playfabapi.com.admin.authentication.getplayersharedsecrets)
  * admin.[SetPlayerSecret](xref:titleid.playfabapi.com.admin.authentication.setplayersecret)
  * admin.[UpdatePlayerSharedSecret](xref:titleid.playfabapi.com.admin.authentication.updateplayersharedsecret)
  * client.[GetTitlePublicKey](xref:titleid.playfabapi.com.client.authentication.gettitlepublickey)
  * client.[SetPlayerSecret](xref:titleid.playfabapi.com.client.authentication.setplayersecret)
  * server.[SetPlayerSecret](xref:titleid.playfabapi.com.server.authentication.setplayersecret)
* server.[RegisterGameRequest](xref:titleid.playfabapi.com.server.matchmaking) 有一個新屬性：LobbyId，可讓您嘗試重新註冊現有的遊戲
* server.[SendPushNotificationRequest](xref:titleid.playfabapi.com.server.accountmanagement.sendpushnotification#sendpushnotificationrequest) 現在接受新屬性：Package，其定義了所有進階 Android 推播功能。

### SDK 中斷性變更

* admin.[SetupPushNotificationRequest](xref:titleid.playfabapi.com.admin.title-widedatamanagement.setuppushnotification#setuppushnotificationrequest).Platform 現在定義為列舉，而非字串。這對 API 而言並非中斷性變更 (因為列舉是以字串傳輸)，但部分使用者需要在程式碼中將其字串轉換為列舉值。

### 所有 SDK 中的變更

* 次要 SDK 中斷性變更：大部分 SDK 已在多個要求中移除名為 UseSpecificVersion 的選用欄位，此欄位是將相鄰 Version 欄位定義為 null 的替代方式。並非所有語言都能在要求中將整數定義為 null，而此欄位原本只打算在相關的 SDK 中使用 (特別是 Unreal)。如果您正在使用此欄位，只要將其移除，並在適當時將相鄰的 Version 欄位設為 null 即可。

### Unity EditorExtensions 更新

* 已更新旗標面板。
* 現在可以切換 `ENABLE/DISABLE_IDFA` 旗標。
* 會顯示非 PlayFab 的旗標，並讓您將其移除 (請謹慎使用，不要移除您需要的旗標)。

### SDK 相依性更新

* [UnitySDK](https://github.com/PlayFab/UnitySDK) 已使用 Unity2017.1.0f1 建置、封裝及測試。
  * 僅有細微、非中斷性的變更。
* [ActionScriptSDK](https://github.com/PlayFab/ActionScriptSDK) 已使用 AirSDK v26 測試。
  * SDK 未變更，範例已更新為以 v26 為目標。
* [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK) 已使用 Cocos 3.15.1 建置及測試。
* Cocos 3.14->3.15 包含會中斷我們範例的變更，因此範例必須更新。範例仍可在 3.13 到 3.15 上運作，但可能無法在較舊版本的 Cocos 上運作。SDK 未變更，應可在大部分最新的 3.X Cocos 版本上運作。

## 170612

日期：2017 年 6 月 12 日

### 文件變更

* 為了清楚起見，對數十個 API 方法進行了許多小幅修訂
* 已將數個各只包含單一 API 方法的文件群組合併為名為「Platform Specific Methods」的單一群組。
* 已將「Matchmaking APIs」群組重新命名為「Matchmaking」，以與其他群組保持一致。
* 許多有長度限制的字串欄位現在會說明允許的範圍。

### 所有 SDK 中的變更

* 已更新並修正所有 SDK README 中的許多失效連結。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 我們現在支援多個版本的 Android API 與 Google Play Services。請在[這裡](https://github.com/PlayFab/UnitySDK/tree/master/Packages)閱讀更多詳細資訊。 
  * 目前對 Unity + Android 推播外掛程式的規劃變更到此告一段落。如果您有任何其他要求，請在[這裡](https://community.playfab.com/questions/10840/android-plugin-upgrade-discussion.html)告訴我們。 

## 170530

日期：2017 年 5 月 30 日

### API 變更

* \*\*中斷性變更：\*\*在 server.[ReportPlayer](xref:titleid.playfabapi.com.server.playeritemmanagement.reportplayer) 中，我們立即移除了 [ReportPlayerServerRequest](xref:titleid.playfabapi.com.server.playeritemmanagement.reportplayer#reportplayerserverrequest) 中的 `titleId` 欄位 (不只是淘汰)。所有檢舉現在都會送往其所屬的標題，且無法檢舉至其他標題。
  * 這必須是中斷性變更，否則會構成輕微的跨標題漏洞。如果您需要此變更的協助，請[與我們連絡](https://community.playfab.com/questions/ask.html)。
* 在 client.[ReportPlayer](xref:titleid.playfabapi.com.client.accountmanagement.reportplayer) 與 server.[ReportPlayer](xref:titleid.playfabapi.com.server.playeritemmanagement.reportplayer) 中，我們在兩種情況下都淘汰了 result.Updated。它一律為 true，而如果玩家超過檢舉限制，API 呼叫會傳回錯誤。我們已將此錯誤狀況變更為 OverLimit，以與其他限制一致。
* 所有[登入方法](xref:titleid.playfabapi.com.client.authentication)現在都可以在要求時傳回[玩家設定檔物件](xref:titleid.playfabapi.com.client.authentication.loginwithandroiddeviceid#playerprofilemodel)，其中包含先前只有排行榜結果才能取得的資訊。

### 新的 API 方法

* client.[GetPlayerProfile](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile) 與 server.[GetPlayerProfile](xref:titleid.playfabapi.com.server.accountmanagement.getplayerprofile)
  * 傳回先前只有排行榜結果才能取得的資訊。

### 文件

* 小幅更新，數個範例不再包含已淘汰欄位的相關資訊。
* 已定義 [ExecuteCloudScript](xref:titleid.playfabapi.com.client.server-sidecloudscript.executecloudscript) 的傳回值與記錄大小限制。

### 新的 PlayStream 事件

* gameserverhost\_started
* gameserverhost\_stopped
* [player\_set\_profile\_property](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Player/player-set-profile-property.md)

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 全面翻新了我們的 Android 推播外掛程式。
  * [部落格文章](https://blog.playfab.com/blog/push-upgrade-5-22)
  * [新的/更新的指南](https://docs.xbox.com/zh-TW/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/push-notifications-for-android.md)

### CSharpSDK 特定變更

* [CSharpSDK](https://github.com/PlayFab/CSharpSDK)
  * 現在可以指定要插入 API 要求中的額外標頭。
  * 這是僅限 Enterprise 的功能，專門用於雙重加密的登入要求。

## 170508

日期：2017 年 5 月 8 日

### API 變更

* **中斷性變更：**
  * 如果呼叫的傳回值過大，[ExecuteCloudScript](xref:titleid.playfabapi.com.client.server-sidecloudscript.executecloudscript) 不會將其序列化。
  * 如果呼叫的記錄過大，[ExecuteCloudScript](xref:titleid.playfabapi.com.client.server-sidecloudscript.executecloudscript) 不會將其序列化。
* 在上述任一情況下，呼叫仍會傳回 200/成功，但 FunctionResult 和/或 Logs 屬性會是 null。

### PlayStream 事件變更

* [player\_vc\_item\_purchased](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Player/player-vc-item-purchased.md) 與 [character\_vc\_item\_purchased](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Character/character-vc-item-purchased.md) 現在包含 StoreId 參數，指出用來進行購買的商店。
* **新事件：**
  * [title\_profile\_view\_constraints\_changed](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/title-profile-view-constraints-changed.md)

### CSharpSDK 更新

* [CSharpSDK](https://github.com/PlayFab/CSharpSDK)
  * 已刪除 [CSharpSDK](https://github.com/PlayFab/CSharpSDK) 中一些未使用的原始檔。
  * 這應不會影響任何現有專案或 NuGet 套件，因為 Visual Studio 方案並未參考這些檔案。

### Postman 集合更新

* 數個常見的要求參數現在使用環境變數。
* 具體來說，TitleId=\{\{TitleId}}、PlayFabId=\{\{PlayFabId}}、CharacterId=\{\{CharacterId}} 與 CatalogVersion=\{\{PrimaryCatalogName}}

## 170424

日期：2017 年 4 月 24 日

### SDK Hotfix 版本

* **[JavaSDK](https://github.com/PlayFab/JavaSDK) 更新：**
  * 我們現在會發佈 SDK 的 Jar 檔案，一個用於程式碼，一個用於 Java 文件，您可以將其匯入 Java 專案，而不必複製貼上程式碼。感謝 Will Iverson 協助我們改善 [JavaSDK](https://github.com/PlayFab/JavaSDK) 的可用性
* **UnityEditorExtensions 更新：**
  * 我們已解決一些安裝時的例外狀況。具體來說，首次安裝後不再需要重新啟動 Unity。
  * 此外，Client API 有時遭到不當停用的問題現已修正。(已編輯)
* ~~**UnrealCppSdk 更新：**~~ (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK))
* ~~現在可以從外掛程式介面取得 titleId~~

## 170411

日期：2017 年 4 月 11 日

### API 變更

* 新的 Enterprise 功能：更多登入加密
* 您可以使用原則 API 方法，強制要求登入呼叫使用第二層加密
* 請參閱：[UpdatePolicy](xref:titleid.playfabapi.com.admin.authentication.updatepolicy)，特別是 [UpdatePolicyRequest](xref:titleid.playfabapi.com.admin.authentication.updatepolicy#updatepolicyrequest).[Statements](xref:titleid.playfabapi.com.admin.authentication.updatepolicy#permissionstatement).[ApiConditions](xref:titleid.playfabapi.com.admin.authentication.updatepolicy#apicondition)
* 此功能仍有部分處於搶鮮版，不建議啟用 (目前還不建議，即將推出！)

### 新的 PlayStream 事件

* [player\_receipt\_validation](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Player/player-receipt-validation.md)

### UnitySDK 特定變更

* 現在可以指定要插入 API 要求中的額外標頭 (上一節中的加密登入呼叫需要此功能)。

### UnityEditorExtensions 特定變更

* 已修正 Unity 5.6 的編譯問題。

## 170406

日期：2017 年 4 月 6 日

### Unity Android 推播外掛程式的 Hotfix

* 已修正 Android 7.0+ 當機錯誤。
* 已修正 Android 缺少大型圖示支援的問題 (Lollipop+)。
* 已修正 Android 7.0+ 上的 Android 小型圖示支援 (現在支援 \_transparent.png)。

## 170403

日期：2017 年 4 月 3 日

### API 變更

* \*\*Client 與 Server 排行榜方法：\*\*Get-Leaderboard 方法 (例如 client.[GetLeaderboard](xref:titleid.playfabapi.com.client.playerdatamanagement.getleaderboard)) 先前新增了不可為 null 的參數 Version 與 UseSpecificVersion。要求它們不可為 null 是一項 API 中斷性變更。我們已將這些屬性更新為完全選用。
* **Client API：**[GetPurchaseResult](xref:titleid.playfabapi.com.client.playeritemmanagement.getpurchase#getpurchaseresult) 的 Items 欄位已淘汰：結果的這個部分經常不正確或不完整。它最終會由功能完整的參數取代。

### 新的 PlayStream 事件

* `player_display_name_filtered`

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

* ~~UnrealCppSdk：已修正發佈組建時遺失 TitleId 等 PlayFab 設定的問題。
  兩個 SDK 都已在 Unreal 4.15 上測試並驗證可正常運作~~

### JavaSDK 特定變更

* [JavaSDK](https://github.com/PlayFab/JavaSDK)
  * 已重新調整 [JavaSDK](https://github.com/PlayFab/JavaSDK) 的資料夾結構與測試。
  * 存放庫的內部資料夾結構已稍作變更，以符合 Maven 最佳做法。
  * 相依性現在由 Maven 控制，不再隨附於 SDK 中。
  * 已將我們的內部自動化測試轉換為 Maven 命令列。
  * 我們的 SDK 無法在 Maven Central 上取得，因為該工作已停滯。目前沒有預計完成時間。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 用於測試及建置資產套件組合的內部 Unity 版本已更新至 5.6.0。我們的 Unity SDK 仍與 Unity 4.7 到 5.6 的所有版本相容。
  * 已修正 Unity 5.6 中 `UnityEditorExtensions` 的編譯問題。

## 170223

日期：2017 年 2 月 22 日

### API 變更

* PlayFab 排行榜現在會為每位玩家儲存頭像 URL。這可用來為排行榜項目參考玩家圖片。
* 所有排行榜 API 現在都可以擷取特定版本的排行榜。這適用於設定為使用重設排行榜的標題。
* 排行榜項目現在包含 [PlayerProfile](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#playerprofilemodel)，可用來顯示更詳細的排行榜，而不需要額外的 API 呼叫
* PlayFab 現在可以使用 Windows Hello 驗證用戶端，並驗證 Windows 市集收據

### 新的 API

```text theme={null}
- [Client/UpdateAvatarUrl](xref:titleid.playfabapi.com.client.accountmanagement.updateavatarurl)
- `Client/RegisterWithWindowsHello`<!-- [Client/RegisterWithWindowsHello](xref:titleid.playfabapi.com.client.authentication.registerwithwindowshello) -->
- `Client/GetWindowsHelloChallenge`<!-- [Client/GetWindowsHelloChallenge](xref:titleid.playfabapi.com.client.authentication.getwindowshellochallenge) -->
- `Client/LoginWithWindowsHello`<!-- [Client/LoginWithWindowsHello](xref:titleid.playfabapi.com.client.authentication.loginwithwindowshello) -->
- `Client/LinkWindowsHello`<!-- [Client/LinkWindowsHello](xref:titleid.playfabapi.com.client.accountmanagement.linkwindowshello) -->
- `Client/UnlinkWindowsHello`<!-- [Client/UnlinkWindowsHello](xref:titleid.playfabapi.com.client.accountmanagement.unlinkwindowshello) -->
- [Client/ValidateWindowsStoreReceipt](xref:titleid.playfabapi.com.client.platformspecificmethods.validatewindowsstorereceipt)
- [Server/SetFriendTags](xref:titleid.playfabapi.com.server.friendlistmanagement.setfriendtags)
```

### 新的 PlayStream 事件

* [player\_changed\_avatar](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/PlayerIdentity/player-changed-avatar.md)

### WindowsSDK 特定變更

* 已在 JSON 序列化程式中新增一些遺漏的 null 檢查。

### 所有 SDK

* 對 [testTitleData](https://github.com/PlayFab/SDKGenerator/blob/master/JenkinsConsoleUtility/testTitleData.md) 格式的小幅新增。這僅適用於 SDK 隨附的範例測試專案。

## 170130

日期：2017 年 1 月 29 日

### 中斷性變更

* 隨著今天的主要版本發行，我們變更了 [JavaScriptSDK](https://github.com/PlayFab/JavaScriptSDK) 與 [NodeSDK](https://github.com/PlayFab/NodeSDK) 的資料夾結構。當您升級時，這可能會導致專案中的某些連結中斷。(檔案名稱與檔案內容並未變更。現在新增了先前不存在的 **TypeScript** 檔案。)

### API 變更

* 已在 CDN API 中新增說明文件。特別指出 CDN 不屬於我們的免費服務。
* Google 登入修正 (部落格文章即將發佈)。

### 新的 PlayStream 事件

* `developer_logged_in`
* `developer_registered`
* [studio\_created](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/DeveloperIdentity/studio-created.md)
* [studio\_user\_added](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/DeveloperIdentity/studio-user-added.md)
* [studio\_user\_invited](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/DeveloperIdentity/studio-user-invited.md)
* [studio\_user\_removed](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/DeveloperIdentity/studio-user-removed.md)

### JavaScriptSDK 特定變更

* [JavaScriptSDK](https://github.com/PlayFab/JavaScriptSDK)
  * 主要升級的發行日！版本號碼已更新至 1.0。
  * TypeScript 整合！
  * 存放庫清理：將 SDK 檔案與範例檔案分開。
  * 已將我們的範例專案轉換為 TypeScript。
  * 請參閱[我們的部落格](https://blog.playfab.com/blog/typescript/)！

### NodeSDK 特定變更

* [NodeSDK](https://github.com/PlayFab/NodeSDK)
  * 主要升級的發行日！版本號碼已更新至 1.0
  * TypeScript 整合！
  * 已將我們的範例專案轉換為 TypeScript
  * 請參閱[我們的部落格](https://blog.playfab.com/blog/typescript/)！

### CloudScript 範例

* 發行新的範例存放庫。
* TypeScript 整合！
* 請參閱[我們的部落格](https://blog.playfab.com/blog/typescript/)！
* 以及[新的存放庫](https://github.com/PlayFab/SdkTestingCloudScript)！
* 我們會隨著時間擴充此存放庫。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 已修正 **JsonWrapper** 並非在所有情況下都能如預期運作的問題。
  * 如需詳細資訊，請參閱我們的論壇文章：[https://community.playfab.com/questions/7599/cloudscript-getplayercombinedinfo-little-problem.html](https://community.playfab.com/questions/7599/cloudscript-getplayercombinedinfo-little-problem.html)
  * 已移除下列所有已淘汰的包裝函式類別，改用 `PlayFab.Json.JsonWrapper`：
    * `PlayFab.Json.JsonConvert` (請使用 `PlayFab.Json.JsonWrapper`)
    * `PlayFab.Json.SimpleJson` (請使用 `PlayFab.Json.JsonWrapper` 或 `PlayFab.Json.PlayFabSimpleJson`)
    * `PlayFab.SimpleJson` (請使用 `PlayFab.Json.JsonWrapper` 或 `PlayFab.Json.PlayFabSimpleJson`)
  * 重申 [160627](https://docs.xbox.com/zh-TW/announcements/playfab/2016.md#160627) 中的說明：`UnityEngine.SimpleJson` 是 `UnityEngine.dll` 中的空命名空間，因此我們必須避免使用該識別碼。

### Unity Editor Extensions

* 已解決當您的帳戶無法檢視任何工作室時，PlayFab 面板會無限重新載入的問題。
* 已解決當您從 PlayFab 面板挑選標題時，`PlayFabSharedSettings` (Scriptable Object) 無法正確儲存的問題。

## 170109

日期：2017 年 1 月 8 日

### 中斷性變更

* 已移除舊版 WindowsSDK 中的 lib，必須在 Visual Studio 中重新建立。這些 lib 從未在 vs2015 中運作過，因此強烈建議您直接更新至上週發佈的最新 WindowsSDK。

### API 變更

* 已修正文件中的錯字。

### 所有 SDK

* [新的使用者入門指南](../index.yml)

### SDKGenerator 特定變更

* [SDKGenerator](https://github.com/PlayFab/SDKGenerator)
  * [ActionScriptSDK](https://github.com/PlayFab/ActionScriptSDK) 建置指令碼與其他 SDK 不一致。我們簡化了建置 [ActionScriptSDK](https://github.com/PlayFab/ActionScriptSDK) 的 [SDKGenerator](https://github.com/PlayFab/SDKGenerator) 命令，使其與其他 SDK 一致。(SDK 本身沒有變更。)

### UnitySdk 特定變更

* [UnitySdk](https://github.com/PlayFab/UnitySDK)
  * PlayFabSettings 中的一些公用元素已加上 Obsolete 標記：`PlayFabSettings.PlayFabSharedSettings` `PlayFabSettings.DefaultPlayFabApiUrl` `PlayFabSettings.GetSharedSettingsObject()` `PlayFabSettings.ProductionEnvironmentUrl`

這些元素將在過渡期後設為私用。

### WindowsSDK 特定變更

* 已對 GitHub 存放庫執行 BFG，並從歷程記錄中移除所有大型檔案。請刪除您的複製或分支，然後重新建立，讓您的歷程記錄保持乾淨。

## 170102

日期：2017 年 1 月 1 日

### API 變更

* `Client/GetUserCombinedInfo` 已轉換為完全過時，我們已將其從 SDK 與文件中移除。

### Cocos2d-xSDK 特定變更

* [Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)
  * 已修正 PlayFab API 傳回無效回應時的當機問題。
  * 已解決一些編譯器警告。
  * 已在我們的測試範例專案中新增 Lambda 回呼函式的單元測試。

### UnitySDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 我們已在內部更新至 Unity 5.5，且我們的 **.unitypackage** 檔案是使用此版本建置的

  * 一如往常，我們會繼續支援 *Unity 4.7 及更新的所有版本*。

  * 已在許多靜態類別中新增靜態建構函式，以穩固 **Mono2x** 編譯器中的初始化順序。這應可解決我們在 iOS 中看到的一些 `PlayFabSharedSettings` 問題。

  * **IDFA/ADID** 現在可在 Unity 5.6 搶鮮版中正常運作。

  * \*\*已知問題：\*\*Unity 5.6 搶鮮版組建無法在 **Windows Server** (**OS**) 上運作，其中包括 PlayFab 遊戲伺服器託管。如果這對您造成影響，請與 Unity 連絡。

### WindowsSDK 特定變更

* 主要升級的發行日！
* 部落格文章：[Windows SDK Update Released](https://api.playfab.com/blog/windows-SDK-update-released)
* 升級指南：[PlayFab WindowsSdk v0.x -> v1.x 升級指南](https://github.com/PlayFab/WindowsSdk/blob/master/UpgradeGuide.md)


## Related topics

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