跳轉到主要內容

​
161121

日期：2016 年 11 月 20 日

​
API 變更

  • 現在可以個別啟用或停用每個 Client API。
  • 如需詳細資訊，請參閱我們的部落格文章。
  • 我們即將發行一項名為「排程工作」的新功能。
  • 如需詳細資訊，請參閱我們的部落格文章：(即將推出)。

​
新 API

​
新的 PlayStream 事件

​
WindowsSDK 特定變更

​
161108

日期：2016 年 11 月 7 日

​
緊急修正

全面改造的 CSharpSDK 1.0 版將 .NET 版本需求從 4.0 提高到 4.6。這並非預期的行為。此緊急修正移除了僅限 4.6 的功能，使其可在 .NET 4.0 或更新版本上建置。

​
161107

日期：2016 年 11 月 6 日

​
API 變更

Shared
  • CatalogItem
  • InitialLimitedEditionCount (已結束測試版) 如果 IsLImitedEdition 為 true，則此欄位決定該物品最初可用的數量。如果目錄物品已存在於此目錄中，或此欄位小於 1，則會忽略此欄位。
  • 玩家顯示名稱的唯一性現在是選用的。
  • 玩家連線至 Photon Cloud 時，玩家顯示名稱會以 Photon 的 “Nickname” 傳回。
Server API
  • RedeemCouponRequest
    • 新增：CharacterId
    • 應接收物品之角色的選用識別碼。如果為 null，則物品會新增至玩家。
  • UpdatePlayerStatisticsRequest
    • 新增：ForceUpdate
      • 表示是否應設定所提供的統計資料，而不論該統計資料上設定的彙總方法為何。預設值為 false。

​
新的 PlayStream 事件

  • Player_photon_session_authenticated
  • Title_secret_key_changed
  • Title_api_settings_changed

​
SDK 變更

​
161031

日期：2016 年 10 月 30 日 Unreal Blueprints 緊急修正版本 (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)
  • UnrealBlueprintSDK 升級警告：Android 與 PlayFab “SourceType” 列舉之間發生命名衝突。因此，我們必須重新命名此藍圖列舉。這會中斷所有 Client/GetStoreItems 或 Admin/GetStoreItems PlayFab API 節點。編輯器中的升級程序是刪除並重新建立每個受影響的藍圖節點。
  • UnrealBlueprintSDK 特定變更：
    • 修正某些錯誤無法正確回報的小型錯誤
    • 修正導致無法建立 Android 組建的名稱衝突 (ESourceType)

​
161017

日期：2016 年 10 月 16 日

​
淘汰變更

  • Client/GetUserCombinedInfo 已從 Proposed 轉換為 Deprecated，這表示大多數使用它的 SDK 現在會擲回錯誤。請轉換至 Client/GetPlayerCombinedInfo。
  • 根據此部落格文章：淘汰可見性，此修補程式說明 160822 中已淘汰的 API 已從淘汰轉換為過時，因此這些 API 已從最新版本的 SDK 中移除。如果您更新 SDK，現在必須轉換至新的替代 API。
  • Admin UserCredentials 物件中的 Password 已淘汰。您不再需要知道使用者的密碼即可呼叫 Admin/ResetUsers 方法。

​
UnitySdk 中斷性變更

  • UnitySdk
    • 如果您對 PlayFab API 模型類型使用反映，則必須將反映邏輯從屬性轉換為欄位 (請參閱下一節中的 UnitySdk 特定變更)。

​
API 變更

  • 新的 PlayStream 事件：
    • gamelobby_started (已更新：此項目已淘汰。請參閱 Lobby-Matchmaking-Messages)
    • gamelobby_ended(已更新：此項目已淘汰。請參閱 Lobby-Matchmaking-Messages)
    • Client/AttributeInstall 要求已淘汰 Android_Id 並轉換為 Adid。所有 SDK 都更新了一些內部登入攔截程序以因應此變更。這不是中斷性變更，因為此處原本就打算使用 Google-AdvertisingId (Adid)，而使用 Android DeviceId 無法正常運作。此變更是為了清楚明確和一致性
    • 對於 GitHub 附加元件，CloudScript 的修訂不再立即上線。而是會建立新的修訂，並由您透過 Game Manager 讓它上線
    • 此文件中描述的預設 helloWorld CloudScript 函式：CloudScript 快速入門已過時。已更新文件以更貼近目前版本 (這僅與建立新遊戲相關)

​
API 伺服器錯誤修正

  • 修正 Server/ExecuteCloudScript 中的 500 錯誤：PlayFabId 現在是必要參數。先前，如果未提供 PlayFabId，API 會擲回錯誤。
  • 修正 Server/GetSharedGroupData 中的 500 錯誤：SharedGroupId 現在是必要參數。先前，如果未提供 SharedGroupId，API 會擲回錯誤。
  • 修正 Server/AddSharedGroupMembers 中的 500 錯誤：PlayFabIds 現在是必要參數。先前，如果未提供 PlayFabIds，API 會擲回錯誤。
  • 修正 Server/RemoveSharedGroupMembers 中的 500 錯誤：PlayFabIds 現在是必要參數。先前，如果未提供 PlayFabIds，API 會擲回錯誤。
  • 修正 Server/DeleteSharedGroup 中的 500 錯誤：SharedGroupId 現在是必要參數。先前，如果未提供 SharedGroupId，API 會擲回錯誤。

​
LuaSDK 特定變更

  • LuaSDK
    • 為 Corona 與 Defold 提供更好的識別標頭。

​
UnitySDK 特定變更

  • UnitySDK
    • 將模型屬性轉換為欄位，使其在 Unity Inspector 中有更好的顯示效果 (在相關之處)。
    • 修正一個錯誤：如果 CloudScript 函式傳回基本型別，現在會正確還原序列化並以 FunctionResult 傳回。先前會是 null。
    • 修正 PaperTrail 套件：UnityPlayFabPaperTrail.unitypackage

​
SDKGenerator 特定變更

  • SDKGenerator
    • SDKGenerator 還可以從 Api-Server 或 GitHub 讀取 Api-Specs，讓客戶能夠以更少的步驟和相依性，建置與 PlayFab API 伺服器同步的自訂 SDK。

​
161003

日期：2016 年 10 月 2 日

​
API 變更

  • 新 API
    • Client/GetTime
    • Server/GetTime
    • Google OAuth 已升級至 v3
    • 改善了文件網站上的搜尋結果：PlayFab 文件。

​
SDK 全域變更

​
LuaSdk 特定變更

​
UnitySDK 特定變更

  • UnitySDK
    • UnitySDK V0 存放庫即將淘汰。所有人都應更新至我們下載頁面上提供的 UnitySDK V2。
    • IDFA 和 AdvertisingId 在 Unity 5.5 測試版上可正常運作。
    • 傳回基本型別 (例如整數) 的 CloudScript 函式可正確還原序列化
    • 小幅改善 Unity 壓縮。現在可以安全地在 PlayFabSharedSettings 可編寫指令碼物件中啟用壓縮。

​
WindowsSDK 特定問題

  • 隨此存放庫發佈的 .lib 檔案現在大於 GitHub 的檔案大小上限。
  • 最新版本沒有更新的 lib 檔案，我們已開始研究替代方案。

​
160919

日期：2016 年 9 月 18 日

​
付款的新 API

​
小幅改善 Server API 的配對功能

  • Server/RegisterGame
  • Server/DeregisterGame
  • Server/SetGameServerInstanceTags
  • Server/RefreshGameServerInstanceHeartbeat (已更新：此項目已淘汰。請參閱 Servers)

​
Cocos2d-xSDK 特定變更

  • Cocos2d-xSDK
    • 更新了 Cocos 範例，觸發範例專案的重新建置。由於僅套用外觀上的變更，這應該仍會如先前設計般運作。

​
UnitySDK 特定變更

  • UnitySDK
    • 小幅修正 Unity 遊戲伺服器，以反映 API 變更。

​
JavaScriptSDK 特定變更

​
160912

日期：2016 年 9 月 11 日

​
Unity 和 CSharp 升級警告

  • 160822 中所述的淘汰警告已生效。已淘汰的 API 現在會在可能的情況下擲回編譯器錯誤。 同樣地，我們已從主要文件中篩選掉這些 API 的文件。

​
API 變更

  • 新 API
    • Admin/GetAllActionGroups
    • Server/GetAllActionGroups

​
LuaSDK 特定變更

  • LuaSDK
    • Corona 增量支援：有新的/過渡性的 zip 檔案可以包含在 Corona 專案中。正式的 Corona 外掛程式即將推出。

​
160829

日期：2016 年 8 月 28 日

​
API 變更

我們推出了區段標記，提供直接將玩家放入特定區段的方式。您現在可以為每個玩家新增一或多個區段標記。然後，在建立區段時，您可以根據區段標記來定義區段。 區段標記的一個預期用途是與外部分析提供者 (例如 Appuri) 整合。外部分析提供者可以執行自己的進階區段劃分 (例如「可能流失」)，然後在符合該區段的玩家上設定標記。 發佈了所有目前的淘汰變更。如需詳細資訊，請參閱我們的部落格文章：https://playfab.com/deprecation-visibility/

​
Cocos2d-xSDK 特定變更

  • Cocos2d-xSDK
    • 特別感謝 Forest Ring Games 的 Max Muthig 提供以下更新：
      • 新增對 Lambda 回呼函式的支援 (先前只允許靜態函式)。

​
PostmanCollection 特定變更

  • PostmanCollection
    • 為所有 API 方法新增標頭，以協助我們的伺服器追蹤 SDK 使用量。(此標頭已存在於所有其他 SDK 上)。

​
UnitySDK 特定變更

  • UnitySDK
    • Unity Editor Extensions 現已推出首個公開測試版。此外掛程式提供易於使用的介面，用於設定和管理 PlayFab SDK。我們鼓勵所有 Unity 開發人員試用 EdEx。註冊並開始開發。
    • 新增 ExecuteCloudScript 的替代實作，使用泛型參數自動將 FunctionResult 剖析為目標類型。
    • 改善了 API 方法中的失敗情況：某些先前會擲回例外狀況的情況，現在會正確回報至錯誤回呼 (例如沒有網際網路連線時的 Web 要求)，其他情況則會向錯誤回呼回報更好的資訊。
UnrealBlueprintSdk 特定變更： (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)
  • 修正要求中包含選用清單欄位的 API 無法將要求正確張貼至伺服器的問題。(例如 GetPlayerStatistics)

​
SDKGenerator 特定變更

  • SDKGenerator
    • 更新了文件和範例專案，為 PlayFab 使用者更完善地說明如何為我們的 API 建立自己的 SDK。

​
160822

日期：2016 年 8 月 21 日

​
全域升級警告

部分 SDK 針對已淘汰的 API 新增了警告。 如果您看到這些警告，請盡快解決，並移轉至指示的替代 API。 其中許多 API 將在接下來幾個月內從 SDK 中移除。 這裡有一篇關於此事的部落格文章。

​
淘汰通知

  • Admin 欄位
    • UpdateCloudScriptRequest.Version
  • Client 欄位
    • GetPlayFabIDsFromSteamIDsRequest.SteamIDs
    • SendAccountRecoveryEmailRequest.PublisherId
    • SteamPlayFabIdPair.SteamId
  • Client 資料類型
    • GetCloudScriptUrlRequest
    • GetCloudScriptUrlResult
    • GetFriendLeaderboardAroundCurrentUserRequest
    • GetFriendLeaderboardAroundCurrentUserResult
    • GetLeaderboardAroundCurrentUserRequest
    • GetLeaderboardAroundCurrentUserResult
    • GetUserCombinedInfoRequest
    • GetUserCombinedInfoResult
    • GetUserStatisticsRequest
    • GetUserStatisticsResult
    • LogEventRequest
    • LogEventResult
    • UpdateUserStatisticsRequest
    • UpdateUserStatisticsResult
  • Client API
    • GetUserCombinedInfo
    • GetFriendLeaderboardAroundCurrentUser
    • GetLeaderboardAroundCurrentUser
    • GetUserStatistics
    • UpdateUserStatistics
    • LogEvent
    • GetCloudScriptUrl
    • RunCloudScript
  • Server 欄位
    • GetPlayFabIDsFromSteamIDsRequest.SteamIDs
    • SteamPlayFabIdPair.SteamId
  • Server 資料類型
    • GetUserStatisticsRequest
    • GetUserStatisticsResult
    • LogEventRequest
    • LogEventResult
    • UpdateUserStatisticsRequest
    • UpdateUserStatisticsResult
  • Server API
    • GetUserStatistics
    • UpdateUserStatistics
    • LogEvent

​
API 變更

​
全域 SDK 變更

  • SDK 隨附的範例專案已全部更新，不再使用已淘汰的 API。
  • 數個 SDK 有描述 API 已淘汰元素的編譯器警告和/或註解。
  • PostmanCollection 的內部格式略有變更。同時載入多個未來版本的 PostmanCollection 會比較不方便 (您會收到重複識別碼的警告)。

​
ActionScriptSDK 特定變更

  • ActionScriptSDK
    • 將範例專案中的 Adobe AirSdk 從版本 18 更新至 22。

​
160815

日期：2016 年 8 月 14 日

​
Unreal 升級警告

升級至 Unreal 4.12 所需的語法變更 ZKShao 在協助解決問題的提取要求中做了最好的說明：<https://github.com/PlayFab/UnrealCppSdk/pull/32>

​
API 變更

UnrealCppSdk 和 UnrealBlueprintSdk 特定變更： (已更新：這些 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)
  • 已更新以支援 Unreal 4.12
  • 遺憾的是，由於需求衝突，這需要放棄對 Unreal 4.11.x 的支援
  • 維持對 Unreal 4.9 的支援

​
UnitySDK 特定變更

  • UnitySDK
    • 即時連線的 Pre-Alpha 版本：使用 SignalR 讓您的自訂遊戲伺服器訂閱即時 PlayStream 事件
    • 遊戲伺服器可以開始測試註冊 PlayStream 事件的回呼，並即時做出反應
    • PlayFabSDK 在 Android 上不再需要權限。(WP8 和 iOS 仍需要在組建設定中啟用網際網路)
    • 逐步為過時的 API 加入淘汰警告。
    • 這些之後會變成淘汰錯誤，最終會從 SDK 中移除。
    • 一些壓縮相關的錯誤修正
    • PlayFabSdk 現在可在 Unity 5.0 中運作
    • 修正特定舊版 Unity 上的特定裝置問題，並擴充內部測試
    • 更新 UUnit 測試架構，使其在非同步測試逾時時能正確顯示
    • 我們的資產套件組合是以 Unity 5.4 建置

​
160801

日期：2016 年 7 月 31 日

​
API 變更

​
160726

日期：2016 年 7 月 25 日

​
UnitySDK 緊急修正變更

  • UnitySDK
    • 修正舊版 Unity 上的特定裝置問題。
    • 修正特定 AdminApi 模型類別被標示為 PlayFabResultCommon 而非 PlayFabRequestCommon 的問題。
    • 已知問題：使用 PlayFab UnitySdk 時，Google advertisingID 和 iOS IDFA 在 5.3 之前的 Unity 版本中不再能正確歸因。
    • 最簡單的修正方法是升級您的 Unity3D 版本，但我們會嘗試在之後的 SDK 版本中恢復此功能。

​
160725

日期：2016 年 7 月 24 日

​
API 變更

  • 新的 PlayStream 事件
    • display_name_filtered (文件即將提供)。
    • 更新了一些 API 範例。
    • 大量小幅文件更新。

​
UnitySDK 特定變更

  • UnitySDK
    • 引進 PlayFabRequestCommon base-class，對傳遞至 API 的要求物件執行編譯時期的類型檢查 (除非使用者使用非標準的要求物件，否則這應該不會影響任何使用者)。
    • 修正部分使用者回報的啟動時 null 參考錯誤。
    • 修正部分使用者回報的 PlayFabSharedSettings ScriptableObject 中 ProductionEnvironmentUrl 的問題。

​
160721

日期：2016 年 7 月 20 日

​
UnitySDK 緊急修正變更

  • UnitySDK
    • Unity 4.7 在該版本的限制範圍內再次可以運作
    • 修正了社群中許多人注意到的一些小型但顯眼的問題。
    • UnitySDK V2 承諾會完整支援 Windows Phone/Universal (以及主機等其他平台)。我們很高興地宣佈，所有已知平台的所有已知問題終於都已修正，PlayFab UnitySdk 應該可以在任何地方運作。
    • 由於 Unity 中非預期的副作用，我們無法將 HideAndDontSave 旗標套用至 PlayFab Http 物件。詳細資料。
    • 我們新增了一組反映的擴充函式，可在可能的情況下讓標準 C# 和 .NET Core C# 以相同的程式碼行執行相同的操作。此擴充功能並非要完整解決這些平台之間所有可能的反映不一致問題。

​
160714

日期：2016 年 7 月 13 日

​
UnitySDK 升級警告

  • UnitySDK
    • 我們發行了 UnitySDK 的新主要修訂版本。 (更新：升級指南已過時)。

​
API 變更

​
LumberyardSDK 特定變更

  • 已更新至 Lumberyard 1.3

​
UnitySDK 特定變更

  • UnitySDK
    • UnitySdk 的新主要修訂版本即將發行 (希望是今天)。
    • 原始 UnitySdk 在限定時間內可於此處取得 [更新：舊連結已移除]。
    • UnitySdk 第二版目前可於此處取得：UnitySDKV2Beta [更新：舊連結已移除]，並將很快成為新的 UnitySdk [更新：已完成]。

​
160705

日期：2016 年 7 月 4 日

​
API 變更

​
UnitySDK 特定變更

  • 為使用 PlayFabSettings.RequestType = WebRequestType.UnityWww 進行的 API 要求恢復 GZip 壓縮模式；
  • 在 SimpleJson 中新增 JsonProperty 屬性，支援欄位/屬性的替代命名，並從序列化的 JSON 中省略 null。
  • 使用預設的 PlayFab SimpleJson 策略時，TimeSpan 會序列化為以秒為單位的浮點數。先前它們會序列化為結構，而 API 或任何跨平台選項都不支援結構。
  • 在 https://github.com/PlayFab/UnitySDK/blob/master/V2UPGRADE.md 上線之前，不支援以 Mono2x 模式建置的特定平台 (例如：主機、iOS)。
  • 在 https://github.com/PlayFab/UnitySDK/blob/master/V2UPGRADE.md 上線之前，不支援 Windows Universal。
  • 如需詳細資訊，請參閱此部落格文章：https://blog.playfab.com/blog/new-and-improved-unity-SDK-beta-preview (獨立平台和 Android 可正常運作，且所有選項都受支援)
  • 所有可以使用 IL2CPP 的平台在該模式下都受支援。
  • 此版本最初推出時有壓縮無法一致運作的問題。此問題已於 7 月 8 日緊急修正。在此日期之前的初始下載可能會有壓縮問題，可以透過更新或停用壓縮來解決：(PlayFabSettings.CompressApiData = false;)

​
160627

日期：2016 年 6 月 26 日

​
UnitySDK 升級警告

  • UnitySDK
    • 將 PlayFab.Internal.Util 重新命名為 PlayFab.Internal.PlayFabUtil。“Util” 名稱很常見，在許多專案的根層級都存在，這會為這些客戶造成名稱衝突。
    • 更新 PlayFab-UnitySdk 時，如果您使用 PlayFab 的 SimpleJson 實作，可能會看到一些淘汰警告。請在方便時解決這些警告。

​
API 變更

​
UnitySDK 特定變更

  • UnitySDK
    • 已知問題：Windows 市集應用程式和非 IL2CPP 建置選項尚無法運作。請留意即將發佈的部落格文章，說明這些問題以及我們的新存放庫：UnitySDKV2Beta [更新：舊連結已移除]。
    • 我們發現與核心 UnityEngine DLL 發生名稱衝突，具體來說是一個名為 SimpleJson 的空命名空間。因此，我們必須再次重新命名和重新組織我們的 JSON 類別。非常抱歉。

​
160613

日期：2016 年 6 月 12 日

​
全域 SDK 升級警告

  • PlayFabSettings 和 PlayFabVersion：已將這些檔案及其內容合併至 PlayFabSettings。
  • 如果您先前參考了 PlayFabVersion 變數，請更新為 PlayFabSettings 中的類似變數。

​
API 變更

  • 新 API
    • SetGameServerInstanceData(已更新：此項目已淘汰。請參閱 Servers)
  • API 的錯誤修正：
    • Server/SetGameServerInstanceState(已更新：此項目已淘汰。請參閱 Servers)
    • Client/GetCurrentGames(已更新：此項目已淘汰。請參閱 Servers)

​
SDK 全域變更

  • 我們自 2016 年 3 月起淘汰了 RunCloudScript，它很快就會從 SDK 中移除。請盡快轉換為 ExecuteCloudScript。
  • 請留意即將發佈的部落格文章，介紹我們稱為 Jenkernaught 的內部測試系統。我們的範例專案包含一些以更深入測試為導向的變更，以改善 SDK 的穩定性和可靠性。具體來說：
  • 將 CloudScript 的所有測試和範例更新為 ExecuteCloudScript，因為 RunCloudScript 已淘汰。
  • 將成功登入的所有測試和範例更新為 LoginWithCustomID，以簡化內部測試。

​
Cocos2d-xSDK 特定變更

  • Cocos2d-xSDK
    • MultitypeVar 可以包含 PlayFabBaseModel 以用於撰寫要求物件。它仍無法接收任意 JSON 物件作為結果。
    • 初始版本化發行。
UnrealBlueprintSdk 特定變更： (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)
  • 從許多標頭註解中移除版本資訊，以避免大量無意義的簽入 (所以，這是最後一次大量無意義的簽入)
  • 現在會提供缺少的 http 標頭。

​
160606

日期：2016 年 6 月 5 日

​
全域 SDK 升級警告

為了在所有 SDK 之間保持一致，我們將 sdkRevision 變數重新命名為 sdkVersion (ActionScriptSDK、JavaSDK、UnitySdk)。 如果您先前存取 sdkRevision，請切換為 sdkVersion。

​
API 變更

  • 一些文件更新，以及改善的錯誤通知。

​
SDK 全域變更

  • 朝 RunCloudScript 淘汰又邁進了幾步，因此客戶應計劃將上線專案移轉至 ExecuteCloudScript。
  • 在內部，我們正在推動改善所有 SDK 的多平台測試，目前已完成一半。SDKGenerator 使用者可能會看到對 Jenkernaught 和 buildIdentifier 的參考。Jenkernaught 是實現此改善平台測試之技術的代號。buildIdentifier 是所有 SDK 中的新變數，表示產生特定 SDK 版本的特定 PlayFab-Jenkins 作業。
  • 將有一篇部落格文章說明 Jenkernaught 的作用，以及此處省略的更詳細測試架構變更，敬請期待。

​
ActionScriptSDK 特定變更

  • ActionScriptSDK
    • 範例/測試專案中與 Jenkernaught 相關的 ASyncUnitTest 架構變更。

​
CSharpSDK 特定變更

  • CSharpSDK
    • 為了與 UnitySDK 一致，我們將 JSON 特定的程式碼從 PlayFabSettings 移至 PlayFabUtil。我們也擴充了 PlayFabUtil，使其功能更接近 UnitySDK。
    • 改善了其餘 PlayFabSettings 選項的文件，使其更清楚。
    • 範例/測試專案中與 Jenkernaught 相關的 Unit 架構變更。

​
JavaScriptSDK 特定變更

  • JavaScriptSDK
    • 在 PlayFabClientSDK: IsClientLoggedIn() 中新增公用程式函式。使用它來判斷此狀況。
    • 範例/測試專案中與 Jenkernaught 相關的小幅測試變更。

​
NodeSDK 特定變更

  • NodeSDK
    • 在 PlayFabClientSDK: IsClientLoggedIn() 中新增公用程式函式。使用它來判斷此狀況。
    • 範例/測試專案中與 Jenkernaught 相關的小幅測試變更。

​
UnitySDK 特定變更

  • UnitySDK
    • 修正一個嚴重錯誤：如果您變更場景，PlayFab API 呼叫會停止運作。
    • 調整時間戳記格式的預設值，使其與其他 PlayFab SDK 一致。
    • 我們在 Unity 5.3 或更新版本的 Windows-Phone 和 Windows-Universal 上仍有問題，希望能盡快修正。

​
160523

日期：2016 年 5 月 22 日

​
全域 SDK 升級警告

數個儲存版本化資料的 API (UserData、CharacterData 等) 的資料類型從 int 變更為 uint。這需要部分使用者移除/修改我們 API 先前不一致之處的某些型別轉換。部分開發人員可能需要將一些區域變數從 int 變更為 uint。 UnrealBlueprintSdk 升級警告： xcode 與某些 PlayFab 列舉之間發生命名衝突。因此，我們必須再次修訂藍圖列舉，這會中斷所有使用列舉的 PlayFab API 節點。編輯器中的升級程序是刪除並重新建立每個受影響的藍圖節點 (如果受到影響，它們會擲回編輯器內編譯器警告)。 (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)

​
API 變更

  • 某些 DataVersion 變數使用了不一致的資料類型 (各 API 中有 int 和 uint)。為了一致性，我們將這些全部變更為 uint。
  • 為配對相關的 API 新增更多選項。
  • 配對器現在接受額外的參數 (StartNewIfNoneFound)，讓遊戲可以決定在配對過程中找不到結果時是否應啟動新的伺服器。根據預設，StartNewIfNoneFound 為 true，表示如果找不到符合需求的工作階段，就會建立新的工作階段。這讓採用技能型配對的遊戲可能「放寬」配對的需求，讓技能等級位於鐘形曲線兩端的玩家更快進入遊戲。
  • 以 GameInstanceState 更新了自訂遊戲伺服器邏輯，此項目決定遊戲工作階段是否可供配對。Closed 的遊戲無法供配對使用，讓開發人員可以建立專屬於一群玩家的遊戲工作階段，並防止在遊戲工作階段進行中於開始後加入。根據預設，遊戲伺服器會以 Open 狀態啟動。
  • -新 API：伺服器可以使用 SetGameServerInstanceState 呼叫來設定其狀態，並在呼叫 ModifyMatchmakerGameModes 時使用的 GameModeInfo 中新增 StartOpen，以指定遊戲模式中的工作階段是以 Open (預設值) 還是 Closed 啟動。(已更新：此項目已淘汰。請參閱 Servers)
UnrealBlueprintSdk 特定變更： (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)
  • 內部 SDK 更新，讓從 C++ 執行和處理 API 呼叫更容易。
  • 新增內部測試套件，可在所有目標裝置上徹底驗證 PlayFab 功能。(僅限範例專案，不含核心外掛程式)
  • 大量 C++ 程式碼清理，以及記錄和警告的改善。
  • 解決了 Blueprints 和 C++ 呼叫中多個同步 API 呼叫的並行問題。

​
160502

日期：2016 年 5 月 1 日

​
全域 SDK 升級警告

如果您先前設定了 ConfirmationMessage 和 ForceLink 欄位，請將其移除。

​
API 變更

  • 新的 Admin API：
    • SetStoreSegmentOverrides (更新：此 API 已移除)
    • 部分已淘汰和內部欄位不再隨 SDK 發佈：ConfirmationMessage 和 ForceLink。
UnrealBlueprintSdk 特定變更： (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)
  • 修訂了讀我檔案和範例專案，以使用更簡單的登入流程，以及新的更簡單 ExecuteCloudScript 方法。
  • 發生 API 錯誤時，該錯誤的詳細資料會更準確地回報，並顯示更好的偵錯資訊。
  • 我們將移除 Unreal SDK 的「Beta」標記，它們現在是我們 SDK 集合的正式成員，享有完整支援和品質檢查。

​
160425

日期：2016 年 4 月 24 日 UnrealBlueprintSdk 升級警告： 許多具有列舉欄位的藍圖 API 呼叫必須更新以使用列舉下拉式清單。舊值將會遺失，必須重新設定。這會影響數十個 PlayFab 藍圖節點。 (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)

​
API 變更

  • 大量文件更新。
  • 修正 AndroidDevicePushNotificationRegistrationRequest 中的拼寫錯誤。
  • 新的 Server API：

​
Cocos2d-xSDK 特定變更

  • Cocos2d-xSDK
    • 全面改造 Cocos SDK。
    • 新的測試架構，轉換了內部 Http 功能。
    • Android、iOS 和 Win32 平台全都可以運作。
    • 許多其他小型修正和改善。
UnrealBlueprintSdk 特定變更： (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)
  • UnrealBlueprintSdk 的有限支援測試期即將結束。因此，接下來幾個版本中會有一些可能造成中斷的變更。
  • API 規格中有一些資料欄位定義為列舉。先前，UnrealBlueprintSdk 將這些欄位顯示為任意字串，使用者必須輸入正確的選項。此問題已修正。所有這些欄位在藍圖中都已轉換為列舉下拉式清單。

​
160414

日期：2016 年 4 月 13 日

​
API 變更

  • SDK 中現在提供 PlayStream API。
  • 一些文件修訂。

​
UnitySDK 特定變更

  • UnitySDK
    • 更多自動化測試以改善 SDK 的穩定性 (以及一些相關的錯誤修正)
    • 具體來說，新增了 PlayStream 測試，並讓所有 SDK 的測試更一致。

​
160328

日期：2016 年 3 月 27 日

​
API 變更

  • 對新的可重設排行榜和其他玩家統計資料調整進行小幅漸進式改善。
  • 小幅修訂透過 Admin API 上傳 CloudScript 的方式。
  • 持續修訂並在需要時定義 API 限制和超量定義。
  • 從幾個從未使用該值的 Client API 文件中移除 “PlayFabId” 輸入。
  • 大量小幅文件更新。
  • 新的 ExecuteCloudScript API，取代舊的 GetCloudScriptUrl+RunCloudScript 模式。
  • 這應該能讓新手使用者更容易正確呼叫 CloudScript。

​
Cocos2d-xSDK 特定變更

  • Cocos2d-xSDK
    • 更新專案資料夾結構，使其在所有平台上保持一致。
    • 這修正了 iOS 組建無法匯入某些程式碼檔案的問題。
    • Cocos 現已在 Win32 和 iOS 上經過測試且可運作。

​
UnitySDK 特定變更

  • UnitySDK
    • 修正導致 ReadAllText 函式發生錯誤的不一致 #define 選項。
    • 已知問題 (尚未解決)：使用 Player Setting Scripting 後端選項 Mono2x 時，SimpleJson 無法正確序列化。在此問題修正之前，請盡可能使用 IL2CPP。
    • (為 PlayStation® 建置時可能也有類似的問題。)
“PlayStation” 是 Sony Interactive Entertainment Inc. 的註冊商標或商標。

​
160307

日期：2016 年 3 月 6 日

​
API 變更

  • 新增 Server.GetPlayFabIDsFromSteamIDs。
  • 修正 Server.GetPlayerStatistics 中的小型錯誤。

​
UnitySDK 特定變更

  • UnitySDK
    • 為了建置至多個目標而進行的小幅 SDK 重構。

​
WindowsSDK 和 Cocos2d-xSDK 特定變更

  • WindowsSDK & Cocos2d-xSDK
    • 為了建置至多個目標而進行的小幅 SDK 重構。
    • 重新命名數個類型，使其與其他 SDK 更一致。

​
SDK 新增項目

  • Amazon 的 LumberyardSdk 現已推出！

​
160222

日期：2016 年 2 月 21 日

​
API 變更

  • 新增 Server.GetPlayFabIDsFromSteamIDs。
  • 修正 Server.GetPlayerStatistics 中的小型錯誤。
  • 修正 Server.UpdatePlayerStatistics 中的小型錯誤。

​
CSharpSDK 特定變更

  • CSharpSDK
    • 更新了測試控管中的協助程式函式簽章。
    • 更新了 Server CloudScript 協助程式類別。

​
UnitySDK 特定變更

  • UnitySDK
    • 更新了測試控管中的協助程式函式簽章。
    • 新增結構變更，將我們的內部 JSON 序列化程式從 JSON.NET 切換為 SimpleJson (這是為了支援 Universal Windows 組建)。

​
160215

日期：2016 年 2 月 14 日

​
API 變更

  • 可重設排行榜和玩家統計資料現已上線。
  • GetPlayFabIDsFromSteamIDs 接受並傳回字串識別碼，供無法處理 ulong 值的語言使用。
  • 支援 Parse 移轉的小幅變更。
  • 小幅文件調整。

​
160208

日期：2016 年 2 月 7 日

​
API 變更

  • SteamID 類型已從 Uint32 更新為 Uint64。
  • 新增的 API
    • server.UnlockContainerInstance
    • server.UnlockContainerItem
    • server.UnlockContainerItem
    • server.UnlockContainerInstance
  • 新增 admin.StatisticResetIntervalOption，供可重設排行榜使用。

​
UnitySdk 特定變更

  • UnitySdk
    • 稍微修改了專案資料夾結構，這可能會造成一些檔案衝突。如需詳細資訊，請參閱此論壇文章。

​
160201

日期：2016 年 1 月 31 日

​
API 變更

  • 新 API
    • server.ConsumeItem
    • SteamID 類型已從 Uint64 更新為 Uint32。
    • GetContentListResult ItemCounts 已從 Int64 更新為 Int32。

​
UnitySDK 特定變更

  • UnitySDK
    • 新增事件回呼系統，用於監視 PlayFab API 要求和回應。

​
160125

日期：2016 年 1 月 24 日

​
API 變更

  • 新 API
    • Client.GetPlayFabIDsFromKongregateIDs
    • Client.GetCharacterStatistics
    • Client.UpdateCharacterStatistics
    • Server.RevokeInventoryItem
    • 修正 PurchaseItem___ -> PurchaseItem___ 中的拼寫錯誤。
    • 更新 UserAccountInfo 以包含更多帳戶詳細資料。
UnrealBlueprintSdk 特定變更： (已更新：此 SDK 已淘汰。如需新的 Unreal SDK，請參閱 UnrealMarketplaceSDK)
  • 修正登入後導致後續呼叫無法運作的 Client 問題。

​
160118

日期：2016 年 1 月 17 日

​
API 變更

  • 已提供新的排行榜 API：
    • GetLeaderboardAroundPlayer
    • GetFriendLeaderboardAroundPlayer
  • 舊的排行榜 API 已淘汰：
    • GetFriendLeaderboardAroundCurrentUser
    • GetLeaderboardAroundCurrentUser
  • 大量小幅文件改善。

​
ActionScriptSDK 特定變更

  • ActionScriptSDK
    • 修正錯誤回呼中無法存取 errorDetails 的問題。

​
JavaSDK 特定變更

  • JavaSDK
    • AndroidStudioExample：會在適當時 (且僅在適當時) 自動擷取 Android advertisingId 並傳送至 PlayFab。

​
UnitySDK 特定變更

  • UnitySDK
    • 從公開 SDK 中刪除了一些內部測試系統 (DemoScene 資料夾)。
    • 我們正在製作新範例和事件系統的原型。部分基礎 SDK 變更可在差異中看到，但目前都還無法存取。敬請期待，因為幾乎已經完成。
    • 用戶端上提供了另一個版本的單元測試，僅包含限用戶端的 API 呼叫。

​
Cocos2d-xSDK 和 WindowsSDK/C++ 特定變更

  • Cocos2d-xSDK & WindowsSDK/C++
    • 將兩者更新為使用 RapidJson 1.0.2 (在相關之處的 C++ 語法和程式碼)
    • 其他一些修正，包括 IOS
    • 由 https://mingle-games.com/ 提供
最後修改於 2026年10月8日