Las API de REST y SignalR documentadas aquí son más complejas que los SDK de cliente. Considere la posibilidad de usar el SDK de C++ de Lobby o el SDK de C++ de Matchmaking en su lugar, a menos que esos SDK no satisfagan sus necesidades.
Conexión al concentrador de SignalR
El primer paso para recibir mensajes en tiempo real es crear un cliente de SignalR. El cliente puede crear una conexión con el concentrador de SignalR creando una instancia de HubConnection con la siguiente API: API de REST SignalR Negotiate. Esta API implementa la API Negotiate descrita en la documentación de SignalR.El cliente debe establecer
KeepAliveInterval en 5 segundos al compilar la HubConnection. El servicio back-end agotará el tiempo de espera y cerrará las conexiones que no reciban un ping de mantenimiento de conexión en un plazo de 10 segundos. El valor predeterminado de KeepAliveInterval de SignalR, de 15 segundos, es demasiado lento y provocará desconexiones. csharp var connection = new HubConnectionBuilder() .WithUrl(hubUrl, options => { /* auth headers */ }) .WithKeepAliveInterval(TimeSpan.FromSeconds(5)) .Build(); Para obtener más detalles sobre la configuración del cliente de SignalR, consulte la documentación de configuración de SignalR.- Las implementaciones de cliente de SignalR esperan que la dirección URL omita la parte
/negotiatede esta ruta (por ejemplo, la HubConnection se debe crear con una dirección URL que termine en...playfabapi.com/pubsub). 1. Los encabezados de autenticación necesarios para llamar a esta API se pueden pasar al cliente de SignalR medianteHttpConnectionOptions, como se ve en este método.
Implementación de métodos de cliente para recibir mensajes
Consulte la documentación del cliente de SignalR sobre la implementación de métodos de cliente que se invocarán para recibir mensajes. Los clientes deben implementar todos los métodos enumerados en Métodos de cliente a continuación.Inicio y finalización de una sesión mediante llamadas a métodos de servidor
Consulte la documentación del cliente de SignalR sobre cómo llamar a métodos de servidor para administrar su sesión. Por ejemplo, una vez conectado al concentrador, debe llamar a StartOrRecoverSession para recibir unconnection handle que puede usar para suscribirse a
recursos. Del mismo modo, cuando haya terminado con la
sesión, llame a EndSession.
Suscripción a recursos
Una vez iniciada una sesión con StartOrRecoverSession, puede usar elconnection handle devuelto para empezar a suscribirse a
recursos y recibir mensajes.