PlayFab 2020 年版本資訊 - XBOX Game Development Documentation

如需服務版本與產品更新的版本資訊，請參閱 PlayFab 公開 GitHub 存放庫上的版本資訊一節

201218

日期：2020-12-18

次要錯誤修正

201207

日期：2020-12-07 支援 12 月 2 日 PlayFab 服務版本

201119

日期：2020-11-19

UnitySDK 特定變更

修正 Unity 2020 中過多的記錄訊息
現已完整支援 Unity 2020

201027

日期：2020-10-27 支援 9 月 2 日 PlayFab 服務版本已對 API 進行次要更新。

201014

日期：2020-10-14 支援 9 月 2 日 PlayFab 服務版本 (也支援 Experimentation API 中的新方法，這些方法將在近期的服務版本中推出) PlayFab 致力於讓您能使用我們的服務，透過各種遊戲引擎與架構開發跨平台及跨裝置的遊戲。為了協助我們更專注於建立您所需的新功能，我們將下列 SDK 開放給社群貢獻。如果您有其他問題或需要支援，請前往 PlayFab 社群論壇。這將是我們對下列 SDK 的最後一次官方更新：

200914

日期：2020-09-14 支援 9 月 2 日 PlayFab 服務版本

200901

日期：2020-09-01 支援 8 月 26 日 PlayFab 服務版本

200817

日期：2020-08-17 支援 8 月 12 日 PlayFab 服務版本

200805

日期：2020-08-05 支援 8 月 5 日 PlayFab 服務版本

200730

日期：2020-07-30 支援 7 月 15 日 PlayFab 服務版本

200713

日期：2020-07-13 支援 7 月 1 日 PlayFab 服務版本

200615

日期：2020-06-15 支援 6 月 10 日 PlayFab 服務版本

200602

日期：2020-06-02 支援 5 月 27 日 PlayFab 服務版本

200518

日期：2020-05-18 支援 5 月 13 日 PlayFab 服務版本

UnitySDK 特定變更：

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

XPlat C++ SDK 特定變更

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

200422

日期：2020-04-22

NodeSDK 更新：

緊急修正
- 修正最近的 NPM 套件遺漏關鍵檔案而無法匯入的問題
- 修正部分型別定義被錯誤設定為 “Number” 而非正確型別的問題

200421

日期：2020-04-21 SDK 支援截至 2020-04-21 的 PlayFab 服務。服務版本資訊請見此處

200402

日期：2020-04-02

API 變更

Insights：
- 歡迎查看我們全新的 Insights 功能！

200330

日期：2020-03-30

API 變更

Authentication：
- 新增 Apple 與 Nintendo 的 LoginIdentityProviders
Multiplayer Server：
- 新增 BuildRegion 管理函式 DeleteBuildRegion 與 UpdateBuildRegion
UnrealMarketplacePlugin：
- 新增 Mac 建置協助程式指令碼

XPlat C++ SDK 特定變更

修正 PlayFabEventPipeline 的部分執行緒問題

UnrealMarketPlacePlugin 特定變更

安全性錯誤修正

200303

日期：2020-03-03

API 變更

server.UnlinkXboxAccountRequest 不再需要 XboxToken 即可取消連結
Experiments 功能與 API 已正式發行
- 如需詳細資訊，請參閱我們的部落格文章
新方法
- client.LoginWithApple
- client.LinkApple
- client.UnlinkApple

200220

日期：2020-02-20

新功能

自動化 - 我們發行了新的 PlayFab 適用的 Visual Studio Code 延伸模組。您可以在 GitHub 中找到原始程式碼。

CPP 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`

請參閱我們的升級指南

200218

日期：2020-02-18

API 與文件變更：

新的 API 方法：
- admin.CreateInsightsScheduledScalingTask
- multiplayer.GetMultiplayerSessionLogsBySessionId
新功能與方法：
- Cloud Script 的新機制：Azure Functions 現在可以在 PlayFab 中使用
- 功能文件
- 新方法清單：
  - 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 特定變更：

全面改善 PlayFab Multiplayer 的 QoS ping 計算方式

200213

日期：2020-02-13 PlayFab 的 Multiplayer Servers 推出名為 Dynamic Standby 的自動調整增強功能，可監視待命伺服器的閾值等級，並動態啟用更多遊戲伺服器的佈建，以便大規模滿足需求。此功能會在 Multiplayer 程式設計介面中新增一個名為 “DynamicStandby” 的物件。Dynamic Standby 物件是 BuildRegionParams 物件的選用屬性。 Dynamic Standby 是進階的遊戲伺服器功能，將其設定從預設值變更時應謹慎為之。您可以在 Game Manager 開發人員入口網站中設定 Dynamic Standby，或以程式設計方式編輯 Dynamic Standby 物件的屬性。若要深入了解 Dynamic Standby，請參閱 PlayFab Multiplayer Servers 線上文件中的使用者指南。

200128

日期：2020-01-28

Multiplayer Server 事件變更：

我們將變更 Multiplayer Server 事件的命名慣例，以便讓我們的事件名稱與其他 PlayFab 事件名稱一致。此外，我們會在 Multiplayer Server 功能進入公開預覽之前進行這些變更。變更內容如下：

Multiplayer Server 事件名稱將更新為使用 PascalCasing
Multiplayer Server 事件將不再以舊版 v1 PlayStream 事件格式傳送；僅支援 v2 PlayStream 事件格式

這兩項變更屬於中斷性變更，特別是對於依賴非正確大小寫名稱或 Multiplayer Server 事件之 PlayStream v1 的開發人員。對於在 Game Manager UI (cloud script、insights、rules 或 scheduled tasks) 中使用事件名稱的開發人員，這些變更不屬於中斷性變更。此變更將於 2020 年 2 月 26 日星期三上午 10:00 (PST) 生效。請在變更日期之前針對這些變更調整您的程式碼。 格式變更 一般而言，PlayFab 事件的格式類似於：

{
   'Event Name':'my_event'
   'Payload':
   {
      'prop1':1
      'prop2':2
      'camelcase':3
      }
}

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

{
   'Event Name':'my_event'
   'Payload':
   {
      'Prop1':1
      'Prop2':2
      'CamelCase':3
      }
}

請注意，Multiplayer 伺服器事件的屬性名稱現在已更新為使用 PascalCasing。此變更將影響在 (a) Kusto 查詢或 (b) PlayFab cloud script 中處理 Multiplayer 伺服器事件的客戶。最後，如果客戶使用 PlayFab Event Archive 功能 (目前為公開預覽)，匯出的 Multiplayer 伺服器事件屬性也會以 PascalCasing 格式化。 結構描述變更 第二項變更是 Multiplayer 伺服器事件將只以 PlayStream v2 格式傳遞，而不再以舊版 PlayStream v1 格式傳遞。 PlayFab 目前支援兩種事件結構描述。

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

一般而言，PlayFab API 會以 PlayStream V1 格式或 PlayStream V2 格式產生事件。例如，授予玩家物品的 API 會產生 PlayStream V1 事件；而授予實體物品的 API 則會產生 PlayStream V2 事件。由於 Multiplayer Servers 推出公開預覽的時間與 PlayStream V2 推出的時間相同或相近，因此 Multiplayer Server 功能同時支援 PlayStream V1 與 V2 格式。也就是說，每個 Multiplayer Server API 呼叫都會產生兩個事件：一個為 V1 格式，一個為 V2 格式。為了移除重複項目，‘com.playfab.events.multiplayer.servers’ 命名空間中的 Multiplayer 伺服器事件即將淘汰。‘playfab.servers’ 命名空間中的事件將繼續受到支援。若要區分 V1 與 V2 格式的 Multiplayer Server 事件，請檢查事件的 namespace 屬性。命名空間列於上表的第三欄。其 JSON 表示法類似下列格式：

{
   'FullName':
   {
      'Namespace':'abc',
      'Name':'xyz'
   }
}

要搜尋的屬性名稱為 Namespace。

200121

日期：2020-01-21

API 與文件變更：

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

LuaSdk 特定變更：

次要登入錯誤修正

PhpSdk 特定變更：

為嚴格正確性進行的次要語法修正

UnitySDK 特定變更：

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

​201218

​201207

​UnrealMarketplacePlugin 特定變更

​201119

​PostmanCollection 特定變更

​UnitySDK 特定變更

​XPlat C++ SDK 特定變更

​201027

​201014

​200914

​200901

​200817

​200805

​200730

​200713

​200615

​200602

​200518

​UnitySDK 特定變更：

​XPlat C++ SDK 特定變更

​200422

​NodeSDK 更新：

​200421

​200402

​API 變更

​200330

​API 變更

​XPlat C++ SDK 特定變更

​UnrealMarketPlacePlugin 特定變更

​200303

​API 變更

​200220

​新功能

​CPP Gsdk- 中斷性變更

​200218

​API 與文件變更：

​CSharpSdk 特定變更：

​200213

​200128

​Multiplayer Server 事件變更：

​200121

​API 與文件變更：

​LuaSdk 特定變更：

​PhpSdk 特定變更：

​UnitySDK 特定變更：

201218

201207

UnrealMarketplacePlugin 特定變更

201119

PostmanCollection 特定變更

UnitySDK 特定變更

XPlat C++ SDK 特定變更

201027

201014

200914

200901

200817

200805

200730

200713

200615

200602

200518

UnitySDK 特定變更：

XPlat C++ SDK 特定變更

200422

NodeSDK 更新：

200421

200402

API 變更

200330

API 變更

XPlat C++ SDK 特定變更

UnrealMarketPlacePlugin 特定變更

200303

API 變更

200220

新功能

CPP Gsdk- 中斷性變更

200218

API 與文件變更：

CSharpSdk 特定變更：

200213

200128

Multiplayer Server 事件變更：

200121

API 與文件變更：

LuaSdk 特定變更：

PhpSdk 特定變更：

UnitySDK 特定變更：