Economy V2 TurboLoading

  • Artikel

Mit TurboLoading können Sie Ihren gesamten Bestand mit einer einzigen Anforderung an die GetInventoryItems API laden. Dies verbessert die Startlatenz und -leistung, da Sie nicht mehrere Aufrufe ausführen müssen, um alle Elemente aus Ihrer Bestandssammlung zu laden. Zu Abrechnungszwecken werden alle 250 Elemente als einzelne Seite behandelt, sodass sich Ihre Kosten nicht ändern sollten.

Wie funktioniert TurboLoading?

TurboLoading ist derzeit für alle Titel verfügbar, die die Economy V2-REST-API verwenden. Die PlayFab Services C#- und Unity-SDKs bieten weitere Unterstützung für die Komprimierung, einschließlich der transparenten Behandlung der Dekomprimierung für Sie. Um TurboLoading zu aktivieren, müssen Sie Folgendes ausführen:

  • Legen Sie den Count Parameter der GetInventoryItems API auf mehr als 250 Elemente fest. Sie können sie auf die maximale Größe einer Bestandssammlung einrichten, die 10.000 Elemente beträgt.
  • Fügen Sie den Accept-Encoding: gzip Header in Ihre Anforderung ein.
  • Dekomprimieren Sie die Antwort mithilfe von gzip , bevor Sie die Bestandsdaten verwenden können.

Wenn Sie beispielsweise Ihren gesamten Bestand von 700 Elementen laden möchten, können Sie einen einzelnen Aufruf der GetInventoryItems API mit einer Anzahl von 700 und dem Accept-Encoding: gzip Header durchführen. Sie erhalten eine komprimierte Antwort mit allen Ihren Bestandselementen. Sie müssen die Antwort mit gzip dekomprimieren, bevor Sie die Daten verwenden können.

Verwenden von TurboLoading mit PlayFab Services C# und Unity SDK

Sie können die Komprimierung (und automatische Dekomprimierung) aller API-Antworten mithilfe der PlayFab Services C#- und Unity-SDKs wie folgt festlegen:

PlayFabSettings.staticSettings.CompressResponses = true;

Oder Sie können die Komprimierung (und automatische Dekomprimierung) nur für Ihre Economy-API-instance wie folgt festlegen:

var economyApi = new PlayFabEconomyInstanceAPI(new PlayFabApiSettings { CompressResponses = true }, authContext);

Abrechnung

TurboLoading wird pro zurückgegebener Seite abgerechnet, d. h. die Gesamtzahl der zurückgegebenen Elemente dividiert durch 250 (aufgerundet). Sie bezahlen genauso, als wenn Sie 250 Elemente pro Seite laden. Wenn Sie beispielsweise 700 Elemente mit TurboLoading laden, werden Ihnen 3 Anforderungen in Rechnung gestellt (700 / 250 = 2,8, aufgerundet auf 3).

Vorteile

TurboLoading bietet mehrere Vorteile, z. B.:

  • Verbesserte Spielleistung und verringerte Startlatenz, da Sie nicht mehrere Aufrufe zum Laden Ihrer Inventarelemente ausführen müssen.
  • Reduzierte Komplexität und Codewartung, da Sie keine Paginierungs- und Schleifenlogik verarbeiten müssen.

Weitere Informationen