XStoreQueryAssociatedProductsAsync
Obtiene información de descripción de la Store de los productos que los usuarios pueden comprar desde dentro del juego actual.Sintaxis
Parámetros
storeContextHandle _In_Tipo: XStoreContextHandle El identificador del contexto de la tienda para el usuario devuelto por XStoreCreateContext. productKinds _In_
Tipo: XStoreProductKind El tipo de productos que se van a devolver. maxItemsToRetrievePerPage _In_
Tipo: uint32_t El número máximo de elementos que se recuperarán por página. El número de elementos devueltos por página puede variar de 0 a
maxItemsToRetrievePerPage.
Para obtener más información, consulte Paginación.
async _Inout_Tipo: XAsyncBlock* Un XAsyncBlock que define el trabajo asincrónico que se está realizando. Use el XAsyncBlock para sondear el estado de la llamada y recuperar los resultados de la llamada. Para obtener más información, consulte XAsyncBlock.
Valor devuelto
Tipo: HRESULT HRESULT de operación correcta o código de error.Comentarios
Para obtener la información de descripción de la Store y el resultado de la ejecución de esta función, llame a XStoreQueryAssociatedProductsResult después de llamar a esta función. XStoreQueryAssociatedProductsResult contiene unXStoreProductQueryHandle que se enumera llamando a XStoreEnumerateProductsQuery.
No es posible conocer de antemano el número de productos que devuelve esta consulta.
Esta API solo devuelve productos que los usuarios pueden examinar en Microsoft Store o comprar dentro del juego.
Los resultados no incluyen ningún producto que esté oculto, expirado o eliminado de la tienda.
Si necesita detalles de un producto de este tipo, use XStoreQueryProductsAsync y pase el identificador de la tienda del producto.
Paginación
Esta función devuelve productos en varias páginas (hastamaxItemsToRetrievePerPage elementos en una sola página).
Use XStoreProductsQueryHasMorePages y XStoreProductsQueryNextPageAsync/XStoreProductsQueryNextPageResult para procesar todos los resultados paginados.
La paginación no está completa hasta que XStoreProductsQueryHasMorePages devuelve false.
La paginación puede comportarse de forma diferente entre los sandboxes y RETAIL.
En un sandbox, los elementos se acumulan hasta
maxItemsToRetrievePerPage antes de que se devuelva una página.
En RETAIL, es habitual que se devuelvan de 0 a 1 elementos por página.Es importante que todos los juegos que usen esta API implementen y prueben la paginación antes del lanzamiento.Para probar el comportamiento de la paginación en un sandbox, establezca temporalmente maxItemsToRetrievePerPage en un valor inferior al número de productos publicados en su sandbox.
Para probar en RETAIL antes del lanzamiento de su juego, publique productos con la opción Enable Private Audience de la página ‘Pricing and availability’ de Partner Center.
Para probar en RETAIL después del lanzamiento de su juego, use un paquete piloto.Requisitos
Encabezado: XStore.h (incluido en XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesDocumentación conceptual
- Implementación de compras dentro del juego en su juego
- Operaciones básicas de la tienda
- Concesión a los jugadores de acceso al contenido de complementos
- Información general de los sistemas de comercio de GDK
- Limitación de frecuencia detallada para las API de Microsoft Store
- Herramienta de derechos de desarrollo de la tienda (DevEntitlementTool.exe)
Consulte también
XStoreXStoreQueryAssociatedProductsResult
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
Operaciones básicas de la tienda
Concesión a los jugadores de acceso al contenido de complementos
