Migração da API para o SDK

Se os jogos nativos do Google Play Games no PC chamarem diretamente as APIs Play Billing, migre seu jogo para usar o SDK para PC.

Dependendo do mecanismo de jogo que você está usando, é possível integrar o C++ SDK ou o C# SDK. Consulte os projetos de exemplo que mostram exemplos que podem ser usados para migrar seu jogo nativo para o SDK.

Configuração e preparação

Esta seção descreve as etapas de migração de uma solução baseada em API para o SDK nativo do Google Play Games no PC.

Argumentos de linha de comando

O SDK nativo do Google Play Games no PC depende de alguns argumentos de linha de comando transmitidos durante a inicialização do processo do jogo para autenticar usuários. Esses argumentos precisam ser transmitidos ao processo que chama Initialize SDK. Se a inicialização do jogo envolver vários processos, verifique se todos os argumentos são transmitidos para o processo que usa o SDK. Confira a etapa Compatibilidade com vários processos de jogos da configuração.

Mapeamento da API

Para concluir a migração, remova todas as chamadas diretas de API para os servidores do Google Play. Há chamadas de função correspondentes no SDK para alcançar a mesma funcionalidade. Esta seção lista o mapeamento de cada funcionalidade.

Login do Google

O Login do Google, também conhecido como Fazer login com o Google, é um método de autenticação OAuth que oferece uma opção de autenticação com um clique para usuários com uma Conta do Google. Em projetos baseados em API, você associa a conta de um jogador às compras dele. As soluções baseadas em SDK não exigem essa associação.

As soluções baseadas em SDK usam a Conta do Google do cliente do Google Play Games, que já está associada ao perfil do jogador e aos direitos. Isso oferece uma experiência mais integrada para os jogadores e um ambiente mais seguro para os desenvolvedores, porque o SDK pode se comunicar com segurança com o cliente do Google Play Games por IPC.

Em vez do Google Sign-In, chame Inicializar SDK o quanto antes. Tome as medidas necessárias com base no código de erro para oferecer um ambiente seguro ao tempo de execução do jogo.

Receber lista de produtos

Na solução de API, o servidor de back-end recupera a lista de produtos usando o endpoint inappproduct.gets da API Play Developer.

No SDK, recupere a lista de produtos no app diretamente no cliente usando a função QueryProductDetails.

Impulsionar compras

Na solução de API, o servidor de back-end recupera as compras do usuário usando o endpoint purchases.products.get da API do Google Play Developer.

No SDK, use a função QueryPurchases diretamente do cliente do jogo.

Iniciar o fluxo de compra

Na solução de API, iniciar o fluxo de compra exige chamar vários endpoints para configuração e aquisição dos tokens necessários.

No SDK, inicie o processo chamando a função LaunchPurchaseFlow do BillingClient. O SDK processa todo o trabalho necessário.

Processar a compra

Processar a compra do usuário envolve reconhecer e consumir a compra depois de validar que ela é legítima. As soluções de API e SDK recomendam as etapas a serem concluídas no back-end por motivos de segurança.

O processo é semelhante para as soluções de API e SDK:

Depois de recuperar o purchaseToken da compra, como ProductPurchase.purchaseToken na solução de API ou ProductPurchaseDetails's purchase_token na solução de SDK, envie para seu back-end para verificação.

Depois da verificação, seu back-end pode confirmar ou consumir a compra com segurança depois de conceder o direito de acesso.

Enviar para teste

Para enviar seu jogo para teste, siga estas etapas.

Pacote para envio

Os jogos que usam o SDK precisam ser empacotados no formato Windows App Bundle e enviados por upload pelo Play Console. Consulte a documentação para empacotar seu jogo em Windows App Bundle para: