Biblioteca de clientes do Azure Communication CallingServer para .NET – versão 1.0.0-beta.3

Artigo
04/18/2023

Esse pacote contém um SDK do C# para Serviços de Comunicação do Azure para Chamada.

Introdução

Instalar o pacote

Instale a biblioteca de clientes do Azure Communication CallingServer para .NET com o NuGet:

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

Pré-requisitos

Você precisa de uma assinatura do Azure e de um Recurso do Serviço de Comunicação para usar esse pacote.

Para criar um novo Serviço de Comunicação, você pode usar o Portal do Azure, o Azure PowerShell ou a biblioteca de clientes de gerenciamento do .NET.

Principais conceitos

CallingServerClient fornece a funcionalidade para fazer conexão de chamada, unir conexão de chamada ou inicializar uma chamada de servidor.

Como usar instruções

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

Autenticar o cliente

O cliente do servidor de chamada pode ser autenticado usando a cadeia de conexão adquirida de um Recurso de Comunicação do Azure no Portal do Azure.

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

Ou, como alternativa, usando um token válido do Active Directory.

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

Exemplos

Fazer uma chamada para um destinatário de número de telefone

Para fazer uma chamada de saída, chame a CreateCallConnection função ou CreateCallConnectionAsync do 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}");

Solução de problemas

Um RequestFailedException é gerado como uma resposta de serviço para solicitações malsucedidas. A exceção contém informações sobre qual código de resposta foi retornado do serviço.

Próximas etapas

Contribuição

Este projeto aceita contribuições e sugestões. A maioria das contribuições exige que você concorde com um CLA (Contrato de Licença do Colaborador) declarando que você tem o direito de nos conceder, e de fato concede, os direitos de usar sua contribuição. Para obter detalhes, visite cla.microsoft.com.

Este projeto adotou o Código de Conduta de Software Livre da Microsoft. Para obter mais informações, confira as Perguntas frequentes sobre o Código de Conduta ou contate opencode@microsoft.com para enviar outras perguntas ou comentários.

Compartilhar via