Licences Game Pass dans les vérifications de licence côté client
Les droits d’utilisation Game Pass ne peuvent pas être détectés à partir du client du jeu. Lorsqu’un utilisateur a droit à votre titre par le biais du Game Pass, XStoreQueryGameLicenseAsync renvoie une licence avecisActive = true, comme pour un achat direct. La structure XStoreGameLicense ne comporte aucun champ indiquant la manière dont la licence a été obtenue.
Pour enregistrer la manière dont les utilisateurs ont obtenu votre titre, par exemple à des fins de télémétrie, envoyez l’identité de l’utilisateur de votre client à votre propre service. Votre service appelle ensuite l’API publisherQuery et vérifie acquisitionType. La valeur Recurring indique un droit d’utilisation Game Pass, et Single indique une possession directe.
Comportement des données de réponse pour les éditeurs autorisés et non autorisés
Si votre éditeur n’est pas autorisé, les éléments accordés par le Game Pass apparaissent comme des droits d’utilisation possédés directement. Par exemple,acquisitionType apparaît comme Single, et les ProductIds Game Pass n’apparaissent pas dans satisfiedByProductIds.
Pour les éditeurs autorisés, seuls les abonnements Game Pass actifs sont renvoyés. Si l’abonnement Game Pass de l’utilisateur est annulé ou prend fin, les requêtes suivantes ne contiennent plus les informations Game Pass. En outre, EndDate est normalisé à la valeur maximale ; il ne peut donc pas être utilisé pour détecter la fin de l’abonnement.
Délai le jour de la sortie dans le Game Pass dans les résultats de droits d’utilisation de serveur à serveur
Lorsque des titres ou des extensions sont mis en ligne dans le Game Pass, attendez-vous à un délai entre la disponibilité côté client et la visibilité danspublisherQuery. Ce comportement est dû aux intervalles d’actualisation des caches qui diffèrent entre les systèmes du Store. En pratique, les licences locales sont généralement mises à jour en premier, et publisherQuery peut accuser un retard de deux à trois heures.
Les vérifications directes des ProductIds Game Pass ne sont pas affectées ; le délai concerne principalement les éléments accordés par le biais de droits d’utilisation satisfaisants.
Test des abonnements Game Pass dans votre sandbox de développement
Les niveaux XBOX Game Pass doivent être activés et accessibles lorsque vous les recherchez dans l’application XBOX Store de votre sandbox de développement. Les comptes de test XBOX sont créés avec une carte de crédit de test et peuvent s’abonner aux niveaux Game Pass dans votre sandbox. Si vous ne trouvez pas les niveaux Game Pass dans votre sandbox, contactez votre Developer Partner Manager ou votre interlocuteur Microsoft pour obtenir de l’aide.Le statut d’abonnement Game Pass n’est pas conservé d’un sandbox à l’autre. Après avoir ajouté le Game Pass à un compte de test dans un sandbox, ne déplacez pas ce compte de test vers un autre sandbox pour des tests ou du débogage liés au Game Pass ou au commerce.
Demande du statut d’abonnement Game Pass
Pour demander le statut d’abonnement Game Pass de l’utilisateur, ajoutez les ProductIds correspondant aux niveaux d’abonnement que vous êtes autorisé à consulter dans la liste productSkuIds de la requête (voir le tableau).
Si l’utilisateur dispose d’un abonnement au niveau demandé, la réponse à la requête inclut un élément avec le ProductId du niveau d’abonnement Game Pass correspondant.
Comportement lors de la demande de niveaux inclus dans des niveaux supérieurs
Certains niveaux Game Pass sont inclus lorsqu’un abonné dispose d’un niveau supérieur. Tous vos niveaux autorisés qui sont inclus dans des niveaux supérieurs sont renvoyés lorsque l’utilisateur est abonné au niveau supérieur. Exemple : votre éditeur est autorisé pour XBOX Game Pass Essential. L’utilisateur dispose de XBOX Game Pass Ultimate. Lorsque vous interrogez tous les ProductIds Game Pass, publisherQuery renvoie un résultat uniquement pour XBOX Game Pass Essential. Si votre éditeur est autorisé à consulter d’autres niveaux, publisherQuery renvoie également ces niveaux.XBOX Game Pass (Starter Edition) fait exception à l’héritage et constitue un niveau autonome. Il n’est inclus dans aucun des autres niveaux.
Octroi d’avantages dans le jeu aux abonnés Game Pass
Nous vous recommandons de demander l’accès au niveau Game Pass le plus bas nécessaire pour accorder des avantages dans le jeu aux abonnés. Exemple : vous accordez une récompense dans le jeu à tous les abonnés Game Pass sur console. Vous n’avez besoin que de l’accès à XBOX Game Pass Essential (CFQ7TTC0K5DJ), car Premium et Ultimate incluent Essential.Détection des produits accordés par un abonnement Game Pass avec satisfiedByProductIds
Après autorisation, identifiez les droits d’utilisation issus du Game Pass en vérifiant les valeurssatisfiedByProductIds et acquisitionType. Un droit d’utilisation basé sur le Game Pass a un acquisitionType égal à Recurring, et satisfiedByProductIds inclut le ProductID du niveau Game Pass le plus élevé pour lequel vous êtes autorisé.
Si vous utilisez l’option de filtre excludeDuplicates, le droit d’utilisation lié au Game Pass est filtré si l’utilisateur possède directement le titre.
satisfiedByProductIds d’un élément vous indique si l’élément est accordé par le Game Pass, mais ne suffit pas à déterminer si l’utilisateur est membre du Game Pass. Pour vérifier le statut d’abonnement Game Pass d’un utilisateur, incluez les valeurs de ProductId Game Pass dans le productSkuIds de votre requête.
Exemple d’élément en double avec XBOX Game Pass
Si l’utilisateur dispose à la fois d’une possession directe et d’un droit d’utilisation Game Pass pour le même produit, deux entrées peuvent apparaître lorsqueexcludeDuplicates est false. Lorsque excludeDuplicates est true, l’élément acheté directement est renvoyé.
Pour connaître l’ensemble des règles de résolution des doublons et le comportement de priorité des sources, consultez Comprendre les éléments en double dans la réponse.