TurboLoading d'Economy V2

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

Comment fonctionne TurboLoading?

TurboLoading est actuellement offert pour tous les titres qui utilisent l’API REST d’Economy V2. Les SDK C# et Unity de PlayFab Services offrent un soutien supplémentaire pour la compression, notamment en gérant la décompression pour vous de façon transparente. Pour activer TurboLoading, vous devez :

Définir le paramètre Count de l’API GetInventoryItems à plus de 250 articles. Vous pouvez le définir jusqu’à la taille maximale d’une collection d’inventaire, soit 10 000 articles.
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 voulez charger tout votre inventaire de 700 articles, 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 articles d’inventaire. Vous devez décompresser la réponse avec gzip avant de pouvoir utiliser les données.

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

Vous pouvez définir 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 aussi définir la compression uniquement pour votre instance de l’API Economy, comme suit :

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

Utiliser TurboLoading avec PlayFabCSDK

Vous pouvez activer la compression de toutes les réponses d’API à l’aide du PlayFabCSDK multiplateforme 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

De plus, vous pouvez désactiver la compression de 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 retournée, c’est-à-dire le nombre total d’articles retournés divisé par 250 (arrondi à l’unité supérieure). Vous payez le même montant que si vous chargiez 250 articles par page. Par exemple, si vous chargez 700 articles 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, puisque vous n’avez pas à effectuer plusieurs appels pour charger vos articles d’inventaire.
Une complexité et un entretien du code réduits, puisque vous n’avez pas à gérer la logique de pagination et de boucles.

XBOX Services

PlayFab

Comment fonctionne TurboLoading?

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

Utiliser TurboLoading avec PlayFabCSDK

Facturation

Avantages

Voir aussi

​Comment fonctionne TurboLoading?

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

​Utiliser TurboLoading avec PlayFabCSDK

​Facturation

​Avantages

​Voir aussi

Comment fonctionne TurboLoading?

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

Utiliser TurboLoading avec PlayFabCSDK

Facturation

Avantages

Voir aussi