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

> PlayFab Services SDK 2020 年版本資訊，記錄全年推出的 SDK 更新、新 API 端點、功能新增和錯誤修正。

<Note>
  如需服務版本和產品更新的版本資訊，請參閱 [PlayFab 公開 GitHub 存放庫](https://github.com/PlayFab/PlayFab)上的[版本資訊](https://github.com/PlayFab/PlayFab/releases)區段
</Note>

## 201218

日期：2020-12-18

* 小型錯誤修正

## 201207

日期：2020-12-07

支援 [12 月 2 日 PlayFab 服務版本](https://github.com/PlayFab/PlayFab/releases/tag/2.5.7)

### [UnrealMarketplacePlugin](https://www.unrealengine.com/marketplace/product/playfab-sdk) 特定變更

* 修正了靜態設定問題。請依照[新的升級指南](https://github.com/PlayFab/UnrealMarketplacePlugin/blob/master/UpgradeGuide_201207.md)操作。

## 201119

日期：2020-11-19

### [PostmanCollection](https://github.com/PlayFab/PostmanCollection) 特定變更

* 在適當時新增了遊戲實體的自動登入

### [UnitySDK](https://github.com/PlayFab/UnitySDK) 特定變更

* 修正了 Unity 2020 中過多的記錄訊息
* 現在完全支援 Unity 2020

### [XPlat C++ SDK](https://github.com/PlayFab/XPlatCppSdk) 特定變更

* 修正了所有伺服器都逾時時的 QoS 搜尋回應。

## 201027

日期：2020-10-27

支援 [9 月 2 日 PlayFab 服務版本](https://github.com/PlayFab/PlayFab/releases/tag/2.5.6)

對 API 進行了小幅更新。

## 201014

日期：2020-10-14

支援 [9 月 2 日 PlayFab 服務版本](https://github.com/PlayFab/PlayFab/releases/tag/2.5.6)

(也支援 [Experimentation](https://learn.microsoft.com/en-us/rest/api/services/playfab/experimentation/experimentation) API 中的新方法，這些方法將出現在近期的服務版本中)

PlayFab 致力於讓您能使用我們的服務，搭配各種遊戲引擎和架構開發跨平台和跨裝置的遊戲。為了協助我們更專注於建立您所需的新功能，我們將下列 SDK 開放給社群貢獻。如果您有其他問題或需要支援，請前往 [PlayFab 社群論壇](https://community.playfab.com/index.html)。這將是我們對下列 SDK 的最後一次官方更新：

* [https://github.com/PlayFab/Cocos2d-xSDK](https://github.com/PlayFab/Cocos2d-xSDK)
* [https://github.com/PlayFab/Objective\_C\_SDK](https://github.com/PlayFab/Objective_C_SDK)
* [https://github.com/PlayFab/PhpSdk](https://github.com/PlayFab/PhpSdk)
* [https://github.com/PlayFab/PythonSdk](https://github.com/PlayFab/PythonSdk)

## 200914

日期：2020-09-14

支援 [9 月 2 日 PlayFab 服務版本](https://github.com/PlayFab/PlayFab/releases/tag/2.5.6)

## 200901

日期：2020-09-01

支援 [8 月 26 日 PlayFab 服務版本](https://github.com/PlayFab/PlayFab/releases/tag/2.5.5)

## 200817

日期：2020-08-17

支援 [8 月 12 日 PlayFab 服務版本](https://github.com/PlayFab/PlayFab/releases/tag/2.5.3)

## 200805

日期：2020-08-05

支援 [8 月 5 日 PlayFab 服務版本](https://github.com/PlayFab/PlayFab/releases/tag/2.5.2)

## 200730

日期：2020-07-30

支援 [7 月 15 日 PlayFab 服務版本](https://github.com/PlayFab/PlayFab/releases/tag/2.5.1)

## 200713

日期：2020-07-13

支援 [7 月 1 日 PlayFab 服務版本](https://github.com/PlayFab/PlayFab/releases/tag/2.4.3)

## 200615

日期：2020-06-15

支援 [6 月 10 日 PlayFab 服務版本](https://github.com/PlayFab/PlayFab/releases/tag/2.3.3)

## 200602

日期：2020-06-02

支援 [5 月 27 日 PlayFab 服務版本](https://github.com/PlayFab/PlayFab/releases/tag/2.3.1)

## 200518

日期：2020-05-18

支援 [5 月 13 日 PlayFab 服務版本](https://github.com/PlayFab/PlayFab/releases/tag/2.2.4)

### [UnitySDK](https://github.com/PlayFab/UnitySDK) 特定變更：

* PlayFab SDK 不再設定 Application.runInBackground = true
  * 遊戲開發人員必須負責確認在應用程式焦點變更期間或關閉之前的 API 呼叫是否成功

### [XPlat C++ SDK](https://github.com/PlayFab/XPlatCppSdk) 特定變更

* 在 CURL HTTP 實作中，會監視並處理更多 CURL 錯誤狀態
* 事件管線功能現在使用並支援背景執行緒功能
* 未設定 TitleId 時，API 方法現在會同步擲回即時例外狀況，而不是在同步或執行緒回呼中回報問題

## 200422

日期：2020-04-22

### [NodeSDK](https://github.com/PlayFab/NodeSDK) 更新：

* Hotfix
  * 修正了近期 NPM 套件遺漏重要檔案而無法匯入的問題
  * 修正了部分類型定義被錯誤設定為 "Number" 而非正確類型的問題

## 200421

日期：2020-04-21

SDK 支援截至 2020-04-21 的 PlayFab 服務。[服務版本資訊可在此取得](https://github.com/PlayFab/PlayFab/releases/tag/2.1.4)

## 200402

日期：2020-04-02

### API 變更

* [Insights](/zh-TW/services/playfab/data-analytics/legacy/insights/overview)：
  * 請參閱我們新的 [Insights](/zh-TW/services/playfab/data-analytics/legacy/insights/overview) 功能！

## 200330

日期：2020-03-30

### API 變更

* [驗證](/zh-TW/services/playfab/identity/player-identity/authentication)：
  * 為 Apple 和 Nintendo 新增了新的 [LoginIdentityProviders](/zh-TW/services/playfab/api-references/events/data-types/loginidentityprovider)
* [多人遊戲伺服器](/zh-TW/services/playfab/multiplayer)：
  * 新增了新的 BuildRegion 管理函式 [DeleteBuildRegion](https://learn.microsoft.com/en-us/rest/api/services/playfab/multiplayer/multiplayer-server/delete-build-region) 和 [UpdateBuildRegion](https://learn.microsoft.com/en-us/rest/api/services/playfab/multiplayer/multiplayer-server/update-build-region)
* [UnrealMarketplacePlugin](https://github.com/PlayFab/UnrealMarketplacePlugin)：
  * 新增了新的 [Mac 建置協助程式指令碼](https://github.com/PlayFab/UnrealMarketplacePlugin/blob/master/4.24/ExampleProject/BuildMac.sh)

### [XPlat C++ SDK](https://github.com/PlayFab/XPlatCppSdk) 特定變更

* 修正了 PlayFabEventPipeline 的一些執行緒問題

### [UnrealMarketPlacePlugin](https://github.com/PlayFab/UnrealMarketplacePlugin) 特定變更

* 安全性錯誤修正

## 200303

日期：2020-03-03

### API 變更

* server.UnlinkXboxAccountRequest 不再需要 XboxToken 即可解除連結
* 已發行 Experiments 功能和 API
  * 如需詳細資訊，請參閱我們的[部落格文章](https://api.playfab.com/blog/announcing-playfabs-experimentation-all-new-for-trustworthy-experiments)
* 新方法
  * client.LoginWithApple
  * client.LinkApple
  * client.UnlinkApple

## 200220

日期：2020-02-20

### 新功能

* 自動化 - 我們發行了新的 [PlayFab 適用的 Visual Studio Code 延伸模組](https://marketplace.visualstudio.com/items?itemName=PlayFab.playfab-explorer)。您可以在 [GitHub](https://github.com/PlayFab/vscode-playfab-explorer) 中找到原始程式碼。

### [CPP Gsdk](https://github.com/PlayFab/gsdk)- 重大變更

* 基於執行緒安全性考量，下列方法的簽章已修改：
  | 方法名稱 | 舊的傳回類型 | 新的傳回類型 |
  | - | - | - |
  | `GSDK::getConfigSettings()` | `const std::unordered_map <std::string, std::string>&` | `const std::unordered_map <std::string, std::string>` |
  | `GSDK::getLogsDirectory()` | `const std::string&` | `const std::string` |
  | `GSDK::getSharedContentDirectory()` | `const std::string& ` | `const std::string` |
  | 請參閱我們的[升級指南](https://github.com/PlayFab/gsdk/blob/main/upgradeguide200219.md) | | |

## 200218

日期：2020-02-18

### API 和文件變更：

* 新的 API 方法：
  * admin.CreateInsightsScheduledScalingTask
  * multiplayer.GetMultiplayerSessionLogsBySessionId
* 新功能和方法：
  * Cloud Script 的新機制：Azure Functions，現在可在 PlayFab 中使用
  * [功能文件](/zh-TW/services/playfab/live-service-management/service-gateway/automation/cloudscript-af)
  * 新方法清單：
    * cloudscript.ExecuteFunction
    * cloudscript.ListFunctions
    * cloudscript.ListHttpFunctions
    * cloudscript.ListQueuedFunctions
    * cloudscript.PostFunctionResultForEntityTriggeredAction
    * cloudscript.PostFunctionResultForFunctionExecution
    * cloudscript.PostFunctionResultForScheduledTask
    * cloudscript.RegisterHttpFunction
    * cloudscript.RegisterQueuedFunction
    * cloudscript.UnregisterFunction
* API 方法變更：
  * multiplayer.GetMultiplayerServerLogs 不再需要 Region 要求參數

### [CSharpSdk](https://github.com/PlayFab/CSharpSDK) 特定變更：

* 全面翻修並改善 PlayFab 多人遊戲的 QoS ping 計算

## 200213

日期：2020-02-13

PlayFab 的多人遊戲伺服器引進了名為動態待命的自動調整增強功能，可監視待命伺服器的閾值層級，並動態啟用更多遊戲伺服器的佈建，以便大規模滿足需求。此功能在多人遊戲程式設計介面中新增了一個名為 "DynamicStandby" 物件的新物件。動態待命物件是 [BuildRegionParams](https://learn.microsoft.com/en-us/rest/api/services/playfab/multiplayer/multiplayer-server/update-build-regions#buildregionparams) 物件的選擇性屬性。

動態待命是進階的遊戲伺服器功能，應謹慎地將設定從預設值進行編輯。您可以在 Game Manager 開發人員入口網站中設定動態待命，或以程式設計方式編輯動態待命物件的屬性。若要深入了解動態待命，請參閱 [PlayFab 多人遊戲伺服器](/zh-TW/services/playfab/multiplayer/servers/dynamic-standby)線上文件中的使用者指南。

## 200128

日期：2020-01-28

### 多人遊戲伺服器事件變更：

我們正在對多人遊戲伺服器事件命名慣例進行變更，以將我們的事件名稱與其餘 PlayFab 事件名稱統一。此外，我們會在多人遊戲伺服器功能成為公開預覽之前進行這些變更。變更如下：

* 多人遊戲伺服器事件名稱將更新為使用 PascalCasing
* 多人遊戲伺服器事件將不再以舊版 v1 PlayStream 事件格式傳送；僅支援 v2 PlayStream 事件格式

這兩項變更屬於重大變更，特別是對於相依於名稱非正確大小寫或多人遊戲伺服器事件之 PlayStream v1 的開發人員。對於在 Game Manager UI (Cloud Script、Insights、規則或排程工作) 中使用事件名稱的開發人員，這些變更並非重大變更。此變更將於 2020 年 2 月 26 日星期三上午 10:00 (PST) 生效。請在變更日期之前針對這些變更調整您的程式碼。

**格式變更**

一般而言，PlayFab 事件的格式類似如下：

```text theme={null}
{
   'Event Name':'my_event'
   'Payload':
   {
      'prop1':1
      'prop2':2
      'camelcase':3
      }
}
```

根本的格式變更是，事件 Payload 物件中的屬性將更新為使用 PascalCasing，以與其他 PlayStream 事件保持一致。因此，新的屬性名稱將符合下列格式：

```text theme={null}
{
   'Event Name':'my_event'
   'Payload':
   {
      'Prop1':1
      'Prop2':2
      'CamelCase':3
      }
}
```

請注意，多人遊戲伺服器事件的屬性名稱現在已更新為使用 PascalCasing。

此變更將影響在 (a) Kusto 查詢或 (b) PlayFab Cloud Script 中處理多人遊戲伺服器事件的客戶。最後，如果客戶使用 PlayFab 事件封存功能 (目前為公開預覽)，匯出的多人遊戲伺服器事件屬性也將以 PascalCasing 格式化。

**結構描述變更**

引進的第二項變更是，多人遊戲伺服器事件將僅以 PlayStream v2 格式傳遞，不再使用舊版 PlayStream v1 格式。

PlayFab 目前支援兩種事件結構描述。

| 結構描述格式 | 描述 | 多人遊戲事件命名空間值 |
| - | - | - |
| PlayStream V1 | 以玩家事件為中心設計 | com.playfab.events.multiplayer |
| PlayStream V2 | 以實體事件為中心設計 | playfab.servers |

一般而言，PlayFab API 會以 PlayStream V1 格式或 PlayStream V2 格式產生事件。例如，授與玩家物品的 API 會產生 PlayStream V1 事件，而授與實體物品的 API 則會產生 PlayStream V2 事件。

由於多人遊戲伺服器是在 PlayStream V2 推出的同時或前後以公開預覽推出，因此多人遊戲伺服器功能同時支援 PlayStream V1 和 V2 格式。這表示每個多人遊戲伺服器 API 呼叫都會產生兩個事件；一個是 V1 格式，一個是 V2 格式。

為了移除重複項目，'com.playfab.events.multiplayer.servers' 命名空間中的多人遊戲伺服器事件即將淘汰。'playfab.servers' 命名空間中的事件將繼續受到支援。

若要區分 V1 和 V2 格式的多人遊戲伺服器事件，請檢查事件的 namespace 屬性。命名空間指定於上表的第三欄。JSON 表示法類似下列格式：

```text theme={null}
{
   'FullName':
   {
      'Namespace':'abc',
      'Name':'xyz'
   }
}
```

要搜尋的屬性名為 `Namespace`。

## 200121

日期：2020-01-21

### API 和文件變更：

* PlayFab API 文件網站已完全移轉至 [/gaming/playfab](https://learn.microsoft.com/en-us/gaming/services/playfab/)
  * 大部分的 `api.playfab.com` 連結都已轉換為對應的 `learn.microsoft.com` 連結
  * 大部分的原始連結都會正確重新導向至新網站
  * 如果有任何舊連結無法運作，請在[論壇](https://community.playfab.com/index.html)中告知我們
* 新的 API 方法：
  * multiplayer.ListServerBackfillTicketsForPlayer
  * multiplayer.GetServerBackfillTicket
  * multiplayer.CreateServerBackfillTicket
  * multiplayer.CancelServerBackfillTicket
  * multiplayer.CancelAllServerBackfillTicketsForPlayer
  * server.UnlinkPSNAccount
  * server.LinkPSNAccount

### [LuaSdk](https://github.com/PlayFab/LuaSdk) 特定變更：

* 小型登入錯誤修正

### [PhpSdk](https://github.com/PlayFab/PhpSdk) 特定變更：

* 為了嚴格正確性所做的小型語法修正

### [UnitySDK](https://github.com/PlayFab/UnitySDK) 特定變更：

* 更新 GitHub 存放庫和專案結構。
  * 將 Unity EdEx 套件從 (UnityEditorExtensions)\[[https://github.com/PlayFab/UnityEditorExtensions](https://github.com/PlayFab/UnityEditorExtensions)] 移至 (UnitySdk)\[[https://github.com/PlayFab/UnitySDK/blob/master/Packages/PlayFabEditorExtensions.unitypackage](https://github.com/PlayFab/UnitySDK/blob/master/Packages/PlayFabEditorExtensions.unitypackage)]
  * 未來，我們也將逐步淘汰獨立的 UnityEditorExtensions 存放庫


## Related topics

- [PlayFab Party 版本資訊](/zh-TW/services/playfab/multiplayer/networking/release-notes.md)
- [版本資訊](/zh-TW/tools/tools-pc/xbox-pc-remote-tools/release-notes/index.md)
- [PlayFab Party XBOX Live 協助程式版本資訊](/zh-TW/services/playfab/multiplayer/networking/party-xboxlive-relnotes.md)
- [PlayFab 2017 版本資訊](/zh-TW/services/playfab/release-notes/2017.md)
- [PlayFab 2019 版本資訊](/zh-TW/services/playfab/release-notes/2019.md)