Fonctionnalités côté client
Le GDK permet aux jeux de mettre en œuvre plusieurs types de modules complémentaires en jeu et de types de produits, comme les consommables, les biens durables (contenu téléchargeable), les abonnements, les ensembles et les versions d’évaluation. L’ensemble d’API XStore fournit les fonctionnalités nécessaires pour interroger, promouvoir et gérer ces produits côté client. Pour un exemple de boutique en jeu entièrement fonctionnelle, consultez l’exemple de boutique en jeu du GDK. Les articles suivants de la section Notions de base traitent de ces API et scénarios :- Opérations de base du Store - Interroger ce qui est offert à la vente et ce que possède l’utilisateur
- Comment utiliser un bien durable sans package - Utiliser un bien durable qui n’a pas de package de téléchargement distinct.
- Gérer le contenu téléchargeable (DLC) et ses licences - Utiliser des biens durables traditionnels avec des packages de téléchargement.
- Écosystèmes basés sur les consommables - Mettre en place et configurer un modèle de monétisation basé sur les consommables dans votre jeu.
- Mettre en œuvre des versions d’évaluation pour votre jeu - Mettre en œuvre une version d’évaluation intégrée à votre jeu.
- Ensembles et passes saisonniers - Utiliser des ensembles et des passes saisonniers pour offrir de la valeur et favoriser l’engagement des clients envers vos produits.
- Modèle de partage de produits pour les jeux - Le modèle de licences des jeux GDK sur console XBOX et PC Windows, et la façon dont le partage entre utilisateurs s’applique.
Fonctionnalités côté serveur
Les services du Microsoft Store qui prennent en charge les API côté client et permettent les appels de service à service sont répartis entre les services suivants :- Collections - Fournit de l’information sur les produits que l’utilisateur possède ou qu’il a le droit d’utiliser, et traite les produits consommables. Peut également servir à détecter l’état de l’abonnement Game Pass pour les partenaires autorisés.
- Clawback - Permet aux services des partenaires de détecter et de gérer les remboursements accordés aux utilisateurs pour des consommables déjà traités.
- Purchase - Permet aux services des partenaires d’ajouter des éléments gratuits au compte de l’utilisateur.
- Recurrence - Fournit de l’information détaillée sur les abonnements d’un utilisateur et permet aux services des partenaires de gérer ces abonnements au nom de l’utilisateur.
Authentification auprès des services du Microsoft Store
Pour de l’information détaillée sur la façon d’authentifier votre service auprès des services du Microsoft Store, consultez Demander un User Store ID pour l’authentification de service à service.Si vous connaissez l’authentification par jeton X, sachez que le service Collections prend en charge les jetons X.
Information clé pour les développeurs qui ont utilisé le XDK
Si vous connaissez les systèmes de commerce du XDK, les définitions suivantes devraient vous aider à repérer le nom des services équivalents du GDK- Service Inventory - Les fonctionnalités du service Inventory du XDK (interrogation de la propriété, traitement des consommables, etc.) sont désormais prises en charge par le service Collections. Cela comprend tous les scénarios serveur à serveur de validation de la propriété et des quantités de consommables. Bien que les jetons X utilisés pour Inventory fonctionnent pour appeler Collections, nous recommandons aux partenaires de passer au flux d’authentification par jeton Microsoft Entra ID et User Store ID afin d’utiliser les fonctionnalités étendues des services du Microsoft Store.
Exemple : https://collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview - API clientes Inventory - Toutes les fonctionnalités côté client liées à l’interrogation de la propriété des éléments sont désormais prises en charge par les API XStore.
Exemple : XStoreQueryEntitledProductsAsync renvoie les éléments que l’utilisateur actuel a le droit d’utiliser à ce moment-là. - API Catalog Browse - Toutes les fonctionnalités côté client liées à l’interrogation des produits offerts à l’achat en jeu sont désormais prises en charge par les API XStore. Il n’existe aucune option serveur à serveur pour interroger les produits offerts à la vente dans votre titre.
Exemple : XStoreQueryAssociatedProductsAsync renvoie les produits pouvant être vendus dans le cadre d’une boutique en jeu. - Versions d’évaluation et licences - Toutes les fonctionnalités côté client liées aux licences d’évaluation font désormais partie des API XStore. Exemple : XStoreQueryGameLicenseAsync renvoie l’information de licence du jeu actuel, y compris toute information de licence d’évaluation. Pour pouvoir valider une licence côté client sur votre propre service, consultez Utiliser des jetons de licence pour valider les licences sur vos services.