Pular para o conteúdo principal

Visão geral

Os recursos de Matchmaking e Lobby têm suporte interno a mensagens em tempo real. Enviar mensagens aos jogadores sobre alterações no Matchmaking ou no Lobby nunca foi tão fácil, pois o trabalho de tratar as mensagens é feito para você no SDK de Lobby e Matchmaking do PlayFab. Novas APIs permitem que os clientes conectados assinem mensagens sobre alterações no Lobby e no Matchmaking. Com essa adição, você não precisará mais sondar alterações em partidas ou lobbies. O SDK foi projetado para simplificar seu trabalho. O SDK gerencia as chamadas entre clientes ou servidores de jogo e os serviços de Lobby e Matchmaking do PlayFab. Ele cuida da entrega de mensagens desses serviços aos clientes conectados em tempo real. As mensagens em tempo real têm suporte multiplataforma e funcionam em qualquer lugar em que o PlayFab forneça um SDK. O Matchmaking e o Lobby podem ser usados separadamente ou juntos, e as mensagens em tempo real funcionarão em ambos os casos. No momento, não há suporte a mensagens em tempo real sem o SDK. As mensagens em tempo real não estão disponíveis como solução autônoma ou para uso geral.

Como funcionam as mensagens em tempo real

Cada cliente mantém um único WebSocket para receber mensagens em tempo real. Quando há atualizações em recursos de Matchmaking ou Lobby na nuvem, o SDK encaminha mensagens em tempo real a todos os clientes conectados que assinam esses recursos. Quando um cliente se conecta para receber mensagens em tempo real, ele abre uma nova conexão WebSocket para receber mensagens e escutar eventos de alteração. Quando um cliente cria um lobby, ingressa em um lobby, começa a escutar convites ou cria um tíquete de Matchmaking, o cliente conectado assina um recurso de Lobby ou Matchmaking para escutar alterações. O cliente será notificado quando houver uma atualização no tópico do recurso que ele assinou. Por exemplo, se um cliente tiver assinado um recurso de Lobby, ele poderá ser notificado sobre eventos de alteração, como o jogador A ou B ter entrado em um lobby ou saído dele. A documentação de Matchmaking e Lobby descreve em mais detalhes as operações que geram mensagens. A conexão WebSocket que permite as mensagens em tempo real também é usada para detectar a conectividade do cliente. Esse status de conectividade do cliente é usado pelo serviço de Lobby para viabilizar o gerenciamento de propriedade do lobby.

Suporte a conexão compartilhada

As mensagens de Matchmaking e Lobby oferecem suporte ao compartilhamento de uma única conexão WebSocket, o que pode ser útil se você estiver criando um título com cooperativo local. Hoje, até oito usuários locais podem compartilhar a conexão WebSocket, e jogadores locais podem ser adicionados ou removidos dessa conexão compartilhada. Vários usuários que compartilham a mesma conexão podem assinar tópicos para receber mensagens sobre eventos de Matchmaking ou Lobby desses tópicos.

Usar o SDK

O SDK simplifica seu trabalho para o jogo entre redes e entre plataformas tratando as mensagens em tempo real para você. As mensagens são enviadas aos clientes ao receber convites, ingressar em lobbies e atualizá-los, encontrar partidas e muito mais. O SDK permite o jogo entre plataformas e mensagens em tempo real em qualquer plataforma em que o PlayFab ofereça suporte de SDK. O envio de mensagens aos clientes é automático, e o desenvolvedor não precisa fazer nenhum trabalho para habilitar as mensagens.
Última modificação em 8 de outubro de 2026