Recursos do lado do cliente
O GDK permite que os jogos implementem vários tipos de complementos e tipos de produto no jogo, como consumíveis, duráveis (conteúdo para download), assinaturas, pacotes e avaliações. O conjunto de APIs XStore fornece a funcionalidade necessária para consultar, anunciar e gerenciar esses produtos do lado do cliente. Para ver um exemplo de uma loja no jogo totalmente funcional, consulte o exemplo GDK In-Game Store. Os artigos a seguir, na seção Fundamentos, abordam essas APIs e cenários:- Operações básicas da loja - Consultar o que está disponível para venda e o que o usuário possui
- Como usar um durável sem pacote - Usar um durável que não tem um pacote de download separado.
- Gerenciar e licenciar conteúdo para download (DLC) - Usar duráveis tradicionais com pacotes de download.
- Ecossistemas baseados em consumíveis - Configurar um modelo de monetização baseado em consumíveis no seu jogo.
- Implementar avaliações para seu jogo - Implementar uma avaliação integrada ao seu jogo.
- Pacotes e Season Passes - Usar pacotes e Season Passes para oferecer valor e engajamento aos clientes com seus produtos.
- Modelo de compartilhamento de produtos para jogos - O modelo de licenciamento para jogos do GDK no console XBOX e no PC com Windows e como o compartilhamento entre usuários é aplicado.
Recursos do lado do servidor
Os Microsoft Store Services que dão suporte às APIs do lado do cliente e permitem chamadas de serviço para serviço são divididos nos seguintes serviços:- Collections - Fornece informações sobre quais produtos o usuário possui ou tem direito de usar e atende produtos consumíveis. Também pode ser usado para detectar o status da assinatura do Game Pass para parceiros autorizados.
- Clawback - Permite que os serviços de parceiros detectem e gerenciem reembolsos emitidos aos usuários por consumíveis já atendidos.
- Purchase - Permite que os serviços de parceiros adicionem itens gratuitos à conta do usuário.
- Recurrence - Fornece informações detalhadas sobre as assinaturas de um usuário e permite que os serviços de parceiros gerenciem essas assinaturas em nome do usuário.
Autenticar com os Microsoft Store Services
Para obter informações detalhadas sobre como autenticar seu serviço com os Microsoft Store Services, consulte Solicitar um ID de usuário da Store para autenticação de serviço para serviço.Se você estiver familiarizado com a autenticação por X-token, o serviço Collections dá suporte a X-tokens.
Informações importantes para desenvolvedores que usaram o XDK
Se você estiver familiarizado com os sistemas de comércio do XDK, as definições a seguir devem ajudar a orientar você sobre como os serviços equivalentes do GDK são chamados- Inventory Service - A funcionalidade do serviço Inventory do XDK (consultar propriedade, atender consumíveis etc.) agora é tratada pelo serviço Collections. Isso inclui todos os cenários de servidor para servidor para validar a propriedade e as quantidades de consumíveis. Embora os X-tokens usados para Inventory funcionem para chamar Collections, recomendamos que os parceiros migrem para o fluxo de autenticação por token do Microsoft Entra ID e ID de usuário da Store para usar a funcionalidade expandida dos Microsoft Store Services.
Exemplo: https://collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview - APIs de cliente do Inventory - Toda a funcionalidade do lado do cliente relacionada à consulta de propriedade de itens agora é tratada por meio das APIs XStore.
Exemplo: XStoreQueryEntitledProductsAsync retorna os itens que o usuário atual tem direito de usar naquele momento. - APIs Catalog Browse - Toda a funcionalidade do lado do cliente relacionada à consulta de produtos disponíveis para compra no jogo agora é tratada por meio das APIs XStore. Não há opção de servidor para servidor para consultar produtos disponíveis para venda no seu título.
Exemplo: XStoreQueryAssociatedProductsAsync retorna produtos que podem ser vendidos como parte de uma loja no jogo. - Avaliações e licenças - Toda a funcionalidade do lado do cliente relacionada a licenças de avaliação agora faz parte das APIs XStore. Exemplo: XStoreQueryGameLicenseAsync retorna as informações de licença do jogo atual, incluindo qualquer informação de licença de avaliação. Para poder validar uma licença do lado do cliente no seu próprio serviço, consulte Usar tokens de licença para validar o licenciamento nos seus serviços.