你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

适用于 .NET 的 Azure 通信呼叫服务器客户端库 - 版本 1.0.0-beta.3

项目
04/18/2023

此包包含一个 C# SDK for Azure 通信服务 for Calling。

入门

安装包

使用 NuGet 安装适用于 .NET 的 Azure Communication CallingServer 客户端库：

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

先决条件

需要一个 Azure 订阅和一个通信服务资源才能使用此包。

若要创建新的通信服务，可以使用 Azure 门户、Azure PowerShell或 .NET 管理客户端库。

关键概念

CallingServerClient 提供建立呼叫连接、加入呼叫连接或初始化服务器调用的功能。

使用语句

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

验证客户端

可以使用从 Azure 门户中的 Azure 通信资源获取的连接字符串对调用服务器客户端进行身份验证。

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

或者，使用有效的 Active Directory 令牌。

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

示例

呼叫电话号码收件人

若要进行出站调用，请CreateCallConnection从 CallingServerClient调用或 CreateCallConnectionAsync 函数。

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

疑难解答

RequestFailedException对于任何不成功的请求，将作为服务响应引发。异常包含有关从服务返回的响应代码的信息。

后续步骤

贡献

本项目欢迎贡献和建议。大多数贡献要求你同意贡献者许可协议 (CLA)，并声明你有权（并且确实有权）授予我们使用你的贡献的权利。有关详细信息，请访问 cla.microsoft.com。

此项目采用了 Microsoft 开放源代码行为准则。有关详细信息，请参阅行为准则常见问题解答，或如果有任何其他问题或意见，请与联系。

通过