O login dos serviços relacionados a jogos do Google Play fornece uma forma de acessar a identidade de um jogador, que é específica para jogadores Android no nível da plataforma. Essa identidade ajuda a criar uma relação entre jogo e jogador. Os jogadores estão mais dispostos a usar essa identidade para fazer login do que sistemas centralizados alternativos.
Além disso, o login é um identificador forte e consistente que pode ser usado como chave para um sistema de salvamento na nuvem. Com ele, os jogadores podem:
- Continuar de onde pararam se mudarem ou redefinirem o dispositivo para a configuração original
- Jogar em vários dispositivos, como outro smartphone ou um Chromebook
- Desinstalar e reinstalar o jogo
É possível usar a identidade dos serviços relacionados a jogos do Google Play como chave para sua própria solução de salvamento na nuvem ou ainda usar o serviço de Jogos salvos.
Os serviços relacionados a jogos do Google Play (PGS, na sigla em inglês) oferecem suporte ao login automático, uma maneira sem atrito de e o login manual, que é um processo com um clique. Isso documento descreve esses diferentes métodos de login.
Fluxo de login recomendado
Para fazer login dos jogadores, use o fluxo de login abaixo:
- Durante a sequência de inicialização do jogo, tente usar o Login automático. para fazer o login do jogador automaticamente.
- Se o login automático não funcionar e o dispositivo do usuário estiver on-line, tente usar o login manual.
- Se o login manual for recusado, lembrar da escolha do usuário e não mostrar login manual novamente, mas continue tentando o login automático na inicialização.
Além disso, você deve garantir que os usuários consigam fazer login no jogo com a conta dos serviços relacionados a jogos do Google Play com um botão dedicado e fácil de encontrar.
Login automático
Com o login automático, os usuários podem entrar no seu jogo sem atrito. automática! Se o jogo solicitar que o usuário faça login e o login automático estiver ativada (no app Google Play Games), você vai receber o PGS do usuário as credenciais de identidade e o usuário terá acesso à experiência de login dos serviços relacionados a jogos do Google Play.
O login automático é uma configuração que pode ser controlada pelo usuário. Ele pode decidir fazer login automaticamente em todos os jogos ou fazer a escolha toda vez.
Login manual
Se um usuário não fizer login automaticamente no jogo, você poderá pedir que ele faça login manualmente. Os usuários podem fazer login com um clique em uma caixa de diálogo exibida na parte de cima do seu jogo.
Permita pop-ups dos Serviços relacionados a jogos do Google Play para a experiência de login correta
Ao usar esses serviços, os usuários precisam saber que estão conectados. Para isso, mostre a experiência de login dos serviços relacionados a jogos do Google Play.
Para mostrar a experiência de login, chame o método
setViewForPopups()
da classe GamesClient durante a inicialização do jogo. Isso é fundamental para
ativar a experiência correta do usuário.
Escopos do OAuth e PGS
Os serviços relacionados a jogos do Google Play dependem do sistema OAuth para permitir que os usuários façam o seguinte: dê ao jogo acesso à conta dele. Os escopos do OAuth são permissões que você, que o desenvolvedor pode solicitar. Se concedidas, essas permissões permitem que o jogo chame determinados APIs em nome do usuário e também lhe dão acesso a determinadas partes da Conta do Google.
Os serviços relacionados a jogos do Google Play têm um escopo exclusivo para jogos (games-lite) e precisam de outro escopo.
(drive.appdata) se o jogo usa 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.
Seu jogo pode solicitar qualquer escopo necessário para criar uma ótima experiência para seus usuários. Seu jogo pode solicitar todos os escopos necessários em um pacote, limitando o número de solicitações de acesso a Contas do Google. No entanto, tem uma grande desvantagem. Se você solicitar mais escopos do que os específicos do PGS, o login automático não terá êxito. O login automático é a melhor maneira de jogadores que fizeram login no jogo.
A prática recomendada é usar solicitações de escopo incremental. Seu jogo precisa pedir Escopos somente do PGS primeiro na solicitação inicial e depois na solicitação de outros escopos separadamente em um momento mais relevante.
O acesso OAuth é concedido usando uma tela diferente para cada escopo. Isso permite que os usuários decidam, de maneira granular, a quais escopos conceder acesso. Usando login automático apenas com escopos do PGS, os usuários não precisam interagir Solicitações OAuth, reduzindo o atrito no login.
Suporte a vários métodos de login
O PGS oferece uma identidade de jogo para jogadores do Android, mas não precisa ser a única identidade conectada aos seus usuários. É possível fazer login de jogadores usando os serviços relacionados a jogos do Google Play (PGS, na sigla em inglês), uma ID de rede social e seu próprio sistema de ID no jogo, tudo ao mesmo tempo. Cada sistema agrega valor único para você e seus jogadores, e todos podem funcionar para criar uma ótima experiência para os jogadores do Android.
Extrair e verificar com segurança a identidade do jogador para integração com back-end
Você pode solicitar um código de autenticação do servidor para permitir a comunicação direta com os serviços relacionados a jogos do Google Play usando a API REST com a autoridade do jogador conectado. Isso permite o acesso direto ao ID, perfil e outras informações do jogador, como uma lista de amigos, se autorizado. Se você armazenar IDs de jogador, amigos ou outros dados relacionados no back-end, esse método vai precisar ser usado para remover a possibilidade de manipulação desses campos do lado do dispositivo.
Além disso, para alguns jogos e jogadores mais antigos, o ID do jogador retornado pelo
SDK do Android pode não ser o mesmo que os outros veem ao
encontrar o jogador no jogo. Isso é muito relevante ao usar
a lista de amigos. No entanto, o player_id retornado na API REST é
sempre consistente e é sempre o ID mostrado a outros jogadores.
Para mais informações, consulte Acesso off-line e a documentação da API REST.
Implementação do cliente
Para aprender a implementar o suporte a login no Android, consulte Login em jogos do Android.