Biblioteca cliente de Azure Communication CallingServer para .NET: versión 1.0.0-beta.3

Este paquete contiene un SDK de C# para Azure Communication Services para llamadas.

Código | fuente Documentación del producto

Introducción

Instalar el paquete

Instale la biblioteca cliente CallingServer de Azure Communication para .NET con NuGet:

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

Prerrequisitos

Necesita una suscripción de Azure y un recurso de Communication Service para usar este paquete.

Para crear un servicio de comunicación, puede usar Azure Portal, la Azure PowerShell o la biblioteca cliente de administración de .NET.

Conceptos clave

CallingServerClient proporciona la funcionalidad para realizar la conexión de llamada, unirse a la conexión de llamada o inicializar una llamada de servidor.

Uso de las instrucciones

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

Autenticar el cliente

El cliente de servidor de llamadas se puede autenticar mediante la cadena de conexión adquirida desde un recurso de comunicación de Azure en Azure Portal.

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

También puede usar un token de Active Directory válido.

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

Ejemplos

Realizar una llamada a un destinatario de número de teléfono

Para realizar una llamada saliente, llame a la CreateCallConnection función o CreateCallConnectionAsync desde .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}");

Solución de problemas

Se RequestFailedException produce como una respuesta de servicio para las solicitudes incorrectas. La excepción contiene información sobre qué código de respuesta se devolvió del servicio.

Pasos siguientes

Contribuciones

Este proyecto agradece las contribuciones y sugerencias. La mayoría de las contribuciones requieren que acepte un Contrato de licencia para el colaborador (CLA) que declara que tiene el derecho a concedernos y nos concede los derechos para usar su contribución. Para obtener más información, visite cla.microsoft.com.

Este proyecto ha adoptado el Código de conducta de Microsoft Open Source. Para más información, consulte las preguntas más frecuentes del código de conducta o póngase en contacto con opencode@microsoft.com si tiene cualquier otra pregunta o comentario.