Amigos

Use as APIs Friends para complementar e melhorar o sistema de amigos no jogo e outros sistemas sociais que ele pode acessar. Isso permite que os jogadores:

  • Encontrem os amigos no jogo.

  • Comparem as pontuações com os amigos em placares.

  • Combinem a lista de amigos do Play Games com as já existentes no jogo.

  • Identifiquem outro jogador com um pop-up de perfil no jogo. Esse pop-up mostra um apelido que o jogador atual deu ao amigo, para que ele saiba com quem está jogando.

Importar amigos

Noções básicas

Essas APIs permitem realizar as seguintes ações:

  • Acessar informações de amigos: você pode verificar se o jogador permitiu que o jogo acesse as informações da lista de amigos. Se o acesso for concedido, você vai conseguir uma lista de objetos do jogador correspondentes aos amigos daquele que fez login.
  • Iniciar uma visualização do perfil de outro jogador no Play Games: você pode abrir essa visualização para mostrar o nome atribuído ao outro jogador pelo usuário conectado. Essa visualização também oferece controles de gerenciamento de amizade e não tira o jogador do jogo.
  • Fornecer controles do usuário: o usuário tem controles para gerenciar como o perfil do Play Games fica visível para amigos e como a lista de amigos fica visível para jogos. Para a lista de amigos, o usuário pode conceder automaticamente acesso a todos os jogos ou aprovar cada jogo individualmente. Consequentemente, ao carregar a lista de amigos, o resultado pode ser um callback para exibir uma solicitação de acesso.

Importar uma lista de amigos do Play Games

Você pode usar as APIs Friends para ver a lista de amigos dos seus jogadores no Play Games e adicioná-las à sua lista de amigos no jogo.

Os novos usuários têm uma lista inicial de amigos para jogar. Usuários já existentes podem importar os amigos do Play Games para qualquer lista de jogos. Como resultado, os usuários terão o maior conjunto possível de participantes para jogar ou competir.

Adicionar amigos do Play Games ao seu jogo

Adicione amigos do Play Games a qualquer lista de amigos no jogo associando o ID às informações correspondentes dos jogadores no banco de dados interno. Você precisa ter um botão com o ícone do Play Games ao lado desses amigos, que mostra o perfil do outro jogador quando pressionado, para que os usuários possam saber quem são os amigos.

Ao usar a lista de amigos de um servidor de back-end, carregue-a de forma segura usando a API REST em vez de transmitir o resultado da API do Android. Use o ID do jogador retornado por players.get(me) na API REST para o jogador conectado no momento, porque ele será consistente com o ID visto por outros jogadores.

Se a lista de amigos aumentada não for armazenada, mas usada apenas no momento da visualização, nenhuma outra tarefa será necessária.

Permitir acesso ao Play Games

Se o jogo ainda não tem acesso ao Play Games, um bom momento para pedir o consentimento dos usuários é quando eles visualizam a lista de amigos no jogo. Por exemplo, você pode adicionar um botão chamado Importar amigos do Play Games, que solicita o consentimento do usuário quando tocado. Use o logotipo do Play Games em qualquer botão que mencione o serviço.

Visitar o perfil de outro jogador

Você pode permitir que o jogador conectado visite o perfil do Play Games de outro jogador. Isso permite que o usuário que fez login confira o nome que deu ao outro jogador e se ele já é amigo, dando mais contexto sobre o relacionamento. Se os jogadores ainda não forem amigos, o jogador conectado verá os controles de gerenciamento de amizade na visualização de perfil. Quando amizades são criadas dentro do jogo, os nomes padrão dos dois jogadores são os nomes dentro do jogo (se você fornecer um). O nome do jogo em que a amizade foi iniciada também é mostrado.

Visitar o perfil de outro jogador

Placares sociais

As APIs Friends também podem ser usadas para placares. Use esse recurso para mostrar a classificação do jogador atual entre os amigos dele no Play Games. Isso se aplica apenas a usuários que optaram por compartilhar essas informações com seu app e se eles forem amigos no Play Games. Para oferecer suporte a esse recurso, o jogo mostra um controle para o usuário. Esse controle usa o argumento collection para selecionar a visualização de redes sociais do placar. Para saber mais, consulte a seção sobre placares públicos e sociais.

Amigos em um placar

Se você implementar a coleção de placares sociais, a chamada para carregar as pontuações deles pode retornar uma exceção de resolução obrigatória de consentimento semelhante a loadFriends(). Se você implementar a IU padrão fornecida pelo Play Games (por exemplo, getLeaderboardIntent()), isso será feito automaticamente.

Próximas etapas

Antes de começar a usar as APIs Friends, faça o seguinte: