Azure Communication CallingServer-Clientbibliothek für .NET – Version 1.0.0-beta.3

  • Artikel

Dieses Paket enthält ein C#-SDK für Azure Communication Services für Anrufe.

Quellcode |Produktdokumentation

Erste Schritte

Installieren des Pakets

Installieren Sie die Azure Communication CallingServer-Clientbibliothek für .NET mit NuGet:

dotnet add package Azure.Communication.CallingServer --version 1.0.0-beta.3

Voraussetzungen

Sie benötigen ein Azure-Abonnement und eine Communication Service-Ressource , um dieses Paket verwenden zu können.

Um einen neuen Kommunikationsdienst zu erstellen, können Sie das Azure-Portal, die Azure PowerShell oder die .NET-Verwaltungsclientbibliothek verwenden.

Wichtige Begriffe

CallingServerClient bietet die Funktionalität zum Herstellen einer Anrufverbindung, zum Verbinden einer Anrufverbindung oder zum Initialisieren eines Serveraufrufs.

Verwenden von Anweisungen

using System;
using System.Collections.Generic;
using Azure.Communication.CallingServer;

Authentifizieren des Clients

Der aufrufende Serverclient kann mithilfe der Verbindungszeichenfolge authentifiziert werden, die von einer Azure-Kommunikationsressource im Azure-Portal abgerufen wurde.

var connectionString = "<connection_string>"; // Find your Communication Services resource in the Azure portal
CallingServerClient callingServerClient = new CallingServerClient(connectionString);

Alternativ können Sie auch ein gültiges Active Directory-Token verwenden.

var endpoint = new Uri("https://my-resource.communication.azure.com");
TokenCredential tokenCredential = new DefaultAzureCredential();
var client = new CallingServerClient(endpoint, tokenCredential);

Beispiele

Tätigen eines Anrufs bei einem Telefonnummernempfänger

Um einen ausgehenden Aufruf auszuführen, rufen Sie die - oder CreateCallConnectionAsync -CreateCallConnectionFunktion aus aufCallingServerClient.

var createCallOption = new CreateCallOptions(
       new Uri(TestEnvironment.AppCallbackUrl),
       new[] { MediaType.Audio },
       new[]
       {
           EventSubscriptionType.ParticipantsUpdated,
           EventSubscriptionType.DtmfReceived
       });

var callConnection = await callingServerClient.CreateCallConnectionAsync(
    source: new CommunicationUserIdentifier("<source-identifier>"), // Your Azure Communication Resource Guid Id used to make a Call
    targets: new List<CommunicationIdentifier>() { new PhoneNumberIdentifier("<targets-phone-number>") }, // E.164 formatted recipient phone number
    options: createCallOption // The options for creating a call.
    );
Console.WriteLine($"Call connection id: {callConnection.Value.CallConnectionId}");

Problembehandlung

Ein RequestFailedException wird als Dienstantwort für alle nicht erfolgreichen Anforderungen ausgelöst. Die Ausnahme enthält Informationen darüber, welcher Antwortcode vom Dienst zurückgegeben wurde.

Nächste Schritte

Mitwirken

Beiträge und Vorschläge für dieses Projekt sind willkommen. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. Weitere Informationen finden Sie unter cla.microsoft.com.

Für dieses Projekt gelten die Microsoft-Verhaltensregeln für Open Source (Microsoft Open Source Code of Conduct). Weitere Informationen finden Sie in den häufig gestellten Fragen zum Verhaltenskodex. Sie können sich auch an opencode@microsoft.com wenden, wenn Sie weitere Fragen oder Anmerkungen haben.