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

加入 Teams 会议

Azure 通信服务 SDK 允许用户加入定期 Microsoft Teams 会议。 以下是操作方法！

先决条件

• 具有活动订阅的 Azure 帐户。 免费创建帐户。
• 已部署的通信服务资源。 创建通信服务资源。
• 用于启用通话客户端的用户访问令牌。 有关详细信息，请参阅创建和管理访问令牌。
• 可选：完成快速入门向应用程序添加语音呼叫

安装 SDK

使用 npm install 命令安装适用于 JavaScript 的 Azure 通信服务通用 SDK 和通话 SDK：

npm install @azure/communication-common --save
npm install @azure/communication-calling --save

初始化所需的对象

大多数通话操作需要 CallClient 实例。 创建新的 CallClient 实例时，可以使用自定义选项（如 Logger 实例）对其进行配置。

有了 CallClient 实例后，可以通过调用 createCallAgent 创建 CallAgent 实例。 此方法将异步返回 CallAgent 实例对象。

createCallAgent 方法使用 CommunicationTokenCredential 作为参数。 它接受用户访问令牌。

可在 CallClient 实例上使用 getDeviceManager 方法来访问 deviceManager。

const { CallClient } = require('@azure/communication-calling');
const { AzureCommunicationTokenCredential} = require('@azure/communication-common');
const { AzureLogger, setLogLevel } = require("@azure/logger");

// Set the logger's log level
setLogLevel('verbose');

// Redirect log output to console, file, buffer, REST API, or whatever location you want
AzureLogger.log = (...args) => {
    console.log(...args); // Redirect log output to console
};

const userToken = '<USER_TOKEN>';
callClient = new CallClient(options);
const tokenCredential = new AzureCommunicationTokenCredential(userToken);
const callAgent = await callClient.createCallAgent(tokenCredential, {displayName: 'optional Azure Communication Services user name'});
const deviceManager = await callClient.getDeviceManager()

如何最好地管理 SDK 与 Microsoft 基础结构的连接性

Call Agent 实例可帮助你管理通话（以加入或启动通话）。 通话 SDK 需要连接到 Microsoft 基础结构以获取传入通话通知并协调其他通话详细信息，否则无法工作。 你的 Call Agent 有两种可能的状态：

已连接 - Call Agent connectionStatue 值为 Connected 表示客户端 SDK 已连接，能够接收来自 Microsoft 基础结构的通知。

已断开连接 - Call Agent connectionStatue 值为 Disconnected 表示存在阻止 SDK 正确连接的问题。 应重新创建 Call Agent。

• invalidToken：如果令牌已过期或无效，Call Agent 实例会断开连接并出现此错误。
• connectionIssue：如果客户端连接到 Microsoft 基础结构时出现问题，则在多次重试后，Call Agent 会显示 connectionIssue 错误。

可以通过检查 connectionState 属性的当前值来检查本地 Call Agent 是否已连接到 Microsoft 基础结构。 在通话过程中，可以侦听 connectionStateChanged 事件，以确定 Call Agent 是否从“已连接”状态更改为“已断开连接”状态。

const connectionState = callAgentInstance.connectionState;
console.log(connectionState); // it may return either of 'Connected' | 'Disconnected'

const connectionStateCallback = (args) => {
    console.log(args); // it will return an object with oldState and newState, each of having a value of either of 'Connected' | 'Disconnected'
    // it will also return reason, either of 'invalidToken' | 'connectionIssue'
}
callAgentInstance.on('connectionStateChanged', connectionStateCallback);

会议加入方法

若要加入 Teams 会议，请使用 join 方法并传递会议链接或会议坐标。

使用会议链接加入：

const locator = { meetingLink: '<MEETING_LINK>'}
const call = callAgent.join(locator);

使用会议坐标加入（此功能现为受限预览版）：

const locator = {
    threadId: <thread id>,
    organizerId: <organizer id>,
    tenantId: <tenant id>,
    messageId: <message id>
}
const call = callAgent.join(locator);

设置系统

创建 Visual Studio 项目

对于 UWP 应用，请在 Visual Studio 2022 中创建新的“空白应用(通用 Windows)”项目。 输入项目名称后，可随意选择任何版本高于 10.0.17763.0 的 Windows SDK。

对于 WinUI 3 应用，请使用“已打包空白应用(桌面中的 WinUI 3)”模板创建新项目，以设置单页 WinUI 3 应用。 需要 Windows App SDK 版本 1.3 或更高版本。

使用 NuGet 包管理器安装包和依赖项

可通过 NuGet 包公开提供通话 SDK API 和库。

以下步骤举例说明了如何查找、下载和安装通话 SDK NuGet 包：

1. 选择“工具”>“NuGet 包管理器”>“管理解决方案的 NuGet 包”，以打开 NuGet 包管理器。
2. 选择“浏览”，然后在搜索框中输入 Azure.Communication.Calling.WindowsClient。
3. 确保已选中“包括预发行版”复选框。
4. 选择 Azure.Communication.Calling.WindowsClient 包，然后选择 Azure.Communication.Calling.WindowsClient1.4.0-beta.1 或更高版本。
5. 在右侧选项卡上选中与 Azure 通信服务项目对应的复选框。
6. 选择“安装”按钮。

会议加入方法

要加入 Teams 会议，请使用CallAgent.join方法并传递应用程序上下文、JoinMeetingLocator和JoinCallOptions。

会议 ID 和密码

TeamsMeetingIdLocator使用会议 ID 和密码查找会议。 可以在 Teams 会议的加入信息下找到这些内容。 Teams 会议 ID 长度为 12 个字符，由以三为单位分组的数字组成（即000 000 000 000）。 密码将由 6 个字母字符组成（即aBcDeF）。 密码区分大小写。

String meetingId, passcode; 
TeamsMeetingIdLocator locator = new TeamsMeetingIdLocator(meetingId, passcode);

会议链接

TeamsMeetingLinkLocator使用指向 Teams 会议的链接查找会议。 可以在 Teams 会议的加入信息下找到此内容。

String meetingLink; 
TeamsMeetingLinkLocator locator = new TeamsMeetingLinkLocator(meetingLink);

会议坐标

TeamsMeetingCoordinatesLocator使用组织者 ID、租户 ID、线程 ID 和消息 ID 查找会议。 可以使用 Microsoft Graph 找到此信息。

Guid organizerId, tenantId;
String threadId, messageId;
TeamsMeetingCoordinatesLocator locator = new TeamsMeetingCoordinatesLocator(threadId, organizerId, tenantId, messageId);

使用定位符加入会议

创建这些 Teams 会议定位符后，可以使用它通过CallAgent.join加入 Teams 会议，如下所示。

JoinCallOptions options = new JoinCallOptions();
call = agent.join(
        getApplicationContext(),
        locator,
        options);

设置系统

创建 Visual Studio 项目

对于 UWP 应用，请在 Visual Studio 2022 中创建新的“空白应用(通用 Windows)”项目。 输入项目名称后，可随意选择任何版本高于 10.0.17763.0 的 Windows SDK。

对于 WinUI 3 应用，请使用“已打包空白应用(桌面中的 WinUI 3)”模板创建新项目，以设置单页 WinUI 3 应用。 需要 Windows App SDK 版本 1.3 或更高版本。

使用 NuGet 包管理器安装包和依赖项

可通过 NuGet 包公开提供通话 SDK API 和库。

以下步骤举例说明了如何查找、下载和安装通话 SDK NuGet 包：

1. 选择“工具”>“NuGet 包管理器”>“管理解决方案的 NuGet 包”，以打开 NuGet 包管理器。
2. 选择“浏览”，然后在搜索框中输入 Azure.Communication.Calling.WindowsClient。
3. 确保已选中“包括预发行版”复选框。
4. 选择 Azure.Communication.Calling.WindowsClient 包，然后选择 Azure.Communication.Calling.WindowsClient1.4.0-beta.1 或更高版本。
5. 在右侧选项卡上选中与 Azure 通信服务项目对应的复选框。
6. 选择“安装”按钮。

会议加入方法

要加入 Teams 会议，请使用CallAgent.join方法并传递JoinMeetingLocator和JoinCallOptions。

会议 ID 和密码

TeamsMeetingIdLocator使用会议 ID 和密码查找会议。 可以在 Teams 会议的加入信息下找到这些内容。 Teams 会议 ID 长度为 12 个字符，由以三为单位分组的数字组成（即000 000 000 000）。 密码将由 6 个字母字符组成（即aBcDeF）。 密码区分大小写。

String meetingId, passcode
let locator = TeamsMeetingIdLocator(meetingId: meetingId, passcode: passcode)

会议链接

TeamsMeetingLinkLocator使用指向 Teams 会议的链接查找会议。 可以在 Teams 会议的加入信息下找到此内容。

String meetingLink
let locator = TeamsMeetingLinkLocator(meetingLink: meetingLink)

使用定位符加入会议

创建这些 Teams 会议定位符后，可以使用它通过CallAgent.join加入 Teams 会议，如下所示。

func joinTeamsMeeting() {
    // Ask permissions
    AVAudioSession.sharedInstance().requestRecordPermission { (granted) in
        if granted {
            let joinCallOptions = JoinCallOptions()
            
            // Insert meeting locator code for specific join methods here

            // for CallAgent callAgent
            self.callAgent?.join(with: teamsMeetingLinkLocator, joinCallOptions: joinCallOptions) 
        }
    }
}

设置系统

创建 Visual Studio 项目

对于 UWP 应用，请在 Visual Studio 2022 中创建新的“空白应用(通用 Windows)”项目。 输入项目名称后，可随意选择任何版本高于 10.0.17763.0 的 Windows SDK。

对于 WinUI 3 应用，请使用“已打包空白应用(桌面中的 WinUI 3)”模板创建新项目，以设置单页 WinUI 3 应用。 需要 Windows App SDK 版本 1.3 或更高版本。

使用 NuGet 包管理器安装包和依赖项

可通过 NuGet 包公开提供通话 SDK API 和库。

以下步骤举例说明了如何查找、下载和安装通话 SDK NuGet 包：

1. 选择“工具”>“NuGet 包管理器”>“管理解决方案的 NuGet 包”，以打开 NuGet 包管理器。
2. 选择“浏览”，然后在搜索框中输入 Azure.Communication.Calling.WindowsClient。
3. 确保已选中“包括预发行版”复选框。
4. 选择 Azure.Communication.Calling.WindowsClient 包，然后选择 Azure.Communication.Calling.WindowsClient1.4.0-beta.1 或更高版本。
5. 在右侧选项卡上选中与 Azure 通信服务项目对应的复选框。
6. 选择“安装”按钮。

会议加入方法

要加入 Teams 会议，请使用CallAgent.JoinAsync方法并传递JoinMeetingLocator和JoinCallOptions。

会议 ID 和密码

TeamsMeetingIdLocator使用会议 ID 和密码查找会议。 可以在 Teams 会议的加入信息下找到这些内容。 Teams 会议 ID 长度为 12 个字符，由以三为单位分组的数字组成（即000 000 000 000）。 密码将由 6 个字母字符组成（即aBcDeF）。 密码区分大小写。

string meetingId, passcode; 
TeamsMeetingIdLocator locator = new TeamsMeetingIdLocator(meetingId, passcode);

会议链接

TeamsMeetingLinkLocator使用指向 Teams 会议的链接查找会议。 可以在 Teams 会议的加入信息下找到此内容。

string meetingLink; 
TeamsMeetingLinkLocator locator = new TeamsMeetingLinkLocator(meetingLink);

会议坐标

TeamsMeetingCoordinatesLocator使用组织者 ID、租户 ID、线程 ID 和消息 ID 查找会议。 可以使用 Microsoft Graph 找到此信息。

Guid organizerId, tenantId;
string threadId, messageId;
TeamsMeetingCoordinatesLocator locator = new TeamsMeetingCoordinatesLocator(threadId, organizerId, tenantId, messageId);

使用定位符加入会议

创建这些 Teams 会议定位符后，可以使用它通过CallAgent.JoinAsync加入 Teams 会议，如下所示。

var joinCallOptions = new JoinCallOptions() {
        OutgoingAudioOptions = new OutgoingAudioOptions() { IsMuted = true },
        OutgoingVideoOptions = new OutgoingVideoOptions() { Streams = new OutgoingVideoStream[] { cameraStream } }
    };
var call = await callAgent.JoinAsync(locator, joinCallOptions);

后续步骤

• 了解如何管理通话
• 了解如何管理视频
• 了解如何转移呼叫