跳轉到主要內容
使用 TurboLoading,您只需對 GetInventoryItems API 發出單一要求,即可載入整個庫存。這可改善啟動延遲與效能,因為您不必進行多次呼叫來載入庫存集合中的所有物品。基於計費目的,每 250 個物品會視為單一頁面,因此您的費用應該不會改變。

TurboLoading 如何運作?

TurboLoading 目前適用於所有使用 Economy V2 REST API 的遊戲。PlayFab Services C# 和 Unity SDK 進一步支援壓縮,包括以透明方式為您處理解壓縮。若要啟用 TurboLoading,您需要:
  • 將 GetInventoryItems API 的 Count 參數設定為超過 250 個物品。您最多可以將其設定為庫存集合的大小上限,也就是 10,000 個物品。
  • 在要求中包含 Accept-Encoding: gzip 標頭。
  • 在使用庫存資料之前,先使用 gzip 解壓縮回應。
例如,如果您想要載入包含 700 個物品的整個庫存,可以對 GetInventoryItems API 發出單一呼叫,並將 count 設為 700,同時加上 Accept-Encoding: gzip 標頭。您會取得包含所有庫存物品的壓縮回應。在使用資料之前,您需要使用 gzip 解壓縮回應。

搭配 PlayFab Services C# 和 Unity SDK 使用 TurboLoading

您可以使用 PlayFab Services C# 和 Unity SDK 設定所有 API 回應的壓縮 (及自動解壓縮),如下所示:
或者,您也可以只為 Economy API 執行個體設定壓縮,如下所示:

搭配 PlayFabCSDK 使用 TurboLoading

您可以使用跨平台 PlayFabCSDK 搭配 PFHttpSettings,為所有 API 回應啟用壓縮,如下所示:
此外,您也可以停用所有 API 回應的壓縮:

計費

TurboLoading 依傳回的頁面計費,也就是傳回的物品總數除以 250 (無條件進位)。您支付的費用與每頁載入 250 個物品時相同。例如,如果您使用 TurboLoading 載入 700 個物品,會以 3 個要求計費 (700 / 250 = 2.8,無條件進位為 3)。

優點

TurboLoading 提供多項優點,例如:
  • 改善遊戲效能並減少啟動延遲,因為您不必進行多次呼叫來載入庫存物品。
  • 降低複雜度與程式碼維護工作,因為您不必處理分頁與迴圈邏輯。

另請參閱

最後修改於 2026年10月6日