Aracılığıyla paylaş


JavaScript için Azure İletişim Ağı Dolaşma istemci kitaplığı - sürüm 1.0.0

Azure İletişim Ağı Geçişi, Azure İletişim Hizmetleri belirteçlerini yönetir.

Kullanıcıya TURN kimlik bilgileri sağlar.

Başlarken

Önkoşullar

Yükleme

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

Tarayıcı desteği

JavaScript Paketi

Bu istemci kitaplığını tarayıcıda kullanmak için önce bir paketleyici kullanmanız gerekir. Bunun nasıl yapılacağının ayrıntıları için lütfen paketleme belgelerimize bakın.

Önemli kavramlar

Örnekler

Kimlik Doğrulaması

Azure Portal'da İletişim Hizmetleri kaynağınızdan bir anahtar ve/veya bağlantı dizesi alabilirsiniz. Bir anahtarınız olduğunda, aşağıdaki yöntemlerden herhangi biriyle kimliğini doğrulayabilirsiniz CommunicationRelayClient :

İstemciyi başlatmadan önce ile AzureKeyCredential oluşturma KeyCredential

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

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

Bağlantı dizesi kullanma

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

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

Bir TokenCredential

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

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

İstemciyi başlatmak için bir anahtar kullanırsanız, uygun uç noktayı da sağlamanız gerekir. Bu uç noktayı Azure Portal'daki İletişim Hizmetleri kaynağınızdan alabilirsiniz.

Kullanım

CommunicationRelayClient örneği oluşturma

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

const client = new CommunicationRelayClient(CONNECTION_STRING);

Kullanıcı oluşturmak için CommunicationIdentityClient örneği oluşturma

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

const client = new CommunicationIdentityClient(CONNECTION_STRING);

createUser Yeni bir kullanıcı oluşturmak için yöntemini kullanın.

const user = await client.createUser();

configurationRelay alma

getConfigurationRelay Kullanıcı sağlayan yeni TURN kimlik bilgilerini almak için yöntemini kullanın

const config = relayClient.getRelayConfiguration(user);

Ayrıca bir kullanıcı sağlamadan yöntemini çağırabilirsiniz getConfigurationRelay

const config = relayClient.getRelayConfiguration();

Çağırırken bir RouteType belirtebilirsiniz getConfigurationRelay

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

Sorun giderme

Sonraki adımlar

Bu kitaplığın nasıl kullanılacağına ilişkin ayrıntılı örnekler için lütfen samples dizinine göz atın.

Katkıda bulunma

Bu kitaplığa katkıda bulunmak isterseniz, kodu derleme ve test etme hakkında daha fazla bilgi edinmek için lütfen katkıda bulunma kılavuzunu okuyun.

İzlenimler