XStoreShowPurchaseUIAsync
Inicia a sobreposição da interface do usuário de compra para o produto especificado.Sintaxe
Parâmetros
storeContextHandle _In_Tipo: XStoreContextHandle O identificador de contexto da loja para o usuário retornado por XStoreCreateContext. storeId _In_z_
Tipo: char* ID do produto a ser comprado. name _In_opt_z_
Tipo: char* Nome do produto a ser comprado. extendedJsonData _In_opt_z_
Tipo: char* Um blob JSON que é entregue ao fluxo de compra. Permite a inserção de IDs de campanha personalizadas, para que você possa acompanhar como a compra foi iniciada. async _Inout_
Tipo: XAsyncBlock* Um XAsyncBlock que define o trabalho assíncrono que está sendo feito. O XAsyncBlock pode ser usado para sondar o status da chamada e recuperar os resultados da chamada. Consulte XAsyncBlock para obter mais informações.
Valor retornado
Tipo: HRESULT Código de êxito ou de erro HRESULT.Comentários
![NOTE] Esta operação não dispara o download nem a instalação dos itens após uma compra esperada. Se você quiser baixar e instalar esse conteúdo, é recomendável chamar XStoreDownloadAndInstallPackagesAsync após uma compra bem-sucedida. Nenhum aviso adicional será exibido ao usuário.
![NOTE] No PC, a caixa de diálogo de confirmação de compra exibida após uma compra bem-sucedida terá um botão de fechar [X] na parte superior. Selecioná-lo em vez de Ok fará com que E_ABORT seja retornado para XStoreShowPurchaseUIResult, o que pode não ser desejado. Esse é o comportamento padrão do Windows quando qualquer caixa de diálogo é fechada dessa forma.
Para recuperar o resultado desta função, chame XStoreShowPurchaseUIResult após chamar esta função. Esta função só deve ser chamada quando o usuário tiver optado por comprar algo e fará com que o sistema apresente uma caixa de diálogo de compra modal que lida com as informações de pagamento e a confirmação do usuário fora do processo.
O trecho de código a seguir mostra um exemplo de solicitação de compra de um produto específico da loja.
Requisitos
Cabeçalho: XStore.h (incluído em XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX SeriesDocumentação conceitual
- Implementar compras no jogo
- Operações básicas da loja
- Gerenciar e licenciar conteúdo para download (DLC)
- Solução de problemas de desenvolvimento do XStore
Confira também
XStoreXStoreShowPurchaseUIResult
