Migração da API para o SDK

Se os jogos nativos do Google Play Games no PC chamarem diretamente as APIs do Play Faturamento, 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 demonstram 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 dele. 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 Initialize SDK o quanto antes. Tome as medidas necessárias de acordo com o 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 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 após 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: