Utiliser le terrain de jeu pour explorer les fonctionnalités d’Azure Web PubSub

Playground est un outil basé sur un navigateur qui vous aide à utiliser les fonctionnalités de messagerie en temps réel d’Azure Web PubSub, sans code ni configuration locale requise. En quelques clics, vous pouvez créer des clients, joindre des groupes et envoyer des messages à l’aide d’API côté client et côté serveur.

Ce guide vous guide tout au long de deux scénarios de messagerie courants dans le terrain de jeu, tout en vous aidant à comprendre des concepts importants tels que les connexions, les groupes et les messages.

Contenu

Vous explorez deux modèles de messagerie souvent utilisés dans les applications en temps réel :

• Messagerie de serveur à groupe : utilisation de l’API sendToGroup pour diffuser des messages vers tous les clients d’un groupe.
• Messagerie client à groupe : Azure Web PubSub prend en charge une fonctionnalité qui permet à un client d’un groupe d’envoyer des messages directement à d’autres clients du même groupe, sans routage via votre serveur d’applications, ce qui réduit la latence.

Concepts clés

Avant de commencer, voici un actualisation rapide sur les concepts principaux d’Azure Web PubSub avec lesquels vous interagissez dans le terrain de jeu :

• Hub : unité logique utilisée pour isoler et organiser la logique de messagerie. Les clients se connectent toujours à un hub. Avec playground, le trafic réel passe par la ressource. Pour ce tutoriel, nous vous recommandons de spécifier un nom de hub de test qui ne chevauche pas votre trafic de production.
• Connexion : connexion WebSocket persistante entre un client et le service Azure Web PubSub.
• Groupe : sous-ensemble géré par le serveur de connexions. Les messages envoyés à un groupe sont remis uniquement aux connexions au sein de ce groupe.
• Messages : charges utiles échangées entre les clients et le service. Les messages peuvent être diffusés vers tous, ciblés par des groupes ou dirigés vers des connexions individuelles.

Scénario 1 : Envoyer un message à un groupe à partir du serveur

Dans ce scénario, vous simulez la diffusion côté serveur à l’aide de l’API sendToGroup REST. Ce scénario montre comment le service achemine un message de votre back-end vers tous les clients d’un groupe spécifié.

Étapes

1. Dans le portail Azure, accédez à votre ressource Azure Web PubSub.
2. Ouvrez le volet Playground.
3. Cliquez sur + Ajouter un client pour créer plusieurs connexions.
4. Affectez chaque client à un groupe (par exemple, group1).
5. Sous l’onglet Serveur de la section « Publier des messages », sélectionnez Envoyer au groupe.
6. Entrez le nom du groupe (group1), un exemple de message et appelez l’API sendToGroup .
7. Basculez vers l’onglet Client et observez le message dans le journal des messages de chaque client.

Ce que vous apprenez

Vous envoyez des messages à un groupe de clients à l’aide d’API RESTful. Playground montre comment fonctionne la communication de serveur à groupe sans avoir à déployer un serveur principal. Azure Web PubSub fournit également des kits SDK de serveur pour C#, JavaScript, Java et Python.

Pour visualiser la diffusion de messages en action, essayez de répéter les étapes avec plusieurs clients. Playground prend en charge jusqu’à cinq clients simulés simultanés.

Scénario 2 : Envoyer un message à un groupe à partir d’un client

Dans ce scénario, vous créez un client envoyant un message à d’autres clients du même groupe, comme un utilisateur qui publie un message dans une salle de conversation.

Étapes

1. Dans le terrain de jeu, ajoutez deux clients ou plus et spécifiez la même valeur pour le Initial Groups champ.
2. Pour le client qui envoie le message, sélectionnez Autoriser le client à envoyer à tous les groupes.
3. Basculez vers le panneau de ce client, spécifiez le nom du groupe, entrez un message, puis cliquez sur Appeler.
4. Les autres clients du groupe reçoivent le message en temps réel.

Ce que vous apprenez

Ce scénario présente la messagerie client à groupe, qui est idéale dans les applications où les allers-retours de serveur présentent une latence inutile. Il s’agit d’un composant principal du modèle de publication/abonnement du client Web PubSub.

Étapes suivantes

• En savoir plus sur les concepts clés dans Azure Web PubSub
• Pour créer un exemple local, suivez le guide de démarrage rapide
• Explorer les guides sous « Guides pratiques » pour les tâches courantes lors du développement avec Azure Web PubSub