XStoreShowPurchaseUIAsync
Inicia la superposición de interfaz de usuario de compra para el producto especificado.Sintaxis
Parámetros
storeContextHandle _In_Tipo: XStoreContextHandle El identificador de contexto de la tienda para el usuario, devuelto por XStoreCreateContext. storeId _In_z_
Tipo: char* Identificador del producto que se comprará. name _In_opt_z_
Tipo: char* Nombre del producto que se comprará. extendedJsonData _In_opt_z_
Tipo: char* Un blob JSON que se pasa al flujo de compra. Permite insertar identificadores de campaña personalizados, para que pueda hacer un seguimiento de cómo se inició la compra. async _Inout_
Tipo: XAsyncBlock* Un XAsyncBlock que define el trabajo asincrónico que se está realizando. El XAsyncBlock se puede usar para sondear el estado de la llamada y recuperar los resultados de la llamada. Consulte XAsyncBlock para obtener más información.
Valor devuelto
Tipo: HRESULT Código HRESULT de éxito o de error.Comentarios
![NOTE] Esta operación no desencadena la descarga ni la instalación de los elementos después de una compra prevista. Si quiere descargar e instalar este contenido, se recomienda llamar a XStoreDownloadAndInstallPackagesAsync después de una compra correcta. No se mostrará ningún aviso adicional al usuario.
![NOTE] En PC, el cuadro de diálogo de confirmación de compra que se muestra después de una compra correcta tendrá un botón de cierre [X] en la parte superior. Si se selecciona este en lugar de Aceptar, se devolverá E_ABORT a XStoreShowPurchaseUIResult, lo que puede no ser lo deseado. Este es el comportamiento estándar de Windows cuando se cierra cualquier cuadro de diálogo de esta manera.
Para recuperar el resultado de esta función, llame a XStoreShowPurchaseUIResult después de llamar a esta función. Solo se debe llamar a esta función cuando el usuario haya elegido comprar algo, y hará que el sistema presente un cuadro de diálogo de compra modal que controla la información de pago y la confirmación del usuario fuera del proceso.
El siguiente fragmento de código muestra un ejemplo de solicitud de una compra para un producto concreto de la tienda.
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
- Administración y licencia de contenido descargable (DLC)
- Solución de problemas de desarrollo con XStore
Consulte también
XStoreXStoreShowPurchaseUIResult
