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 錯誤狀態
事件管線功能現在使用並支援背景執行緒功能
未設定 TitleId 時，API 方法現在會同步擲回即時例外狀況，而不是在同步或執行緒回呼中回報問題

200422

日期：2020-04-22

NodeSDK 更新：

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

200421

日期：2020-04-21 SDK 支援截至 2020-04-21 的 PlayFab 服務。服務版本資訊可在此取得

200402

日期：2020-04-02

API 變更

Insights：
- 請參閱我們新的 Insights 功能！

200330

日期：2020-03-30

API 變更

驗證：
- 為 Apple 和 Nintendo 新增了新的 LoginIdentityProviders
多人遊戲伺服器：
- 新增了新的 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 多人遊戲的 QoS ping 計算

200213

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

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 事件的格式類似如下：

{
   '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
      }
}

請注意，多人遊戲伺服器事件的屬性名稱現在已更新為使用 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 表示法類似下列格式：

{
   '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

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

​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

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

200121

API 和文件變更：

LuaSdk 特定變更：

PhpSdk 特定變更：

UnitySDK 特定變更：