Verwenden des Playgrounds zum Erkunden der Azure Web PubSub-Funktionen

Playground ist ein browserbasiertes Tool, mit dem Sie die Echtzeitnachrichtenfunktionen von Azure Web PubSub verwenden können– kein Code oder lokales Setup erforderlich. Mit nur wenigen Klicks können Sie Clients erstellen, Gruppen beitreten und Nachrichten mithilfe clientseitiger und serverseitiger APIs senden.

Dieser Leitfaden führt Sie durch zwei gängige Messaging-Szenarien im Playground und hilft Ihnen dabei, wichtige Konzepte wie Verbindungen, Gruppen und Nachrichten zu verstehen.

Lerninhalt

Sie untersuchen zwei Messagingmuster, die häufig in Echtzeitanwendungen verwendet werden:

• Server-zu-Gruppen-Messaging: Verwenden der sendToGroup API zum Übertragen von Nachrichten an alle Clients in einer Gruppe.
• Client-zu-Gruppen-Messaging: Azure Web PubSub unterstützt eine Funktion, mit der ein Client in einer Gruppe Nachrichten direkt an andere Clients in derselben Gruppe senden kann – ohne Routing über Ihren App-Server – die Latenz zu verringern.

Wichtige Begriffe

Bevor wir beginnen, finden Sie hier eine schnelle Aktualisierung der wichtigsten Azure Web PubSub-Konzepte, mit denen Sie im Playground interagieren:

• Hub: Eine logische Einheit, die zum Isolieren und Organisieren von Messaginglogik verwendet wird. Clients stellen immer eine Verbindung mit einem Hub her. Playground leitet den realen Datenverkehr über die Ressource. Es wird empfohlen, für dieses Tutorial einen Testhubnamen anzugeben, der nicht mit Ihrem Produktionsdatenverkehr überlappt.
• Verbindung: Eine dauerhafte WebSocket-Verbindung zwischen einem Client und dem Azure Web PubSub-Dienst.
• Gruppe: Eine vom Server verwaltete Teilmenge von Verbindungen. An eine Gruppe gesendete Nachrichten werden nur an die Verbindungen innerhalb dieser Gruppe übermittelt.
• Nachrichten: Die Nutzlasten, die zwischen Clients und dem Dienst ausgetauscht werden. Nachrichten können an alle gesendet, gezielt an Gruppen gerichtet oder an einzelne Verbindungen gerichtet werden.

Szenario 1: Senden einer Nachricht an eine Gruppe vom Server

In diesem Szenario simulieren Sie die serverseitige Übertragung mithilfe der sendToGroup REST-API. In diesem Szenario wird veranschaulicht, wie der Dienst eine Nachricht von Ihrem Back-End an alle Clients in einer bestimmten Gruppe weiter leitet.

Schritte

1. Navigieren Sie im Azure-Portal zu Ihrer Azure Web PubSub-Ressource.
2. Öffnen Sie den Playground-Bereich.
3. Klicken Sie auf +Client hinzufügen , um mehrere Verbindungen zu erstellen.
4. Weisen Sie jedem Client eine Gruppe zu (z. B group1. ).
5. Wählen Sie auf der Registerkarte "Server " im Abschnitt "Nachrichten veröffentlichen" die Option "An Gruppe senden" aus.
6. Geben Sie den Gruppennamen (group1), eine Beispielnachricht ein, und rufen Sie die sendToGroup API auf.
7. Wechseln Sie zur Registerkarte "Client ", und beobachten Sie, wie die Nachricht im Nachrichtenprotokoll jedes Clients angezeigt wird.

Was Sie lernen

Sie senden Nachrichten mithilfe von RESTful-APIs an eine Gruppe von Clients. Playground veranschaulicht, wie die Kommunikation zwischen Servern und Gruppen funktioniert, ohne ein Back-End bereitstellen zu müssen. Azure Web PubSub stellt auch Server-SDKs für C#, JavaScript, Java und Python bereit.

Um nachrichtenübertragungen in Aktion zu visualisieren, versuchen Sie, die Schritte mit mehreren Clients zu wiederholen. Playground unterstützt bis zu fünf gleichzeitig simulierte Clients.

Szenario 2: Senden einer Nachricht an eine Gruppe von einem Client

In diesem Szenario erstellen Sie einen Client, der eine Nachricht an andere Clients in derselben Gruppe sendet – ähnlich wie ein Benutzer, der eine Nachricht in einem Chatroom veröffentlicht.

Schritte

1. Fügen Sie im Playground zwei oder mehr Clients hinzu, und geben Sie denselben Wert für das Initial Groups Feld an.
2. Wählen Sie für den Client, der die Nachricht sendet, die Option "Client zum Senden an alle Gruppen zulassen" aus.
3. Wechseln Sie zum Bereich dieses Clients, geben Sie den Gruppennamen an, geben Sie eine Nachricht ein, und klicken Sie auf "Aufrufen".
4. Die anderen Clients in der Gruppe erhalten die Nachricht in Echtzeit.

Was Sie lernen

In diesem Szenario werden Client-zu-Gruppen-Messaging vorgestellt, was ideal in Anwendungen ist, in denen Server-Roundtrips unnötige Latenzen auslösen. Es ist ein Kernteil des Clientveröffentlichungs-/Abonnentenmodells von Web PubSub.

Nächste Schritte

• Weitere Informationen zu wichtigen Konzepten in Azure Web PubSub
• Um ein lokales Beispiel zu erstellen, folgen Sie der Schnellstartanleitung
• Erkunden Sie Leitfäden unter "Schritt-für-Schritt-Anleitungen" für allgemeine Aufgaben bei der Entwicklung mit Azure Web PubSub.