Azure Communication Network Traversal-clientbibliotheek voor JavaScript - versie 1.0.0

Azure Communication Network Traversal beheert tokens voor Azure Communication Services.

Hiermee worden TURN-referenties aan een gebruiker verstrekt.

Aan de slag

Vereisten

• Een Azure-abonnement.
• Een bestaande Communication Services-resource. Als u de resource moet maken, kunt u azure portal, de Azure PowerShell of de Azure CLI gebruiken.

Installeren

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

Browserondersteuning

JavaScript-bundel

Als u deze clientbibliotheek in de browser wilt gebruiken, moet u eerst een bundler gebruiken. Raadpleeg onze bundeldocumentatie voor meer informatie over hoe u dit doet.

Belangrijkste concepten

Voorbeelden

Verificatie

U kunt een sleutel en/of connection string ophalen uit uw Communication Services-resource in Azure Portal. Zodra u een sleutel hebt, kunt u de CommunicationRelayClient verifiëren met een van de volgende methoden:

Maken KeyCredential met AzureKeyCredential voordat u de client initialiseert

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

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

Een connection string gebruiken

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

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

Met behulp van een TokenCredential

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

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

Als u een sleutel gebruikt om de client te initialiseren, moet u ook het juiste eindpunt opgeven. U kunt dit eindpunt ophalen vanuit uw Communication Services-resource in Azure Portal.

Gebruik

Een exemplaar van CommunicationRelayClient maken

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

const client = new CommunicationRelayClient(CONNECTION_STRING);

Een exemplaar van CommunicationIdentityClient maken om een gebruiker te maken

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

const client = new CommunicationIdentityClient(CONNECTION_STRING);

Gebruik de createUser methode om een nieuwe gebruiker te maken.

const user = await client.createUser();

ConfigurationRelay verkrijgen

Gebruik de getConfigurationRelay methode om nieuwe TURN-referenties op te halen die een gebruiker verstrekken

const config = relayClient.getRelayConfiguration(user);

U kunt de getConfigurationRelay methode ook aanroepen zonder een gebruiker op te geven

const config = relayClient.getRelayConfiguration();

U kunt een RouteType opgeven bij het aanroepen getConfigurationRelay

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

Problemen oplossen

Volgende stappen

Bekijk de map met voorbeelden voor gedetailleerde voorbeelden van het gebruik van deze bibliotheek.

Bijdragen

Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de handleiding voor bijdragen voor meer informatie over het bouwen en testen van de code.

Verwante projecten

• Microsoft Azure SDK voor Javascript