XStoreQueryAssociatedProductsAsync
Obtient les informations de fiche du Store pour les produits que les utilisateurs peuvent acheter depuis le jeu en cours.Syntaxe
Paramètres
storeContextHandle _In_Type : XStoreContextHandle Handle de contexte du Store pour l’utilisateur, retourné par XStoreCreateContext. productKinds _In_
Type : XStoreProductKind Type de produits à retourner. maxItemsToRetrievePerPage _In_
Type : uint32_t Nombre maximal d’éléments à récupérer par page. Le nombre d’éléments retournés par page peut varier de 0 à
maxItemsToRetrievePerPage.
Pour plus d’informations, consultez Pagination.
async _Inout_Type : XAsyncBlock* XAsyncBlock définissant le travail asynchrone en cours. Utilisez le XAsyncBlock pour interroger l’état de l’appel et récupérer ses résultats. Pour plus d’informations, consultez XAsyncBlock.
Valeur renvoyée
Type : HRESULT Code de réussite ou d’erreur HRESULT.Remarques
Pour obtenir les informations de fiche du Store et le résultat de l’exécution de cette fonction, appelez XStoreQueryAssociatedProductsResult après avoir appelé cette fonction. XStoreQueryAssociatedProductsResult contient unXStoreProductQueryHandle que vous énumérez en appelant XStoreEnumerateProductsQuery.
Vous ne pouvez pas connaître à l’avance le nombre de produits retournés par cette requête.
Cette API retourne uniquement les produits que les utilisateurs peuvent parcourir dans le Microsoft Store ou acheter dans le jeu.
Les résultats n’incluent aucun produit masqué, expiré ou retiré du Store.
Si vous avez besoin des détails d’un tel produit, utilisez XStoreQueryProductsAsync en lui passant le Store ID du produit.
Pagination
Cette fonction retourne les produits sur plusieurs pages (jusqu’àmaxItemsToRetrievePerPage éléments par page).
Utilisez XStoreProductsQueryHasMorePages et XStoreProductsQueryNextPageAsync/XStoreProductsQueryNextPageResult pour traiter tous les résultats paginés.
La pagination n’est terminée que lorsque XStoreProductsQueryHasMorePages retourne false.
La pagination peut se comporter différemment dans les sandbox et dans RETAIL.
Dans une sandbox, les éléments s’accumulent jusqu’à
maxItemsToRetrievePerPage avant qu’une page soit retournée.
Dans RETAIL, il est courant que 0 à 1 élément soit retourné par page.Il est important que tous les jeux utilisant cette API implémentent et testent la pagination avant leur sortie.Pour tester le comportement de la pagination dans une sandbox, définissez temporairement maxItemsToRetrievePerPage sur une valeur inférieure au nombre de produits publiés dans votre sandbox.
Pour tester dans RETAIL avant la sortie de votre jeu, publiez des produits à l’aide de l’option Enable Private Audience de la page « Pricing and availability » dans Partner Center.
Pour tester dans RETAIL après la sortie de votre jeu, utilisez une version d’évaluation de package (package flight).Configuration requise
En-tête : XStore.h (inclus dans XGameRuntime.h) Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesDocumentation conceptuelle
- Implémenter les achats en jeu dans votre jeu
- Opérations de base du Store
- Accorder aux joueurs l’accès au contenu des extensions
- Vue d’ensemble des systèmes de commerce du GDK
- Limitation de débit granulaire pour les API du Microsoft Store
- Outil de droits de développement du Store (DevEntitlementTool.exe)
Voir aussi
XStoreXStoreQueryAssociatedProductsResult
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
Opérations de base du Store
Accorder aux joueurs l’accès au contenu des extensions
