Freigeben über

Azure Communication Network Traversal-Clientbibliothek für JavaScript – Version 1.0.0

  • Artikel

Azure Communication Network Traversal verwaltet Token für Azure Communication Services.

Es stellt turn-Anmeldeinformationen für einen Benutzer bereit.

Erste Schritte

Voraussetzungen

Installieren von

npm install @azure/communication-network-traversal
npm install @azure/communication-identity

Browserunterstützung

JavaScript-Bundle

Um diese Clientbibliothek im Browser zu verwenden, müssen Sie zunächst einen Bundler verwenden. Ausführliche Informationen dazu finden Sie in unserer Bündelungsdokumentation.

Wichtige Begriffe

Beispiele

Authentifizierung

Sie können einen Schlüssel und/oder eine Verbindungszeichenfolge aus Ihrer Communication Services-Ressource im Azure-Portal abrufen. Sobald Sie über einen Schlüssel verfügen, können Sie sich CommunicationRelayClient mit einer der folgenden Methoden authentifizieren:

Erstellen KeyCredential mit AzureKeyCredential vor dem Initialisieren des Clients

import { AzureKeyCredential } from "@azure/core-auth";
import { CommunicationRelayClient } from "@azure/communication-network-traversal";

const credential = new AzureKeyCredential(KEY);
const client = new CommunicationRelayClient(ENDPOINT, credential);

Verwenden einer Verbindungszeichenfolge

import { CommunicationRelayClient } from "@azure/communication-network-traversal";

const connectionString = `endpoint=ENDPOINT;accessKey=KEY`;
const client = new CommunicationRelayClient(connectionString);

Verwenden eines TokenCredential

import { DefaultAzureCredential } from "@azure/identity";
import { CommunicationRelayClient } from "@azure/communication-network-traversal";

const credential = new DefaultAzureCredential();
const client = new CommunicationRelayClient(ENDPOINT, credential);

Wenn Sie einen Schlüssel zum Initialisieren des Clients verwenden, müssen Sie auch den entsprechenden Endpunkt angeben. Sie können diesen Endpunkt über Ihre Communication Services-Ressource im Azure-Portal abrufen.

Verbrauch

Erstellen einer Instanz von CommunicationRelayClient

import { CommunicationRelayClient } from "@azure/communication-network-traversal";

const client = new CommunicationRelayClient(CONNECTION_STRING);

Erstellen einer Instanz von CommunicationIdentityClient zum Erstellen eines Benutzers

import { CommunicationIdentityClient } from "@azure/communication-identity";

const client = new CommunicationIdentityClient(CONNECTION_STRING);

Verwenden Sie die createUser -Methode, um einen neuen Benutzer zu erstellen.

const user = await client.createUser();

Abrufen der KonfigurationRelay

Verwenden Sie die getConfigurationRelay -Methode, um neue TURN-Anmeldeinformationen abzurufen, die einen Benutzer bereitstellen.

const config = relayClient.getRelayConfiguration(user);

Außerdem können Sie die getConfigurationRelay -Methode aufrufen, ohne einen Benutzer bereitzustellen.

const config = relayClient.getRelayConfiguration();

Sie können beim Aufrufen von RouteType einen RouteType angeben. getConfigurationRelay

const config = relayClient.getRelayConfiguration(user, "nearest");

Problembehandlung

Nächste Schritte

Ausführliche Beispiele zur Verwendung dieser Bibliothek finden Sie im Beispielverzeichnis .

Mitwirken

Wenn Sie an dieser Bibliothek mitwirken möchten, lesen Sie die Anleitung für Mitwirkende, um mehr darüber zu erfahren, wie Sie den Code erstellen und testen können.

Aufrufe