Fonctionnalités côté client
Le GDK permet aux jeux d’implémenter plusieurs types d’extensions et de types de produits dans le jeu, tels que les consommables, les durables (contenu téléchargeable), les abonnements, les bundles 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 dans le jeu entièrement fonctionnelle, consultez l’exemple In-Game Store du GDK. Les articles suivants de la section Fundamentals traitent de ces API et scénarios :- Opérations de base du Store - Interroger ce qui est disponible à la vente et ce que possède l’utilisateur
- Comment utiliser un durable sans package - Utilisation d’un durable qui n’a pas de package de téléchargement distinct.
- Gérer et accorder une licence au contenu téléchargeable (DLC) - Utilisation de durables traditionnels avec des packages de téléchargement.
- Écosystèmes basés sur les consommables - Mise en place et configuration d’un modèle de monétisation basé sur les consommables dans votre jeu.
- Implémentation de versions d’évaluation pour votre jeu - Implémentation d’une version d’évaluation intégrée à votre jeu.
- Bundles et Season Pass - Utilisation de bundles et de Season Pass pour apporter de la valeur et de l’engagement aux clients avec vos produits.
- Modèle de partage de produits pour les jeux - Le modèle de licence 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 des informations 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 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 partenaires d’ajouter des éléments gratuits au compte de l’utilisateur.
- Recurrence - Fournit des informations détaillées sur les abonnements d’un utilisateur et permet aux services partenaires de gérer ces abonnements au nom de l’utilisateur.
Authentification auprès des services du Microsoft Store
Pour obtenir des informations détaillées sur la façon d’authentifier votre service auprès des services du Microsoft Store, consultez Demande d’un User Store ID pour l’authentification de service à service.Si vous connaissez l’authentification par X-token, le service Collections prend en charge les X-tokens.
Informations clés pour les développeurs ayant utilisé le XDK
Si vous connaissez les systèmes commerciaux du XDK, les définitions suivantes devraient vous aider à identifier le nom des services équivalents dans le 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 inclut tous les scénarios de serveur à serveur pour valider la propriété et les quantités de consommables. Bien que les X-tokens 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 client Inventory - Toutes les fonctionnalités côté client liées à l’interrogation de la propriété des éléments sont désormais gérées 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 disponibles à l’achat dans le jeu sont désormais gérées par les API XStore. Il n’existe pas d’option de serveur à serveur pour interroger les produits disponibles à la vente dans votre titre.
Exemple : XStoreQueryAssociatedProductsAsync renvoie les produits pouvant être vendus dans le cadre d’une boutique dans le 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 les informations de licence du jeu actuel, y compris les éventuelles informations de licence d’évaluation. Pour pouvoir valider une licence côté client sur votre propre service, consultez Utilisation des jetons de licence pour valider les licences sur vos services.