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.
Opções de criação de perfil
O perfil dos serviços relacionados a jogos do Google Play é necessário para que os jogadores interajam 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.
Para decidir a experiência certa para seus usuários, escolha uma das seguintes opções:
Solicitações de criação de perfil acionadas automaticamente: as solicitações de criação de perfil aparecem automaticamente por padrão quando você inicia um jogo sem um perfil dos Serviços relacionados a jogos do Google Play.
Solicitação de criação de perfil ao iniciar um jogo (clique para ampliar). Desativar os avisos de criação de perfil na inicialização e adicionar avisos manuais após a inicialização do jogo: é possível desativar os avisos de criação de perfil acionados automaticamente pelo arquivo de manifesto. Isso permite que usuários sem um perfil dos serviços relacionados a jogos do Google Play continuem com os métodos de autenticação implementados sem precisar criar um perfil dos serviços relacionados a jogos do Google Play imediatamente.
Embora os usuários possam fazer login com qualquer provedor de identidade, recomendamos iniciar uma solicitação de criação de perfil Receber o resultado da autenticação para incentivar a inscrição na plataforma do Play Games. Acione essa solicitação a seu critério, mas verifique se ela ocorre antes que os usuários façam um progresso significativo em recursos como conquistas e rankings.
Considere acionar a solicitação de perfil durante estes momentos recomendados:
- Depois de concluir um tutorial.
- Durante um momento premiado (por exemplo, ganhar uma partida, coletar um item raro ou atingir uma meta).
- Ao iniciar uma segunda sessão.
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, analise as opções de criação de perfil e escolha uma delas.
- Se o login automático não funcionar ou o usuário recusar, um botão de login manual vai aparecer para permitir o processo 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, as opções de criação de perfil são iniciadas e tentam conectar o usuário ou criar uma nova conta.
Se a autenticação automática não funcionar ou o usuário 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 o guia 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.