> ## 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 を使用して、プレイヤーのインベントリ全体を 1 回のリクエストで取得し、起動時のレイテンシと API 呼び出しを削減します。

TurboLoading を使用すると、`GetInventoryItems` API への 1 回のリクエストでインベントリ全体を読み込むことができます。これにより、インベントリ コレクションからすべてのアイテムを読み込むために複数の呼び出しを行う必要がなくなり、起動時のレイテンシとパフォーマンスが向上します。課金上の観点では、250 アイテムごとに 1 ページとして扱われるため、コストは変わりません。

## TurboLoading の仕組み

TurboLoading は現在、Economy V2 REST API を使用するすべてのタイトルで利用できます。PlayFab Services C# および Unity SDK では、透過的な解凍処理を含む圧縮のさらなるサポートがあります。TurboLoading を有効にするには、次のことを行う必要があります。

* `GetInventoryItems` API の `Count` パラメーターを 250 アイテムを超える値に設定します。インベントリ コレクションの最大サイズである 10,000 アイテムまで設定できます。
* リクエストに `Accept-Encoding: gzip` ヘッダーを含めます。
* インベントリ データを使用する前に、`gzip` を使用してレスポンスを解凍します。

たとえば、700 アイテムのインベントリ全体を読み込みたい場合、Count を 700 にし、`Accept-Encoding: gzip` ヘッダーを付けて `GetInventoryItems` API を 1 回呼び出すことができます。すべてのインベントリ アイテムを含む圧縮されたレスポンスが返されます。データを使用する前に、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 の使用

Cross-Platform PlayFabCSDK で PFHttpSettings を使用して、すべての API レスポンスの圧縮を次のように有効にできます。

```C++ theme={null}
// PFHttpSettings 構造体を初期化する
PFHttpSettings* httpSettings = new PFHttpSettings;

// レスポンスの圧縮 (および自動解凍) を有効にする
httpSettings->requestResponseCompression = true;

// PFHttpSettings を設定する
HRESULT hr = PFSetHttpSettings(httpSettings); // FAILED(hr) == true のエラー処理は各自で追加してください
```

さらに、すべての API レスポンスの圧縮を無効にすることもできます。

```C++ theme={null}
// レスポンスの圧縮を無効にする
httpSettings->requestResponseCompression = false;

// PFHttpSettings を更新する
hr = PFSetHttpSettings(httpSettings); // エラー処理は各自で追加してください
```

## 課金

TurboLoading は返されるページごとに課金されます。つまり、返されるアイテムの合計数を 250 で割ったもの (切り上げ) です。1 ページあたり 250 アイテムを読み込む場合と同じ料金がかかります。たとえば 700 アイテムを読み込む場合、TurboLoading では 3 リクエスト分が課金されます (700 / 250 = 2.8、切り上げて 3)。

## 利点

TurboLoading には、次のようなさまざまな利点があります。

* インベントリ アイテムを読み込むために複数の呼び出しを行う必要がなくなるため、ゲームのパフォーマンスが向上し、起動時のレイテンシが削減されます。
* ページングとループのロジックを処理する必要がなくなるため、複雑さとコード メンテナンスが削減されます。

## 関連項目

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


## Related topics

- [Economy v2 の概要](/ja-jp/services/playfab/economy-monetization/economy-v2/overview.md)
- [アイテムとインベントリの概要](/ja-jp/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview.md)
- [Economy V2 の制限](/ja-jp/services/playfab/economy-monetization/economy-v2/limits.md)
- [Economy v2 ETag](/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/etags.md)
- [Economy v2 のストア](/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/stores.md)