Klientská knihovna Azure Communication Network Traversal pro JavaScript – verze 1.0.0
Azure Communication Network Traversal spravuje tokeny pro Azure Communication Services.
Uživateli poskytne přihlašovací údaje TURN.
Začínáme
Požadavky
- Předplatné Azure
- Existující prostředek komunikačních služeb. Pokud potřebujete vytvořit prostředek, můžete použít Azure Portal, Azure PowerShell nebo Azure CLI.
Instalace
npm install @azure/communication-network-traversal
npm install @azure/communication-identity
Podpora prohlížečů
JavaScript Bundle
Pokud chcete tuto klientskou knihovnu používat v prohlížeči, musíte nejprve použít bundler. Podrobnosti o tom, jak to udělat, najdete v naší dokumentaci k sdružování.
Klíčové koncepty
Příklady
Authentication
Klíč nebo připojovací řetězec můžete získat z prostředku Komunikační služby na webu Azure Portal. Jakmile budete mít klíč, můžete ho CommunicationRelayClient
ověřit některou z následujících metod:
Vytvoření KeyCredential
pomocí AzureKeyCredential
před inicializací klienta
import { AzureKeyCredential } from "@azure/core-auth";
import { CommunicationRelayClient } from "@azure/communication-network-traversal";
const credential = new AzureKeyCredential(KEY);
const client = new CommunicationRelayClient(ENDPOINT, credential);
Použití připojovacího řetězce
import { CommunicationRelayClient } from "@azure/communication-network-traversal";
const connectionString = `endpoint=ENDPOINT;accessKey=KEY`;
const client = new CommunicationRelayClient(connectionString);
Použití TokenCredential
import { DefaultAzureCredential } from "@azure/identity";
import { CommunicationRelayClient } from "@azure/communication-network-traversal";
const credential = new DefaultAzureCredential();
const client = new CommunicationRelayClient(ENDPOINT, credential);
Pokud k inicializaci klienta použijete klíč, budete také muset zadat příslušný koncový bod. Tento koncový bod můžete získat z prostředku komunikačních služeb na webu Azure Portal.
Využití
Vytvoření instance CommunicationRelayClient
import { CommunicationRelayClient } from "@azure/communication-network-traversal";
const client = new CommunicationRelayClient(CONNECTION_STRING);
Vytvoření instance CommunicationIdentityClient pro vytvoření uživatele
import { CommunicationIdentityClient } from "@azure/communication-identity";
const client = new CommunicationIdentityClient(CONNECTION_STRING);
createUser
Pomocí metody vytvořte nového uživatele.
const user = await client.createUser();
Získání konfiguraceRelay
getConfigurationRelay
Použití metody k získání nových přihlašovacích údajů TURN pro uživatele
const config = relayClient.getRelayConfiguration(user);
Můžete také volat metodu getConfigurationRelay
bez zadání uživatele.
const config = relayClient.getRelayConfiguration();
Typ trasy můžete zadat při volání. getConfigurationRelay
const config = relayClient.getRelayConfiguration(user, "nearest");
Řešení potíží
Další kroky
Podrobné příklady použití této knihovny najdete v adresáři samples .
Přispívání
Pokud chcete přispívat do této knihovny, přečtěte si prosím průvodce přispívání , kde se dozvíte více o tom, jak sestavit a otestovat kód.
Související projekty
Azure SDK for JavaScript