跳轉到主要內容

​
171204

日期：2017 年 12 月 4 日

​
Unreal SDK 變更 (Cpp 與 Bp)

  • 已將兩個 SDK 更新至 Unreal 4.18.1。
  • 舊版仍可運作，但需要取消註解 _.build.cs 檔案中的 #defines。

​
171127

日期：2017 年 11 月 27 日

​
API 變更

  • 允許「限量版」(Limited Edition) 物品的庫存功能現已結束搶鮮版並正式發行。
  • 此功能可讓您定義遊戲中特定 itemId 僅提供固定數量。
  • 已從使用「ProfileModel」的 API 方法中移除虛擬貨幣屬性，因為該資訊從未提供過，也從未正確過。它總有一天會回來的。

​
新的 API 方法

​
已更新的 API 方法錯誤碼

​
SDK 特定更新

  • UnitySdk：我們現在使用 Unity 2017.2.0f3 建置所有發佈的 Unity 套件檔案。
  • 為了進行測試，我們在內部將每個 major.minor 版本更新至最新版本，範圍從 Unity 4.7.2f1 到 2017.1.2f1。
  • Unity 範例測試遊戲伺服器：已對 HttpHelper 套用修正，以修正 SignalR 要求的 SSL 驗證。
  • ActionScriptSDK：範例中的 AirSdk 已更新至 v27。
  • Cocos2d-xSDK：儘管 Cocos 已發行 3.16，我們仍以 3.15.1 為目標 (敬請期待)。
  • SdkTestingCloudScript 與 NodeSDK：已更新範例 VS 專案以支援 VS/msbuild 2017。
  • WindowsSDK：這是以 Visual Studio 2013 為目標的 NuGet 套件的最後一個組建：

​
171106

日期：2017 年 11 月 6 日

​
新的 API 方法

​
已更新的 PlayStream 事件

  • sent_email 新增了欄位：Body 與 Subject。

​
所有 SDK

  • 次要 SDK 中斷性變更：ForgetClientCredentials() 已重新命名為 ForgetAllCredentials()。
  • 這是「即將推出」功能的一部分，完成時將會公告。

​
171102

日期：2017 年 11 月 2 日

​
新的 PlayFab 功能

  • 使用範本傳送電子郵件給您的玩家。

​
新的 API 方法

​
文件更新

​
新的 PlayStream 事件

​
Unreal 特定更新

  • 我們的自動建置器未能發佈組建編號 171016 與 171026 的 Unreal SDK。我們已解決自動建置器的問題，事後發佈了 171026 版，且發行作業已恢復正常

​
Unity 特定變更

  • **次要中斷性變更：**已將 ForgetClientCredentials 重新命名為 ForgetAllCredentials。
  • 這是即將推出之新功能的一部分。在接下來的幾個版本中，我們會在所有 SDK 中將 ForgetClientCredentials 重新命名為 ForgetAllCredentials。

​
171026

日期：2017 年 10 月 26 日

​
API 文件變更

  • 正在更新 API 方法的錯誤碼。
  • 已從各 API 方法的清單中移除許多適用於所有 API 方法的通用錯誤碼。新的頁面會說明通用錯誤碼。
  • 已移除的通用錯誤碼：
    • InvalidParams
    • OverLimit
    • DataUpdateRateExceeded
    • AccountBanned
  • 這些錯誤 (以及其他將在另一份文件中發佈的錯誤) 可能從任何 API 方法傳回，且應妥善處理。
  • 已為數十個 API 方法新增錯誤碼，並移除一些錯誤的錯誤碼。錯誤碼清單對於方法特定的錯誤傳回應會更加準確。這仍是持續進行中的工作，因此還會有更多更新。
  • 數個涉及虛擬貨幣的 API 方法可能會將餘額減少至低於零。我們已為這些方法加上適當的標示。

​
API 變更

  • 新的 API 方法：
    • admin.DeleteTitle
    • 託管的遊戲伺服器同時支援 IPv4 與 IPv6。
    • 自訂遊戲伺服器現在支援 IPV6。所有新啟動的遊戲伺服器執行個體都會同時獲指派 IPV4 與 IPV6 位址，這些位址會顯示在 Game Manager 的 Servers 索引標籤中，並由配對 API 傳回。用戶端可以連線至所指派伺服器的 IPV4 或 IPV6 位址。
    • 所有傳回伺服器位址的 API 方法現在都會傳回這兩個選項：client.StartGame.StartGameResult

​
Game Manager 變更

  • 您現在可以使用新的 Admin/DeleteTitle API，或在 Game Manager 的工作室頁面上刪除標題，如下圖所示。 DelTitleGameManager

​
171016

日期：2017 年 10 月 16 日

​
API 變更

​
新的 PlayStream 事件

​
JavaScriptSDK 特定變更

​
LuaSDK 特定變更

  • LuaSDK
    • 已修正我們的 Lua 發佈管線，LuaSDK 再次正常更新。

​
UnitySdk 特定變更

UnrealCppSdk 特定變更： (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)
  • 我們的一位客戶為我們的 SDK 製作了附加元件外掛程式，整合了 Unreal OnlineSubsystem 與 PlayFab SDK
  • 您可以在這裡查看。

​
Unicorn Battle 範例

  • 已刪除 PlayFab 自訂推播外掛程式，並更新為 FCM 推播訊息。

​
170925

日期：2017 年 9 月 5 日

​
API 變更

  • 已移除少數從未公開的搶鮮版 API。這應不會影響任何現有客戶或已上線的標題。
  • 我們略過了 CloudScript 引擎中預設的語言層級標頭檢查。這表示先前遭到拒絕的數個 CloudScript http.request() 標頭現在應可正常運作。

​
全域推播通知更新

​
新的 PlayStream 事件

  • player_device_info
  • 使用最新 UnitySDK 的遊戲現在可以查看其客戶的一些基本分析資料。SnowFlake 非常適合用來檢視與分析這些資訊，但您也可以在 PlayStream 事件歷程記錄中取得。
  • player_updated_membership

​
JavaScriptSDK 特定變更

  • JavaScriptSDK
    • 已將其他 SDK 中既有的少數小功能新增至 JavaScriptSDK：
    • 您現在可以將額外的標頭插入要求中 (移除了此 SDK 支援雙重加密登入的其中一個障礙)。
    • 新增了一個函式：PlayFabClientSDK.ForgetClientCredentials()
    • 這是一個便利函式，可在關閉或登出後重設用戶端。
    • PlayFab.GenerateErrorReport()
    • 這是一個便利函式，可將失敗之 PlayFab 呼叫的錯誤結果轉換成單一且完整的呼叫失敗說明。
  • 已在 PlayFab API 要求中新增選用的資料轉送：
    • result.customData
      • 這是您可以附加至要求的任何內容物件，可為結果提供內容。例如，您可以將本機用戶端玩家物件提供為 UpdatePlayerStatistics 呼叫的 customData，並在遠端呼叫成功後，於該玩家上設定更新後的統計資料。
    • result.request
      • 您的 API 呼叫要求現在會轉送至結果，可為結果提供內容。例如，當您呼叫 UpdatePlayerStatistics 時，可以在更新本機玩家物件時，從要求中讀取更新後的統計資料。

​
UnitySDK 特定變更

  • UnitySDK
    • 新的實驗性功能：此版本的 PlayFab UnitySDK 現在可讓您選擇性地查看玩家的裝置資訊。您可以查看的資訊範例包括：記憶體、解析度、使用者代理程式、裝置類型、作業系統版本等。
UnrealCppSdk 特定變更： (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)
  • 已更新至 Unreal 4.17
  • 拆分成三個獨立的外掛程式，各自具有不同的功能
  • 整體大幅升級

​
170828

日期：2017 年 8 月 28 日

​
Client API 變更

  • client.[GetCurrentGames].[result].Games[i].GameServerState 已淘汰，並由 [GameServerStateEnum] 取代。 - GameServerState 先前序列化為整數，這是一個錯誤。新欄位是正確的列舉字串。 (已更新：此項目已淘汰。請參閱 Servers)

​
其他 API 變更

​
新的 PlayStream 事件

​
170814

日期：2017 年 8 月 14 日

​
API 更新

​
CSharpSdk 特定更新

  • SDK 現在包含名為 NewtonSoftJsonWrapper.cs 的檔案，可讓您將我們內含的 SimpleJson 序列化程式替換為 NewtonSoft NuGet 套件。
  • 該檔案包含使用說明。

​
170807

日期：2017 年 8 月 7 日

​
新的 API 方法

​
已淘汰的 API 方法

  • 這些 API 方法從未如預期般完整運作。為了改善這個情況，我們重新開始，建置了上一節中新的 DeletePlayer API，而下列方法已淘汰：
  • admin.ResetUsers
  • admin.DeleteUsers

​
API 更新

  • PlayerProfile (位於 Admin/Server/PlayStream) 包含新欄位 ContactEmailAddresses，其中包含您可能已儲存的玩家電子郵件地址資訊。

​
PlayStream 事件

LumberyardSdk 變更：
  • **升級警告：**此 SDK 不再與舊版 Lumberyard 相容。
  • 此版本的 PlayFab LumberyardSdk 不再適用於 Lumberyard 1.3 版。它已升級，現在以 Lumberyard 1.9 為目標。我們可能很快就會以 1.10 為目標，但同樣不會回溯相容於 1.9 或更早版本。如需詳細資訊，請參閱我們的部落格。
UnrealCppSdk： (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)。 Unreal SDK： (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)
  • PlayFab UnrealBlueprintSdk 現已重新命名為「Unreal SDK」
  • Unreal SDK 已更新至 4.16，並包含一些次要修正
  • 我們也將移除對舊版 Unreal 的支援，這些版本需要舊版 Visual Studio
  • 我們現在支援 4.14 到 4.16
  • 您的專案可能仍可在舊版 Visual Studio 上運作，但我們只能支援及測試 Visual Studio 2015 及更新版本
  • 如需詳細資訊，請閱讀我們的部落格

​
Unity Editor Extensions

  • 已修正下載與上傳 CloudScript 修訂版本的問題。
  • 已修正系統語言使用非 ASCII 字母之使用者的問題。

​
170710

日期：2017 年 7 月 10 日

​
API 變更

​
SDK 中斷性變更

  • admin.SetupPushNotificationRequest.Platform 現在定義為列舉，而非字串。這對 API 而言並非中斷性變更 (因為列舉是以字串傳輸)，但部分使用者需要在程式碼中將其字串轉換為列舉值。

​
所有 SDK 中的變更

  • 次要 SDK 中斷性變更：大部分 SDK 已在多個要求中移除名為 UseSpecificVersion 的選用欄位，此欄位是將相鄰 Version 欄位定義為 null 的替代方式。並非所有語言都能在要求中將整數定義為 null，而此欄位原本只打算在相關的 SDK 中使用 (特別是 Unreal)。如果您正在使用此欄位，只要將其移除，並在適當時將相鄰的 Version 欄位設為 null 即可。

​
Unity EditorExtensions 更新

  • 已更新旗標面板。
  • 現在可以切換 ENABLE/DISABLE_IDFA 旗標。
  • 會顯示非 PlayFab 的旗標，並讓您將其移除 (請謹慎使用，不要移除您需要的旗標)。

​
SDK 相依性更新

  • UnitySDK 已使用 Unity2017.1.0f1 建置、封裝及測試。
    • 僅有細微、非中斷性的變更。
  • ActionScriptSDK 已使用 AirSDK v26 測試。
    • SDK 未變更，範例已更新為以 v26 為目標。
  • Cocos2d-xSDK 已使用 Cocos 3.15.1 建置及測試。
  • Cocos 3.14->3.15 包含會中斷我們範例的變更，因此範例必須更新。範例仍可在 3.13 到 3.15 上運作，但可能無法在較舊版本的 Cocos 上運作。SDK 未變更，應可在大部分最新的 3.X Cocos 版本上運作。

​
170612

日期：2017 年 6 月 12 日

​
文件變更

  • 為了清楚起見，對數十個 API 方法進行了許多小幅修訂
  • 已將數個各只包含單一 API 方法的文件群組合併為名為「Platform Specific Methods」的單一群組。
  • 已將「Matchmaking APIs」群組重新命名為「Matchmaking」，以與其他群組保持一致。
  • 許多有長度限制的字串欄位現在會說明允許的範圍。

​
所有 SDK 中的變更

  • 已更新並修正所有 SDK README 中的許多失效連結。

​
UnitySDK 特定變更

  • UnitySDK
    • 我們現在支援多個版本的 Android API 與 Google Play Services。請在這裡閱讀更多詳細資訊。
    • 目前對 Unity + Android 推播外掛程式的規劃變更到此告一段落。如果您有任何其他要求，請在這裡告訴我們。

​
170530

日期：2017 年 5 月 30 日

​
API 變更

  • **中斷性變更：**在 server.ReportPlayer 中，我們立即移除了 ReportPlayerServerRequest 中的 titleId 欄位 (不只是淘汰)。所有檢舉現在都會送往其所屬的標題，且無法檢舉至其他標題。
    • 這必須是中斷性變更，否則會構成輕微的跨標題漏洞。如果您需要此變更的協助，請與我們連絡。
  • 在 client.ReportPlayer 與 server.ReportPlayer 中，我們在兩種情況下都淘汰了 result.Updated。它一律為 true，而如果玩家超過檢舉限制，API 呼叫會傳回錯誤。我們已將此錯誤狀況變更為 OverLimit，以與其他限制一致。
  • 所有登入方法現在都可以在要求時傳回玩家設定檔物件，其中包含先前只有排行榜結果才能取得的資訊。

​
新的 API 方法

​
文件

  • 小幅更新，數個範例不再包含已淘汰欄位的相關資訊。
  • 已定義 ExecuteCloudScript 的傳回值與記錄大小限制。

​
新的 PlayStream 事件

​
UnitySDK 特定變更

​
CSharpSDK 特定變更

  • CSharpSDK
    • 現在可以指定要插入 API 要求中的額外標頭。
    • 這是僅限 Enterprise 的功能，專門用於雙重加密的登入要求。

​
170508

日期：2017 年 5 月 8 日

​
API 變更

  • 中斷性變更：
  • 在上述任一情況下，呼叫仍會傳回 200/成功，但 FunctionResult 和/或 Logs 屬性會是 null。

​
PlayStream 事件變更

​
CSharpSDK 更新

  • CSharpSDK
    • 已刪除 CSharpSDK 中一些未使用的原始檔。
    • 這應不會影響任何現有專案或 NuGet 套件，因為 Visual Studio 方案並未參考這些檔案。

​
Postman 集合更新

  • 數個常見的要求參數現在使用環境變數。
  • 具體來說，TitleId={{TitleId}}、PlayFabId={{PlayFabId}}、CharacterId={{CharacterId}} 與 CatalogVersion={{PrimaryCatalogName}}

​
170424

日期：2017 年 4 月 24 日

​
SDK Hotfix 版本

  • JavaSDK 更新：
    • 我們現在會發佈 SDK 的 Jar 檔案，一個用於程式碼，一個用於 Java 文件，您可以將其匯入 Java 專案，而不必複製貼上程式碼。感謝 Will Iverson 協助我們改善 JavaSDK 的可用性
  • UnityEditorExtensions 更新：
    • 我們已解決一些安裝時的例外狀況。具體來說，首次安裝後不再需要重新啟動 Unity。
    • 此外，Client API 有時遭到不當停用的問題現已修正。(已編輯)
  • UnrealCppSdk 更新： (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)
  • 現在可以從外掛程式介面取得 titleId

​
170411

日期：2017 年 4 月 11 日

​
API 變更

  • 新的 Enterprise 功能：更多登入加密
  • 您可以使用原則 API 方法，強制要求登入呼叫使用第二層加密
  • 請參閱：UpdatePolicy，特別是 UpdatePolicyRequest.Statements.ApiConditions
  • 此功能仍有部分處於搶鮮版，不建議啟用 (目前還不建議，即將推出！)

​
新的 PlayStream 事件

​
UnitySDK 特定變更

  • 現在可以指定要插入 API 要求中的額外標頭 (上一節中的加密登入呼叫需要此功能)。

​
UnityEditorExtensions 特定變更

  • 已修正 Unity 5.6 的編譯問題。

​
170406

日期：2017 年 4 月 6 日

​
Unity Android 推播外掛程式的 Hotfix

  • 已修正 Android 7.0+ 當機錯誤。
  • 已修正 Android 缺少大型圖示支援的問題 (Lollipop+)。
  • 已修正 Android 7.0+ 上的 Android 小型圖示支援 (現在支援 _transparent.png)。

​
170403

日期：2017 年 4 月 3 日

​
API 變更

  • **Client 與 Server 排行榜方法：**Get-Leaderboard 方法 (例如 client.GetLeaderboard) 先前新增了不可為 null 的參數 Version 與 UseSpecificVersion。要求它們不可為 null 是一項 API 中斷性變更。我們已將這些屬性更新為完全選用。
  • Client API：GetPurchaseResult 的 Items 欄位已淘汰：結果的這個部分經常不正確或不完整。它最終會由功能完整的參數取代。

​
新的 PlayStream 事件

  • player_display_name_filtered
Unreal 特定變更： (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)
  • UnrealCppSdk：已修正發佈組建時遺失 TitleId 等 PlayFab 設定的問題。 兩個 SDK 都已在 Unreal 4.15 上測試並驗證可正常運作

​
JavaSDK 特定變更

  • JavaSDK
    • 已重新調整 JavaSDK 的資料夾結構與測試。
    • 存放庫的內部資料夾結構已稍作變更，以符合 Maven 最佳做法。
    • 相依性現在由 Maven 控制，不再隨附於 SDK 中。
    • 已將我們的內部自動化測試轉換為 Maven 命令列。
    • 我們的 SDK 無法在 Maven Central 上取得，因為該工作已停滯。目前沒有預計完成時間。

​
UnitySDK 特定變更

  • UnitySDK
    • 用於測試及建置資產套件組合的內部 Unity 版本已更新至 5.6.0。我們的 Unity SDK 仍與 Unity 4.7 到 5.6 的所有版本相容。
    • 已修正 Unity 5.6 中 UnityEditorExtensions 的編譯問題。

​
170223

日期：2017 年 2 月 22 日

​
API 變更

  • PlayFab 排行榜現在會為每位玩家儲存頭像 URL。這可用來為排行榜項目參考玩家圖片。
  • 所有排行榜 API 現在都可以擷取特定版本的排行榜。這適用於設定為使用重設排行榜的標題。
  • 排行榜項目現在包含 PlayerProfile，可用來顯示更詳細的排行榜，而不需要額外的 API 呼叫
  • PlayFab 現在可以使用 Windows Hello 驗證用戶端，並驗證 Windows 市集收據

​
新的 API

​
新的 PlayStream 事件

​
WindowsSDK 特定變更

  • 已在 JSON 序列化程式中新增一些遺漏的 null 檢查。

​
所有 SDK

  • 對 testTitleData 格式的小幅新增。這僅適用於 SDK 隨附的範例測試專案。

​
170130

日期：2017 年 1 月 29 日

​
中斷性變更

  • 隨著今天的主要版本發行，我們變更了 JavaScriptSDK 與 NodeSDK 的資料夾結構。當您升級時，這可能會導致專案中的某些連結中斷。(檔案名稱與檔案內容並未變更。現在新增了先前不存在的 TypeScript 檔案。)

​
API 變更

  • 已在 CDN API 中新增說明文件。特別指出 CDN 不屬於我們的免費服務。
  • Google 登入修正 (部落格文章即將發佈)。

​
新的 PlayStream 事件

​
JavaScriptSDK 特定變更

  • JavaScriptSDK
    • 主要升級的發行日！版本號碼已更新至 1.0。
    • TypeScript 整合！
    • 存放庫清理：將 SDK 檔案與範例檔案分開。
    • 已將我們的範例專案轉換為 TypeScript。
    • 請參閱我們的部落格！

​
NodeSDK 特定變更

  • NodeSDK
    • 主要升級的發行日！版本號碼已更新至 1.0
    • TypeScript 整合！
    • 已將我們的範例專案轉換為 TypeScript
    • 請參閱我們的部落格！

​
CloudScript 範例

​
UnitySDK 特定變更

  • UnitySDK
    • 已修正 JsonWrapper 並非在所有情況下都能如預期運作的問題。
    • 如需詳細資訊，請參閱我們的論壇文章：https://community.playfab.com/questions/7599/cloudscript-getplayercombinedinfo-little-problem.html
    • 已移除下列所有已淘汰的包裝函式類別，改用 PlayFab.Json.JsonWrapper：
      • PlayFab.Json.JsonConvert (請使用 PlayFab.Json.JsonWrapper)
      • PlayFab.Json.SimpleJson (請使用 PlayFab.Json.JsonWrapper 或 PlayFab.Json.PlayFabSimpleJson)
      • PlayFab.SimpleJson (請使用 PlayFab.Json.JsonWrapper 或 PlayFab.Json.PlayFabSimpleJson)
    • 重申 160627 中的說明：UnityEngine.SimpleJson 是 UnityEngine.dll 中的空命名空間，因此我們必須避免使用該識別碼。

​
Unity Editor Extensions

  • 已解決當您的帳戶無法檢視任何工作室時，PlayFab 面板會無限重新載入的問題。
  • 已解決當您從 PlayFab 面板挑選標題時，PlayFabSharedSettings (Scriptable Object) 無法正確儲存的問題。

​
170109

日期：2017 年 1 月 8 日

​
中斷性變更

  • 已移除舊版 WindowsSDK 中的 lib，必須在 Visual Studio 中重新建立。這些 lib 從未在 vs2015 中運作過，因此強烈建議您直接更新至上週發佈的最新 WindowsSDK。

​
API 變更

  • 已修正文件中的錯字。

​
所有 SDK

​
SDKGenerator 特定變更

​
UnitySdk 特定變更

  • UnitySdk
    • PlayFabSettings 中的一些公用元素已加上 Obsolete 標記：PlayFabSettings.PlayFabSharedSettings PlayFabSettings.DefaultPlayFabApiUrl PlayFabSettings.GetSharedSettingsObject() PlayFabSettings.ProductionEnvironmentUrl
這些元素將在過渡期後設為私用。

​
WindowsSDK 特定變更

  • 已對 GitHub 存放庫執行 BFG，並從歷程記錄中移除所有大型檔案。請刪除您的複製或分支，然後重新建立，讓您的歷程記錄保持乾淨。

​
170102

日期：2017 年 1 月 1 日

​
API 變更

  • Client/GetUserCombinedInfo 已轉換為完全過時，我們已將其從 SDK 與文件中移除。

​
Cocos2d-xSDK 特定變更

  • Cocos2d-xSDK
    • 已修正 PlayFab API 傳回無效回應時的當機問題。
    • 已解決一些編譯器警告。
    • 已在我們的測試範例專案中新增 Lambda 回呼函式的單元測試。

​
UnitySDK 特定變更

  • UnitySDK
    • 我們已在內部更新至 Unity 5.5，且我們的 .unitypackage 檔案是使用此版本建置的
    • 一如往常，我們會繼續支援 Unity 4.7 及更新的所有版本。
    • 已在許多靜態類別中新增靜態建構函式，以穩固 Mono2x 編譯器中的初始化順序。這應可解決我們在 iOS 中看到的一些 PlayFabSharedSettings 問題。
    • IDFA/ADID 現在可在 Unity 5.6 搶鮮版中正常運作。
    • **已知問題：**Unity 5.6 搶鮮版組建無法在 Windows Server (OS) 上運作，其中包括 PlayFab 遊戲伺服器託管。如果這對您造成影響，請與 Unity 連絡。

​
WindowsSDK 特定變更

最後修改於 2026年11月6日