Bibliothèque de client Azure Communication CallingServer pour .NET - version 1.0.0-beta.3

Article
04/19/2023

Ce package contient un Kit de développement logiciel (SDK) C# pour Azure Communication Services pour l’appel.

Prise en main

Installer le package

Installez la bibliothèque de client Azure Communication CallingServer pour .NET avec NuGet :

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

Prérequis

Vous avez besoin d’un abonnement Azure et d’une ressource Communication Service pour utiliser ce package.

Pour créer un service communication, vous pouvez utiliser le portail Azure, le Azure PowerShell ou la bibliothèque de client de gestion .NET.

Concepts clés

CallingServerClient fournit la fonctionnalité permettant d’établir une connexion d’appel, de joindre une connexion d’appel ou d’initialiser un appel de serveur.

Utilisation d’instructions

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

Authentifier le client

Le client serveur appelant peut être authentifié à l’aide de la chaîne de connexion acquise à partir d’une ressource de communication Azure dans le portail Azure.

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

Vous pouvez également utiliser un jeton Active Directory valide.

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

Exemples

Passer un appel à un destinataire de numéro de téléphone

Pour effectuer un appel sortant, appelez la CreateCallConnection fonction ou CreateCallConnectionAsync à partir de .CallingServerClient

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}");

Dépannage

Un RequestFailedException est levée en tant que réponse de service pour toutes les demandes infructueuses. L’exception contient des informations sur le code de réponse retourné par le service.

Étapes suivantes

Contribution

Ce projet accepte les contributions et les suggestions. La plupart des contributions vous demandent d’accepter un contrat de licence de contribution (CLA) déclarant que vous avez le droit de nous accorder, et que vous nous accordez réellement, les droits d’utilisation de votre contribution. Pour plus d’informations, visitez cla.microsoft.com.

Ce projet a adopté le Code de conduite Open Source de Microsoft. Pour plus d’informations, consultez les Questions fréquentes (FAQ) sur le code de conduite ou envoyez vos questions ou vos commentaires à opencode@microsoft.com.

Partager via