> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Economy V2 TurboLoading

> 搭配 GetInventoryItems 使用 PlayFab Economy v2 TurboLoading，以單一要求擷取完整的玩家庫存，減少啟動延遲與 API 呼叫次數。

使用 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 回應的壓縮 (及自動解壓縮)，如下所示：

```csharp theme={null}
PlayFabSettings.staticSettings.CompressResponses = true;
```

或者，您也可以只為 Economy API 執行個體設定壓縮，如下所示：

```csharp theme={null}
var economyApi = new PlayFabEconomyInstanceAPI(new PlayFabApiSettings { CompressResponses = true }, authContext);
```

### 搭配 PlayFabCSDK 使用 TurboLoading

您可以使用跨平台 PlayFabCSDK 搭配 PFHttpSettings，為所有 API 回應啟用壓縮，如下所示：

```C++ theme={null}
// Initialize PFHttpSettings struct
PFHttpSettings* httpSettings = new PFHttpSettings;

// Enable Response Compression (and automatic decompression)
httpSettings->requestResponseCompression = true;

// Set PFHttpSettings
HRESULT hr = PFSetHttpSettings(httpSettings); // Add your own error handling FAILED(hr) == true
```

此外，您也可以停用所有 API 回應的壓縮：

```C++ theme={null}
// Disable Response Compression
httpSettings->requestResponseCompression = false;

// Update PFHttpSettings
hr = PFSetHttpSettings(httpSettings); // Add your own error handling
```

## 計費

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

## 優點

TurboLoading 提供多項優點，例如：

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

## 另請參閱

* [Economy V2 概觀](/zh-TW/services/playfab/economy-monetization/economy-v2/overview)
* [GetInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-inventory-items)
* [限制](/zh-TW/services/playfab/economy-monetization/economy-v2/limits)


## Related topics

- [Economy v2 概觀](/zh-TW/services/playfab/economy-monetization/economy-v2/overview.md)
- [物品與庫存概觀](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview.md)
- [Economy V2 限制](/zh-TW/services/playfab/economy-monetization/economy-v2/limits.md)
- [Economy v2 商店](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/stores.md)
- [Economy v2 訂閱](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/subscriptions.md)