Login

O login dos serviços relacionados a jogos do Google Play autentica os jogadores com os serviços relacionados a jogos do Google Play e fornece identidades de jogos do Android (ID do jogador) para uso em dispositivos diferentes. O login oferece suporte ao serviço de Jogos salvos, mas você também pode usar o ID do jogador como uma chave para o serviço de salvamento na nuvem.

Versão do SDK

Este tópico é para o SDK dos serviços relacionados a jogos do Google Play v2. Para mais informações sobre o SDK anterior, consulte a documentação dos serviços relacionados a jogos do Google Play v1.

O SDK dos serviços relacionados a jogos do Google Play v2 fornece estas melhorias de login em relação à v1:

  • Melhorias para os usuários:
    • Depois de selecionar uma conta padrão, os usuários fazem login sem precisar interagir com uma solicitação.
  • Melhorias para desenvolvedores:
    • O código do cliente não precisa mais processar o fluxo de login ou saída, já que o login é acionado automaticamente quando o jogo é iniciado e o gerenciamento da conta é processado nas configurações do SO.

Cota de solicitação de login

Há uma cota diária para solicitações de login usando os serviços relacionados a jogos do Google Play. Para mais informações, consulte Como gerenciar sua cota diária.

Vários serviços de login

Os serviços relacionados a jogos do Google Play oferecem uma identidade de jogo para jogadores do Android, mas não precisam ser a única identidade conectada aos usuários. Você pode fazer o login dos jogadores usando os serviços relacionados a jogos do Google Play, um ID de rede social e seu próprio sistema de IDs no jogo ao mesmo tempo.

Login automático

Quando um jogador inicia um jogo com o login automático ativado, ele é conectado ao jogo sem interagir com a solicitação de login. Os jogadores podem ativar o login automático no app Google Play Games ou na solicitação de login inicial mostrada no jogo.

Solicitação de login automático

ID do jogador

Um ID de jogador é um identificador de uma conta de jogador dos serviços relacionados a jogos do Google Play. Seu jogo pode extrair o ID de qualquer jogador que se conecte usando o login dos serviços relacionados a jogos do Google Play. O cliente do jogo, os servidores de back-end de jogos e o serviço de salvamento na nuvem podem usar o ID para acessar com segurança os dados dos jogadores nos serviços relacionados a jogos do Google Play.

Um ID do jogador é consistente para um usuário que acessa o jogo em vários dispositivos. No entanto, ele nem sempre é consistente entre jogos diferentes.

Escopos do OAuth

Os serviços relacionados a jogos do Google Play dependem do sistema OAuth para que o usuário permita que o jogo acesse a conta dele. Os serviços relacionados a jogos do Google Play têm um escopo exclusivo para jogos (games-lite) e dependem de outro escopo (drive.app_data) caso o jogo use o recurso de Jogos salvos. O recurso de Jogos salvos dá acesso à conta do Google Drive do usuário, em que os dados do jogo são armazenados.

Ao usar o SDK dos serviços relacionados a jogos do Google Play v2, não é possível solicitar escopos OAuth extras. Se você precisar de outros escopos de OAuth, recomendamos o uso do SDK de Login do Google com os serviços relacionados a jogos do Google Play.

Integração do cliente de jogo

Ao integrar o login no seu projeto de jogo, recomendamos o seguinte fluxo de usuário:

  1. Durante a sequência de inicialização do jogo, o login automático é iniciado e tenta conectar o usuário ou criar uma nova conta.

  2. Se o login automático não funcionar ou o usuário recusar, um botão de login manual vai aparecer mais tarde para que o usuário possa fazer login caso mude de ideia.

Para informações sobre como integrar o login ao seu projeto de jogo, consulte o guia para seu tipo de projeto:

Integração do servidor de jogos

Depois que um jogador faz login no seu jogo usando os serviços de login, seu servidor de back-end de jogos pode se comunicar diretamente com os servidores dos serviços relacionados a jogos do Google Play para acessar o ID, o perfil, a lista de amigos e outros dados associados a esses serviços. Isso requer um código de autorização do servidor fornecido pelo SDK dos serviços relacionados a jogos do Google Play. Seu servidor pode usar o código de autorização junto com a API REST dos serviços relacionados a jogos do Google Play para se comunicar com segurança com os servidores.

Para mais informações, consulte Acesso do servidor aos serviços relacionados a jogos do Google Play.