Azure Web PubSub-Dienstclientbibliothek für .NET

Azure Web PubSub Service ist ein von Azure verwalteter Dienst, mit dem Entwickler problemlos Webanwendungen mit Echtzeitfeatures und Veröffentlichungsabonnentmuster erstellen können. Jedes Szenario, das Echtzeit-Publish-Subscribe-Messaging zwischen Server und Clients oder zwischen Clients erfordert, kann den Azure Web PubSub-Dienst verwenden. Herkömmliche Echtzeitfeatures, die häufig eine Abfrage vom Server oder das Senden von HTTP-Anforderungen erfordern, können auch den Azure Web PubSub-Dienst verwenden.

Sie können diese Bibliothek auf Der App-Serverseite verwenden, um die WebSocket-Clientverbindungen zu verwalten, wie im folgenden Diagramm dargestellt:

Verwenden Sie diese Bibliothek, um:

• Nachrichten an Hubs und Gruppen senden.
• Nachrichten an bestimmte Benutzer und Verbindungen senden.
• Organisieren Sie Benutzer und Verbindungen in Gruppen.
• Schließen von Verbindungen
• Erteilen, Widerrufen und Überprüfen von Berechtigungen für eine vorhandene Verbindung

Quellcode | Paket | API-Referenzdokumentation | Produktdokumentation | Beispiele

Erste Schritte

Installiere das Paket

Installieren Sie die Clientbibliothek von NuGet:

dotnet add package Azure.Messaging.WebPubSub

Voraussetzungen

• Ein Azure-Abonnement.
• Eine vorhandene Azure Web PubSub-Dienstinstanz.

Erstellen und Authentifizieren eines WebPubSubServiceClient

Um mit dem Dienst zu interagieren, müssen Sie eine Instanz der WebPubSubServiceClient Klasse erstellen. Um dies zu ermöglichen, benötigen Sie die Verbindungszeichenfolge oder einen Schlüssel, auf den Sie im Azure-Portal zugreifen können.

var serviceClient = new WebPubSubServiceClient(new Uri(endpoint), "some_hub", new AzureKeyCredential(key));

Examples

Senden einer Sms an alle Clients

var serviceClient = new WebPubSubServiceClient(new Uri(endpoint), "some_hub", new AzureKeyCredential(key));

serviceClient.SendToAll("Hello World!");

Übertragen einer JSON-Nachricht an alle Clients

var serviceClient = new WebPubSubServiceClient(new Uri(endpoint), "some_hub", new AzureKeyCredential(key));

serviceClient.SendToAll(RequestContent.Create(
        new
        {
            Foo = "Hello World!",
            Bar = 42
        }),
        ContentType.ApplicationJson);

Übertragen einer binären Nachricht an alle Clients

var serviceClient = new WebPubSubServiceClient(new Uri(endpoint), "some_hub", new AzureKeyCredential(key));

Stream stream = BinaryData.FromString("Hello World!").ToStream();
serviceClient.SendToAll(RequestContent.Create(stream), ContentType.ApplicationOctetStream);

Problembehandlung

Einrichten der Konsolenprotokollierung

Sie können auch die Konsolenprotokollierung aktivieren , wenn Sie tiefer in die Anforderungen eingehen möchten, die Sie für den Dienst vornehmen.

Nächste Schritte

Erstellen Sie mithilfe dieser Ressourcen Ihre eigene Anwendung: