Com os Jogos Instantâneos, há várias maneiras de possibilitar interações sociais entre os jogadores.
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); }); |
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.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:
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:
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:
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.