Interagir com amigos em Jogos Instantâneos

Com os Jogos Instantâneos, há várias maneiras de possibilitar interações sociais entre os jogadores.

Jogadores conectados

O método FBInstant.player.getConnectedPlayersAsync() recupera uma lista de usuários conectados ao jogador atual no Messenger. O resultado incluirá somente usuários que concederam ao jogo permissão para acessar as informações deles.

Observação: o método não diferencia jogadores que estavam ou não jogando no mesmo contexto. É possível buscar informações específicas sobre isso em FBInstant.context.getPlayersAsync().

Buscar amigos do jogador

FBInstant.player.getConnectedPlayersAsync()
  .then(function(players) {
    _leaderboard.render(players);
  }); 

Buscar jogadores em contexto

FBInstant.context.getPlayersAsync()
  .then(function(players) {
    _leaderboard.render(players);
  }); 

Como alterar contextos

Os Jogos Instantâneos podem ser jogados em diversos contextos, como conversas no Messenger ou stories no Feed. Com as chamadas do SDK abaixo, é possível alternar contextos de qualquer sessão, independentemente do ponto de entrada. Isso significa que é possível permitir aos jogadores alternar para outras conversas sem exigir que eles saiam e reabram o jogo.

Oferecemos três métodos diferentes de mudança de contexto:

  • FBInstant.context.chooseAsync() abre um diálogo nativo que permite ao jogador selecionar para qual conversa trocar.
  • FBInstant.context.switchAsync(contextId) permite que o desenvolvedor envie o jogador a um contexto predefinido. Por exemplo, continuar uma partida iniciada anteriormente em outra conversa.
  • FBInstant.context.createAsync(playerId) tenta criar um contexto com o jogador especificado. Por exemplo, iniciar uma partida entre um jogador e um amigo sugerido.

Como jogar com outros jogadores com pareamento

Fornecemos ferramentas para seu jogo para levar os jogadores a novos contextos com nossas APIs de pareamento e contexto. Descobrimos que pessoas que jogam com outros jogadores acabam retendo melhor do que jogadores de contexto individual. Isso acontece devido a uma série de motivos:

  1. Atualizações personalizadas no contexto podem fornecer um ponto de entrada atrativo de volta ao jogo
  2. Jogos sociais aumentam a retenção porque as pessoas se divertem mais quando jogam juntas.

A dinâmica social significativa no jogo em si destacará seu jogo instantâneo e motivará os jogadores a compartilhá-lo com todos os seus amigos.

Uso recomendado:

  1. Use a API de pareamento para oferecer aos jogadores uma experiência de jogo social sem depender de interações com amigos. Isso é especialmente útil em jogos baseados em revezamento e de vários jogadores, mas também pode beneficiar outros tipos de jogos caso os jogadores não tenham amigos que joguem determinado jogo, seus amigos não joguem com frequência suficiente ou eles só queiram uma experiência de jogo diferente.
  2. Faça trocas entre jogadores de AI se oponentes aleatórios deixarem a partida antes que ela termine

Ao fazer uma chamada a matchPlayerAsync(), o jogo tentará parear o jogador atual em um contexto com outro jogador. Incluímos um parâmetro adicional para especificar se você quer que o jogo mude para o contexto recém-criado depois do pareamento ou espere o usuário clicar em Jogar no aviso.

Há dois mecanismos de pareamento:

  1. Síncrono: une o jogador atual a outros usuários que estão buscando pessoas com quem jogar. Caso seja bem-sucedido, uma nova conversa com os jogadores pareados será criada no Messenger, e o atual será enviado ao contexto dela. Isso será resolvido quando o jogador tiver sido enviado para o contexto correspondente.
  2. Assíncrono: o jogador iniciando o jogo offline será adicionado ao grupo da conversa com outros que iniciaram a partida offline antes. Os jogadores podem sair do jogo enquanto esperam que mais pessoas participem. Saiba mais. Depois do pareamento, o jogador será adicionado e enviado ao contexto da conversa. Isso será resolvido quando o jogador tiver sido adicionado à conversa do grupo e enviado para o contexto correspondente.

O número padrão mínimo e máximo de jogadores em uma conversa pareada é 2 e 20 respectivamente, dependendo de quantos jogadores estão tentando fazer pareamento ao mesmo tempo. Esses valores podem ser alterados em fbapp-config.json.