GetInventoryItems API への 1 回のリクエストでインベントリ全体を読み込むことができます。これにより、インベントリ コレクションからすべてのアイテムを読み込むために複数の呼び出しを行う必要がなくなり、起動時のレイテンシとパフォーマンスが向上します。課金上の観点では、250 アイテムごとに 1 ページとして扱われるため、コストは変わりません。
TurboLoading の仕組み
TurboLoading は現在、Economy V2 REST API を使用するすべてのタイトルで利用できます。PlayFab Services C# および Unity SDK では、透過的な解凍処理を含む圧縮のさらなるサポートがあります。TurboLoading を有効にするには、次のことを行う必要があります。GetInventoryItemsAPI のCountパラメーターを 250 アイテムを超える値に設定します。インベントリ コレクションの最大サイズである 10,000 アイテムまで設定できます。- リクエストに
Accept-Encoding: gzipヘッダーを含めます。 - インベントリ データを使用する前に、
gzipを使用してレスポンスを解凍します。
Accept-Encoding: gzip ヘッダーを付けて GetInventoryItems API を 1 回呼び出すことができます。すべてのインベントリ アイテムを含む圧縮されたレスポンスが返されます。データを使用する前に、gzip を使用してレスポンスを解凍する必要があります。
PlayFab Services C# および Unity SDK での TurboLoading の使用
PlayFab Services C# および Unity SDK を使用して、すべての API レスポンスの圧縮 (および自動解凍) を次のように設定できます。PlayFabCSDK での TurboLoading の使用
Cross-Platform PlayFabCSDK で PFHttpSettings を使用して、すべての API レスポンスの圧縮を次のように有効にできます。課金
TurboLoading は返されるページごとに課金されます。つまり、返されるアイテムの合計数を 250 で割ったもの (切り上げ) です。1 ページあたり 250 アイテムを読み込む場合と同じ料金がかかります。たとえば 700 アイテムを読み込む場合、TurboLoading では 3 リクエスト分が課金されます (700 / 250 = 2.8、切り上げて 3)。利点
TurboLoading には、次のようなさまざまな利点があります。- インベントリ アイテムを読み込むために複数の呼び出しを行う必要がなくなるため、ゲームのパフォーマンスが向上し、起動時のレイテンシが削減されます。
- ページングとループのロジックを処理する必要がなくなるため、複雑さとコード メンテナンスが削減されます。