Udostępnij za pośrednictwem

Biblioteka klienta usługi Azure Communication Network dla języka JavaScript — wersja 1.0.0

  • Artykuł

Usługa Azure Communication Network Traversal zarządza tokenami dla Azure Communication Services.

Zapewni to użytkownikowi poświadczenia TURN.

Wprowadzenie

Wymagania wstępne

Instalowanie

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

Obsługa przeglądarki

Pakiet JavaScript

Aby użyć tej biblioteki klienta w przeglądarce, najpierw musisz użyć pakietu. Aby uzyskać szczegółowe informacje na temat tego, jak to zrobić, zapoznaj się z naszą dokumentacją dotyczącą tworzenia pakietów.

Kluczowe pojęcia

Przykłady

Authentication

Parametry klucza i/lub połączenia można uzyskać z zasobu usług Communication Services w witrynie Azure Portal. Po utworzeniu klucza możesz uwierzytelnić element CommunicationRelayClient przy użyciu dowolnej z następujących metod:

Utwórz KeyCredential za pomocą AzureKeyCredential przed zainicjowaniem 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);

Używanie parametrów połączenia

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

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

Korzystanie z elementu TokenCredential

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

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

Jeśli używasz klucza do inicjowania klienta, musisz również podać odpowiedni punkt końcowy. Ten punkt końcowy można uzyskać z zasobu usług Communication Services w witrynie Azure Portal.

Użycie

Tworzenie wystąpienia klasy CommunicationRelayClient

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

const client = new CommunicationRelayClient(CONNECTION_STRING);

Tworzenie wystąpienia klasy CommunicationIdentityClient w celu utworzenia użytkownika

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

const client = new CommunicationIdentityClient(CONNECTION_STRING);

createUser Użyj metody , aby utworzyć nowego użytkownika.

const user = await client.createUser();

Pobieranie konfiguracjiRelay

getConfigurationRelay Użyj metody , aby uzyskać nowe poświadczenia TURN dostarczające użytkownikowi

const config = relayClient.getRelayConfiguration(user);

Możesz również wywołać metodę getConfigurationRelay bez podawania użytkownika

const config = relayClient.getRelayConfiguration();

Podczas wywoływania można określić typ trasy getConfigurationRelay

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

Rozwiązywanie problemów

Następne kroki

Zapoznaj się z katalogiem samples , aby uzyskać szczegółowe przykłady dotyczące sposobu korzystania z tej biblioteki.

Współtworzenie

Jeśli chcesz współtworzyć tę bibliotekę, przeczytaj przewodnik współtworzenia , aby dowiedzieć się więcej na temat sposobu kompilowania i testowania kodu.

Wrażenia