TurboLoading d'Economy V2

Avec TurboLoading, vous pouvez charger l’intégralité de votre inventaire en une seule requête à l’API GetInventoryItems. Cela améliore la latence au démarrage et les performances, car vous n’avez pas besoin d’effectuer plusieurs appels pour charger tous les objets de votre collection d’inventaire. À des fins de facturation, chaque tranche de 250 objets est traitée comme une seule page ; vos coûts ne devraient donc pas changer.

Comment fonctionne TurboLoading ?

TurboLoading est actuellement disponible pour tous les titres utilisant l’API REST d’Economy V2. Les SDK C# et Unity de PlayFab Services offrent une prise en charge supplémentaire de la compression, notamment en gérant la décompression de manière transparente pour vous. Pour activer TurboLoading, vous devez :

Définir le paramètre Count de l’API GetInventoryItems sur plus de 250 objets. Vous pouvez le définir jusqu’à la taille maximale d’une collection d’inventaire, soit 10 000 objets.
Inclure l’en-tête Accept-Encoding: gzip dans votre requête.
Décompresser la réponse avec gzip avant de pouvoir utiliser les données d’inventaire.

Par exemple, si vous souhaitez charger l’intégralité de votre inventaire de 700 objets, vous pouvez effectuer un seul appel à l’API GetInventoryItems avec un nombre de 700 et l’en-tête Accept-Encoding: gzip. Vous obtenez une réponse compressée contenant tous vos objets d’inventaire. Vous devez décompresser la réponse avec gzip avant de pouvoir utiliser les données.

Utilisation de TurboLoading avec les SDK C# et Unity de PlayFab Services

Vous pouvez activer la compression (et la décompression automatique) de toutes les réponses d’API à l’aide des SDK C# et Unity de PlayFab Services, comme suit :

PlayFabSettings.staticSettings.CompressResponses = true;

Vous pouvez également activer la compression uniquement pour votre instance d’API Economy, comme suit :

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

Utilisation de TurboLoading avec PlayFabCSDK

Vous pouvez activer la compression de toutes les réponses d’API à l’aide du SDK multiplateforme PlayFabCSDK avec PFHttpSettings, comme suit :

// 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

Vous pouvez également désactiver la compression pour toutes les réponses d’API :

// Disable Response Compression
httpSettings->requestResponseCompression = false;

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

Facturation

TurboLoading est facturé par page renvoyée, c’est-à-dire le nombre total d’objets renvoyés divisé par 250 (arrondi à l’entier supérieur). Vous payez le même montant que si vous chargiez 250 objets par page. Par exemple, si vous chargez 700 objets avec TurboLoading, vous êtes facturé pour 3 requêtes (700 / 250 = 2,8, arrondi à 3).

Avantages

TurboLoading offre plusieurs avantages, notamment :

Des performances de jeu améliorées et une latence au démarrage réduite, car vous n’avez pas besoin d’effectuer plusieurs appels pour charger vos objets d’inventaire.
Une complexité et une maintenance du code réduites, car vous n’avez pas besoin de gérer la logique de pagination et de boucles.

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Comment fonctionne TurboLoading ?

Utilisation de TurboLoading avec les SDK C# et Unity de PlayFab Services

Utilisation de TurboLoading avec PlayFabCSDK

Facturation

Avantages

Voir aussi

​Comment fonctionne TurboLoading ?

​Utilisation de TurboLoading avec les SDK C# et Unity de PlayFab Services

​Utilisation de TurboLoading avec PlayFabCSDK

​Facturation

​Avantages

​Voir aussi

Comment fonctionne TurboLoading ?

Utilisation de TurboLoading avec les SDK C# et Unity de PlayFab Services

Utilisation de TurboLoading avec PlayFabCSDK

Facturation

Avantages

Voir aussi