Pular para o conteúdo principal
As APIs REST e SignalR documentadas aqui são mais complexas do que os SDKs de cliente. Considere usar o SDK C++ do Lobby ou o SDK C++ do Matchmaking, a menos que esses SDKs não atendam às suas necessidades.
O recurso de mensagens em tempo real dos serviços do Lobby e do Matchmaking funciona por meio de um serviço SignalR, que expõe um Hub do SignalR. Esse Hub do SignalR pode ser usado pelos clientes de jogo para receber mensagens sobre os recursos que eles assinaram.

Conectando-se ao Hub do SignalR

A primeira etapa para receber mensagens em tempo real é criar um cliente SignalR. O cliente pode criar uma conexão com o Hub do SignalR instanciando uma HubConnection com a seguinte API: API REST Negotiate do SignalR. Essa API implementa a API Negotiate descrita na documentação do SignalR.
O uso da codificação MessagePack (MsgPack) ao se conectar ao Hub do SignalR é altamente recomendado e, no futuro, será imposto como a única codificação com suporte.
O cliente deve definir KeepAliveInterval como 5 segundos ao criar a HubConnection. O serviço de back-end atingirá o tempo limite e fechará as conexões que não receberem um ping de keep-alive em até 10 segundos. O KeepAliveInterval padrão do SignalR, de 15 segundos, é lento demais e causará desconexões. csharp var connection = new HubConnectionBuilder() .WithUrl(hubUrl, options => { /* auth headers */ }) .WithKeepAliveInterval(TimeSpan.FromSeconds(5)) .Build(); Para obter mais detalhes sobre a configuração do cliente SignalR, consulte a documentação de configuração do SignalR.
  1. As implementações de cliente do SignalR esperam que a URL omita a parte /negotiate desse caminho (por exemplo, a HubConnection deve ser criada para uma URL que termine em ...playfabapi.com/pubsub). 1. Os cabeçalhos de autenticação necessários para chamar essa API podem ser passados ao cliente SignalR por meio de HttpConnectionOptions, como visto neste método.

Implementando métodos de cliente para receber mensagens

Consulte a documentação do cliente SignalR sobre a implementação de métodos de cliente que serão invocados para receber mensagens. Os clientes devem implementar todos os métodos listados em Métodos de cliente abaixo.

Iniciando e encerrando uma sessão chamando métodos de servidor

Consulte a documentação do cliente SignalR sobre como chamar métodos de servidor para gerenciar sua sessão. Por exemplo, depois de se conectar ao hub, você deve chamar StartOrRecoverSession para receber um connection handle que pode ser usado para assinar recursos. Da mesma forma, quando terminar a sessão, chame EndSession.

Assinando recursos

Depois que uma sessão for iniciada com StartOrRecoverSession, você poderá usar o connection handle retornado para começar a assinar recursos e receber mensagens.

APIs

Métodos de cliente

Métodos de servidor

Métodos de sessão compartilhada

Confira também

Última modificação em 8 de outubro de 2026