Para integrar seu jogo aos Serviços relacionados a jogos do Google Play, primeiro implemente a autenticação de plataforma. Isso é necessário para acessar todos os outros recursos, como conquistas, rankings e eventos.
Para atender às diretrizes de experiência do usuário do Level Up do Google Play Games, seu jogo precisa estar em conformidade com o fluxo de autenticação recomendado.
Inicialização e autenticação
Esta é uma etapa obrigatória para inicializar e autenticar seu jogo:
- Implemente a autenticação da plataforma inicializando o SDK dos serviços relacionados a jogos do Google Play v2 na inicialização. Para mais informações, consulte autenticação de plataforma para jogos Android. Essa etapa é necessária para acessar recursos dos serviços relacionados a jogos do Google Play, como conquistas e rankings.
- A autenticação é executada como um processo silencioso em segundo plano durante a inicialização do jogo.
Os usuários atuais dos serviços relacionados a jogos do Google Play vão receber uma mensagem de boas-vindas após a autenticação.
Criação de perfil
Os jogadores precisam de um perfil dos serviços relacionados a jogos do Google Play para interagir com a plataforma. Alguns jogadores podem não ter um perfil dos serviços relacionados a jogos do Google Play ao iniciar seu jogo. Esses jogadores vão precisar criar uma.
Por padrão, as solicitações de criação de perfil acionadas automaticamente aparecem quando você inicia um jogo sem um perfil dos serviços relacionados a jogos do Google Play.
Fluxo de autenticação recomendado
Para atender às diretrizes de experiência do usuário do Level Up do Google Play Games, verifique se você está em conformidade com os requisitos de continuidade do jogador. Para fazer login dos jogadores, use o fluxo de autenticação abaixo:
- Durante a sequência de inicialização do jogo, implemente a criação de perfil acionada automaticamente.
- Se a autenticação automática falhar ou você recusar, mostre um botão de login manual para que você possa se autenticar mais tarde.
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 a autenticação dos serviços relacionados a jogos do Google Play. Sua integração do cliente do jogo, integração do servidor de jogos e 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. Para mais informações, consulte IDs de jogadores de última geração.
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.appdata) 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, é possível solicitar
escopos OAuth extras.
Se você precisar de outros escopos de OAuth, recomendamos chamar requestServerSideAccess.
Para mais informações, consulte
receber o código de autenticação do servidor ou recuperar códigos de autenticação do servidor.
Vários serviços de autenticação
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 autenticar 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.
API Recall
Com a API Recall, os jogos podem gerenciar links entre usuários do PGS e as contas deles no jogo armazenando tokens de recuperação com os servidores do Google. Para saber mais sobre como ativar esse recurso, consulte Integrar a API Recall do PGS ao jogo.
Integração do cliente de jogo
Ao integrar a autenticação no projeto do seu jogo, recomendamos o seguinte fluxo de usuário:
Durante a sequência de inicialização do jogo, a criação de perfil é iniciada e tenta autenticar o usuário ou criar uma nova conta.
Se a autenticação automática falhar ou você recusar, um botão de login manual vai aparecer para permitir o processo mais tarde.
Para informações sobre como integrar a autenticação ao seu projeto de jogo, consulte a documentação referente ao seu tipo de projeto:
Integração do servidor de jogos
Você pode receber um código de autorização do servidor chamando requestServerSideAccess
depois de verificar se o jogador está autenticado. Transmita esse código de autorização do servidor para o servidor de jogos de back-end para se comunicar diretamente com os servidores dos serviços relacionados a jogos do Google Play. Essa comunicação
permite que o servidor acesse dados do jogador, incluindo:
- ID do jogador
- Perfil
- Lista de amigos
- Progresso do jogo
- Conquistas
Em seguida, o servidor usa esse código de autorização com a API REST para interagir com segurança com os servidores dos serviços relacionados a jogos do Google Play. Para mais informações, consulte Acesso do servidor aos serviços relacionados a jogos do Google Play.
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.