> ## 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** 的錯誤修正。

### 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-TW/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 變更

* 將 Metadata 新增至 [DeleteMasterPlayerAccountRequest](xref:titleid.playfabapi.com.admin.accountmanagement.deletemasterplayeraccount#deletemasterplayeraccountrequest) 模型。
* Unreal Marketplace 外掛程式的錯誤修正，以擴充支援的版本。

## 180917

日期：2018 年 9 月 17 日

### API 變更

* Server API 方法 `DeleteUsers` 已淘汰，並由 [DeletePlayer](xref:titleid.playfabapi.com.server.accountmanagement.deleteplayer) 取代
* Unreal Marketplace 外掛程式：
  * 已更新 Marketplace 外掛程式以包含我們的藍圖介面。
  * [新的 Unreal Engine 快速入門指南](https://docs.xbox.com/zh-TW/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-TW/services/playfab/api-references/events/Session/client-focus-change.md)
* [client\_session\_start](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Session/client-session-start.md)
* [player\_device\_info](https://docs.xbox.com/zh-TW/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 特定變更

* 各種錯誤修正與重構。
* 將 AttributeInstallRequest 變更為 API 特定。

### Unreal Engine 特定變更

* 將 UE Marketplace 外掛程式加入 SDK 產生器。

## 180809

日期：2018 年 8 月 9 日

### API 群組變更

* 我們已將 Entity API 群組分割成多個新的 API 群組。
* 對於任何使用先前 Entity API 的使用者而言，這是一項重大的 SDK 中斷性變更。
* 請參閱我們的[升級指南](https://docs.xbox.com/zh-TW/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-TW/services/playfab/api-references/events/Matchmaking/title-queue-config-updated.md)
* **一般變更**
  * 已在許多模型中淘汰參數 `ServerAddress`，改用新的 `ServerIPV4Address`。

### Unreal (多個 SDK) 特定變更

* 兩個 SDK/外掛程式的次要更新，最終將合併至 Marketplace 外掛程式。(即將推出！)

### PythonSDK! 特定變更

* [PythonSDK!](https://github.com/PlayFab/PythonSdk)
  * 錯誤修正與改進。

### UnitySDK 與 CSharpSDK 特定變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK) 與 [CSharpSDK](https://github.com/PlayFab/CSharpSDK)
  * 新增名為 Plugin Manager 的新結構。目前這只是未來變更的基礎。我們已將一些舊的函式簽章標示為過時，您應該加以更新。(不過沒有中斷性變更。)
  * 發現並解決了 HTTPS.Put 的多個問題，讓 Entity 檔案可在更多平台上存取。
  * ScreenTime 功能的錯誤修正。

## 180716

日期：2018 年 7 月 16 日

### UnitySDK 變更

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 已修正 ScreenTime 在某些罕見情況下的次要問題。

### CSharpSDK 變更

* [CSharpSDK](https://github.com/PlayFab/CSharpSDK)
  * 已將 [Plugin Manager API](https://github.com/PlayFab/CSharpSDK/blob/master/PluginManager.md) 新增至 C# SDK，以支援 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 Hotfix 版本

* 進一步改善及最佳化 ScreenTime 事件。

## 180709

日期：2018 年 7 月 9 日

### Hotfix 版本

* 修正上週部署的一些次要問題。
* 上週版本資訊中的所有內容現在應可如承諾般運作。

## 180706

日期：2018 年 7 月 6 日

### API 變更

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

### UnitySdDK 特定變更

* [UnitySdDK](https://github.com/PlayFab/UnitySDK)
  * 上一個版本中所述的螢幕使用時間追蹤，已不再僅限搶鮮版使用。

## 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-TW/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 方法中新增錯誤碼。
* 多個與 Entity 相關的 PlayStream 事件現在會描述其 [EntityLineage](https://docs.xbox.com/zh-TW/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-TW/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-TW/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)
  * 目前處於搶鮮版。
  * 以 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 Hotfix：**~~ (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 [UnrealMarketplaceSDK](https://www.unrealengine.com/marketplace/playfab-SDK))

* ~~在 UnrealCppSdk 的 Entity API 版本中發現問題。這些問題已透過 Hotfix 修正，Entity API 現在應可如預期運作。~~

## 180409

日期：2018 年 4 月 9 日

### API 變更

* **Hotfix：**
  * 僅更新了日期，而非主要/次要版本號碼。
* **公會：**
  * 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 變更

* Entity！[部落格](https://api.playfab.com/blog/introducing-entities-objects-and-files)！[快速入門指南](https://docs.xbox.com/zh-TW/services/playfab/live-service-management/game-configuration/entities/quickstart.md)！
* 如果 `request.LoginTitlePlayerAccountEntity` 設為 `true`，所有 Client 登入方法都會傳回 Entity 認證。
* 公會！[部落格](https://api.playfab.com/blog/announcing-groups-for-guilds-friends-clans-and-more)！[指南](https://docs.xbox.com/zh-TW/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-TW/services/playfab/live-service-management/game-configuration/entities/quickstart.md)。
* 許多新的 [Entity PlayStream 事件](https://docs.xbox.com/zh-TW/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 Hotfix

* [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 錯誤例外狀況的 TypeScript 定義。

## 180103

日期：2018 年 1 月 3 日

### LuaSDK 特定更新

* [LuaSDK](https://github.com/PlayFab/LuaSDK)/Defold/Corona
  * 錯誤修正更新。
  * 部分平台產生無法解析的格式錯誤 URL。

## 180102

日期：2018 年 1 月 2 日

### UnitySDK 特定更新

* [UnitySDK](https://github.com/PlayFab/UnitySDK)
  * 錯誤修正更新。
  * 為了避免回應標頭的問題，應為所有裝置組建停用壓縮。此更新讓這成為可能。
  * 或者，切換至 Web Request 也可避免此問題。
  * 為 Unity 2017 以上版本新增新的 HTTP 選項。


## Related topics

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