Migração da API para o SDK

Se os jogos nativos do Google Play Games no PC chamarem diretamente as APIs Play Faturamento, será necessário migrar o jogo para usar o SDK do 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 o SDK de inicialização. Se a inicialização do jogo envolver vários processos, verifique se todos os argumentos são transmitidos ao processo que usa o SDK. Confira a etapa de suporte a 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 a 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 pelo IPC.

Em vez do Login do Google, chame o SDK de inicialização o mais cedo possível. Aja no código de erro de acordo com o ambiente seguro para o 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 QueryProductDetails função.

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 a chamada de vários endpoints para configuração e aquisição dos tokens necessários.

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

Processar a compra

O processamento da compra do usuário envolve o reconhecimento e o consumo da compra após a validação de que ela é legítima. A solução de API e a solução de SDK recomendam que as etapas sejam concluídas no back-end por motivos de segurança.

O processo é semelhante para a solução de API e a solução de 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-o para o back-end para verificação.

Depois de verificada, o back-end pode reconhecer ou consumir a compra com segurança após conceder o direito de acesso.

Enviar para teste

Para enviar o jogo para teste, siga estas etapas.

Pacote para envio

Os jogos que usam o SDK precisam ser empacotados no formato de pacote de app do Windows e enviados pelo Play Console. Consulte a documentação para empacotar o jogo no pacote de app do Windows para: