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.
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 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.- As implementações de cliente do SignalR esperam que a URL omita a parte
/negotiatedesse 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 deHttpConnectionOptions, 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 umconnection 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 oconnection handle retornado para começar a assinar
recursos e receber mensagens.
