跳轉到主要內容

171204

日期:2017 年 12 月 4 日

Unreal SDK 變更 (Cpp 和 Bp)

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

171127

日期:2017 年 11 月 27 日

API 變更

  • 允許「限量版」物品的庫存功能現已脫離 Beta 正式發行。
  • 此功能可讓您定義遊戲中特定 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](xref:titleid.playfabapi.com.client.matchmaking).[StartGameResult](xref:titleid.playfabapi.com.client.matchmaking)

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 自訂 Push 外掛程式,並更新為 FCM 推播訊息。

170925

日期:2017 年 9 月 5 日

API 變更

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

全域推播通知更新

新的 PlayStream 事件

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

JavaScriptSDK 特定變更

  • JavaScriptSDK
    • 在 JavaScriptSDK 中新增了少數其他 SDK 中已有的小功能:
    • 您現在可以在要求中插入額外的標頭 (移除了此 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 被序列化為整數,這是一個錯誤。新欄位是適當的列舉字串。 (已更新:此項目已淘汰。請參閱伺服器)

其他 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 編輯器延伸模組

  • 修正了下載和上傳 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 讀我檔案中許多損毀的連結。

UnitySDK 特定變更

  • UnitySDK
    • 我們現在支援多個版本的 Android API 和 Google Play 服務。請在這裡閱讀更多詳細資料。
    • 對 Unity + Android Push-Plugin 的計劃變更暫時告一段落。如果您有任何其他要求,請在這裡告訴我們。

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 要求中的額外標頭。
    • 這是企業版專屬功能,特別用於雙重加密的登入要求。

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 變更

  • 新的企業版功能:更多登入加密
  • 您可以使用 Policy API 方法,強制要求登入呼叫使用第二層加密
  • 請參閱:UpdatePolicy,特別是 UpdatePolicyRequest.Statements.ApiConditions
  • 此功能仍有部分處於 Beta,不建議啟用 (尚未 - 即將推出!)

新的 PlayStream 事件

UnitySDK 特定變更

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

UnityEditorExtensions 特定變更

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

170406

日期:2017 年 4 月 6 日

Unity Android Push 外掛程式的 Hotfix

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

170403

日期:2017 年 4 月 3 日

API 變更

  • **Client 和 Server 排行榜方法:**取得排行榜的方法 (例如 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 仍與 4.7 到 5.6 的所有 Unity 版本相容。
    • 修正了 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 隨附的 Example-Test 專案。

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 編輯器延伸模組

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

170109

日期:2017 年 1 月 8 日

重大變更

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

API 變更

  • 修正了文件中的錯字。

所有 SDK

SDKGenerator 特定變更

UnitySdk 特定變更

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

WindowsSDK 特定變更

  • 使用 BFG 清理了 GitHub 存放庫,並從歷程記錄中移除了所有大型檔案。請刪除您的複製或分支並重新建立,讓您的歷程記錄保持乾淨。

170102

日期:2017 年 1 月 1 日

API 變更

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

Cocos2d-xSDK 特定變更

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

UnitySDK 特定變更

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

WindowsSDK 特定變更

最後修改於 2026年10月8日