Les API REST et SignalR documentées ici sont plus complexes que les SDK clients. Envisagez plutôt d’utiliser le SDK C++ Lobby ou le SDK C++ Matchmaking, sauf si ces SDK ne répondent pas à vos besoins.
Connexion au hub SignalR
La première étape pour recevoir des messages en temps réel consiste à créer un client SignalR. Le client peut créer une connexion au hub SignalR en instanciant une HubConnection avec l’API suivante : API REST SignalR Negotiate. Cette API implémente l’API Negotiate décrite dans la documentation SignalR.Le client doit définir
KeepAliveInterval sur 5 secondes lors de la création de la HubConnection. Le service principal fait expirer et ferme les connexions qui ne reçoivent pas de ping de maintien en vie dans un délai de 10 secondes. La valeur KeepAliveInterval par défaut de SignalR, soit 15 secondes, est trop lente et provoquera des déconnexions. csharp var connection = new HubConnectionBuilder() .WithUrl(hubUrl, options => { /* auth headers */ }) .WithKeepAliveInterval(TimeSpan.FromSeconds(5)) .Build(); Pour plus de détails sur la configuration du client SignalR, consultez la documentation sur la configuration de SignalR.- Les implémentations de client SignalR s’attendent à ce que l’URL omette la partie
/negotiatede ce chemin (par exemple, la HubConnection doit être créée vers une URL se terminant par...playfabapi.com/pubsub). 1. Les en-têtes d’authentification requis pour appeler cette API peuvent être transmis au client SignalR au moyen deHttpConnectionOptions, comme indiqué sur cette méthode.
Implémentation des méthodes client pour recevoir des messages
Consultez la documentation du client SignalR sur l’implémentation des méthodes client qui seront appelées pour recevoir des messages. Les clients doivent implémenter toutes les méthodes répertoriées dans la section Méthodes client ci-dessous.Démarrage et fin d’une session par l’appel de méthodes serveur
Consultez la documentation du client SignalR sur l’appel des méthodes serveur pour gérer votre session. Par exemple, une fois connecté au hub, vous devez appeler StartOrRecoverSession pour recevoir unconnection handle que vous pouvez utiliser pour vous abonner à des
ressources. De même, une fois que vous en avez terminé avec la
session, appelez EndSession.
Abonnement aux ressources
Une fois qu’une session a été démarrée avec StartOrRecoverSession, vous pouvez utiliser leconnection handle retourné pour commencer à vous abonner à des
ressources et à recevoir des messages.