Pustaka klien Azure Communication Network Traversal untuk JavaScript - versi 1.0.0

Azure Communication Network Traversal mengelola token untuk Azure Communication Services.

Ini akan memberikan kredensial TURN kepada pengguna.

Memulai

Prasyarat

• Langganan Azure.
• Sumber daya Communication Services yang ada. Jika Anda perlu membuat sumber daya, Anda dapat menggunakan Portal Microsoft Azure,Azure PowerShell, atau Azure CLI.

Menginstal

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

Dukungan browser

Bundel JavaScript

Untuk menggunakan pustaka klien ini di browser, pertama-tama Anda perlu menggunakan bunder. Untuk detail tentang cara melakukan ini, silakan lihat dokumentasi bundling kami.

Konsep utama

Contoh

Autentikasi

Anda bisa mendapatkan kunci dan/atau string koneksi dari sumber daya Communication Services Anda di Portal Microsoft Azure. Setelah memiliki kunci, Anda dapat mengautentikasi CommunicationRelayClient dengan salah satu metode berikut:

Buat KeyCredential dengan AzureKeyCredential sebelum menginisialisasi klien

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

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

Menggunakan string koneksi

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

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

Menggunakan TokenCredential

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

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

Jika Anda menggunakan kunci untuk menginisialisasi klien, Anda juga perlu menyediakan titik akhir yang sesuai. Anda bisa mendapatkan titik akhir ini dari sumber daya Communication Services Anda di Portal Microsoft Azure.

Penggunaan

Membuat instans CommunicationRelayClient

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

const client = new CommunicationRelayClient(CONNECTION_STRING);

Membuat instans CommunicationIdentityClient untuk membuat pengguna

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

const client = new CommunicationIdentityClient(CONNECTION_STRING);

createUser Gunakan metode untuk membuat pengguna baru.

const user = await client.createUser();

Mendapatkan configurationRelay

getConfigurationRelay Gunakan metode untuk mendapatkan kredensial TURN baru yang menyediakan pengguna

const config = relayClient.getRelayConfiguration(user);

Anda juga dapat memanggil getConfigurationRelay metode tanpa menyediakan pengguna

const config = relayClient.getRelayConfiguration();

Anda dapat menentukan RouteType saat memanggil getConfigurationRelay

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

Pemecahan Masalah

Langkah berikutnya

Silakan lihat direktori sampel untuk contoh terperinci tentang cara menggunakan pustaka ini.

Berkontribusi

Jika Anda ingin berkontribusi pada pustaka ini, baca panduan berkontribusi untuk mempelajari selengkapnya tentang cara membuat dan menguji kode.

Proyek terkait

• Microsoft Azure SDK untuk Javascript