> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PlayFab 2018 版本資訊

> PlayFab Services SDK 2018 年版本資訊，記錄全年各版本的 SDK 更新、新 API 功能、重大變更和錯誤修正。

## 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 多人遊戲伺服器 2.0 API。如需詳細資訊，請參閱 [PlayFab 多人遊戲伺服器 2.0 (Thunderhead)](/zh-TW/services/playfab/multiplayer/servers)

## 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) 模型中新增 Metadata。
* Unreal Marketplace Plugin 中的錯誤修正，以擴充支援的版本。

## 180917

日期：2018 年 9 月 17 日

### API 變更

* Server API 方法 `DeleteUsers` 已淘汰，並由 [DeletePlayer](xref:titleid.playfabapi.com.server.accountmanagement.deleteplayer) 取代
* Unreal Marketplace Plugin：
  * 更新了 Marketplace Plugin 以包含我們的 Blueprint 介面。
  * [新的 Unreal Engine 快速入門指南](/zh-TW/services/playfab/sdks/unreal/quickstart)
  * [在 Unreal Marketplace 中檢視](https://www.unrealengine.com/marketplace/playfab-SDK)

## 180906

日期：2018 年 9 月 6 日

### 新 API

* **Localization**

### 新的 PlayStream 事件文件

* [client\_focus\_change](/zh-TW/services/playfab/api-references/events/Session/client-focus-change)
* [client\_session\_start](/zh-TW/services/playfab/api-references/events/Session/client-session-start)
* [player\_device\_info](/zh-TW/services/playfab/api-references/events/PlayerIdentity/player-device-info)

## 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 特定變更

* 在 SDK 產生器中新增 UE Marketplace 外掛程式。

## 180809

日期：2018 年 8 月 9 日

### API 群組變更

* 我們已將 Entity API 群組分成多個新的 API 群組。
* 對於使用先前 Entity API 的任何人來說，這是一項重大的 SDK 重大變更。
* 請參閱我們的[升級指南](/zh-TW/services/playfab/live-service-management/game-configuration/entities/entity-api-restructure-upgrade-tutorial)！
* (注意：部落格和升級指南的連結可能還無法運作，它們即將完成。)

### 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](/zh-TW/services/playfab/api-references/events/Matchmaking/title-queue-config-updated)
* **一般變更**
  * 在許多模型中淘汰了參數 `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 Files 能在更多平台上存取。
  * ScreenTime 功能中的錯誤修正。

## 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 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)
  * 上一個版本中所述的螢幕時間追蹤已不再僅限 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)
  * 將一些公用程式包裝在命名空間中，以避免與協力廠商衝突。
  * 編輯器延伸模組應該較少出現異常行為，並顯示較少的警告。
  * 新功能 - 請閱讀我們的[工作階段](/zh-TW/services/playfab/data-analytics/ingest-data/sessions)教學課程。

### JavaScriptSDK 變更

* [JavaScriptSDK](https://github.com/PlayFab/JavaScriptSDK)
  * `customData` 轉送參數現在應該可用於登入函式。

### XPlatCppSDK 特定變更

* [XPlatCppSDK](https://github.com/PlayFab/XPlatCppSdk)
  * 大型結果現在會正確剖析。

## 180618

日期：2018 年 6 月 18 日

### API 變更

* 在各種 API 方法中新增了新的錯誤碼。
* 多個與實體相關的 PlayStream 事件現在會描述其 [EntityLineage](/zh-TW/services/playfab/api-references/events/data-types/entitylineage)。

## 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](/zh-TW/services/playfab/api-references/events/PlayerIdentity/player-data-exported)

## 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](/zh-TW/services/playfab/api-references/events/CloudScript/entity-executed-cloud-script)
* **已更新的 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 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 變更

* 實體！[部落格](https://api.playfab.com/blog/introducing-entities-objects-and-files)！[快速入門指南](/zh-TW/services/playfab/live-service-management/game-configuration/entities/quickstart)！
* 如果 `request.LoginTitlePlayerAccountEntity` 設定為 `true`，所有 Client 登入方法都會傳回實體認證。
* 公會！[部落格](https://api.playfab.com/blog/announcing-groups-for-guilds-friends-clans-and-more)！[指南](/zh-TW/services/playfab/community/associations/groups/quickstart)！
* 為了正確性，更新了許多 API 方法的錯誤碼 (數十個！)。

### 新的 API 方法

* [admin.RevokeInventoryItems](xref:titleid.playfabapi.com.admin.playeritemmanagement.revokeinventoryitems) 和 [server.RevokeInventoryItems](xref:titleid.playfabapi.com.server.playeritemmanagement.revokeinventoryitems)。
* 全新的 [Entity API](/zh-TW/services/playfab/live-service-management/game-configuration/entities/quickstart)。
* 許多新的[實體 PlayStream 事件](/zh-TW/services/playfab/api-references/events) (在連結的頁面上搜尋 "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 變更

* 當要求參數中傳入自訂帳戶復原電子郵件範本識別碼時，`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

- [版本資訊](/zh-TW/tools/tools-pc/xbox-pc-remote-tools/release-notes/index.md)
- [PlayFab 2017 版本資訊](/zh-TW/services/playfab/release-notes/2017.md)
- [PlayFab 2019 版本資訊](/zh-TW/services/playfab/release-notes/2019.md)
- [PlayFab 2020 版本資訊](/zh-TW/services/playfab/release-notes/2020.md)
- [PlayFab 2021 版本資訊](/zh-TW/services/playfab/release-notes/2021.md)