快速入门：处理语音和视频呼叫事件

重要

Azure 通信服务的这一功能目前以预览版提供。 预览版中的功能已公开发布，可供所有新客户和现有Microsoft客户使用。

此预览版在提供时没有附带服务级别协议，我们不建议将其用于生产工作负荷。 某些功能可能不受支持，或者功能可能受到限制。

有关详细信息，请参阅 Microsoft Azure 预览版补充使用条款。

通过 Azure 事件网格处理通信服务语音和视频呼叫事件，开始使用 Azure 通信服务。

关于 Azure 事件网格

Azure 事件网格 是基于云的事件服务。 本文介绍如何订阅 通信服务事件的事件，并触发事件以查看结果。 通常，你会将事件发送到处理事件数据并执行操作的终结点。 在本文中，我们会将事件发送到收集并显示消息的 Web 应用。

先决条件

• 具有活动订阅的 Azure 帐户。 免费创建帐户。
• Azure 通信服务资源。 可以在 “创建 Azure 通信服务资源 ”快速入门中找到更多详细信息。
• 启用了 Azure 通信服务语音和视频通话的客户端。 向应用添加语音呼叫。

设置

启用事件网格资源提供程序

如果以前未在 Azure 订阅中使用过事件网格，可能需要按照以下步骤注册事件网格资源提供程序：

在 Azure 门户中：

1. 在左侧菜单中选择 “订阅 ”。
2. 选择要用于事件网格的订阅。
3. 在左侧菜单中的“设置”下，选择“资源提供程序”。
4. 找到 Microsoft.EventGrid。
5. 如果未注册，请选择“ 注册”。

完成注册可能需要一些时间。 选择“刷新”可更新状态。 当“状态”为“已注册”后，即可继续。

事件网格查看器部署

在本快速入门中，我们将使用 Azure 事件网格查看器示例 近乎实时地查看事件。 这会为用户提供实时源体验。 此外，每个事件的数据负载也应可供检查。

使用 Webhook 订阅语音和视频通话事件

在门户中，导航到创建的 Azure 通信服务资源。 在通信服务资源中，从通信服务页面的左侧菜单中选择“事件”。

按 “添加事件订阅 ”输入创建向导。

在 “创建事件订阅 ”页上，输入事件订阅 的名称 。

可以订阅特定事件，告诉事件网格要订阅的语音和视频事件以及发送事件的位置。 从下拉菜单中选择想要订阅的事件。 对于语音和视频呼叫，您可以选择Call Started、Call Ended、Call Participant added和Call Participant Removed。

如果系统提示输入系统主题名称，请随意输入唯一的字符串。 此字段不会对体验造成影响，适用于内部遥测。

查看 Azure 通信服务支持的事件的完整列表。

对于“终结点类型”，请选择“Web Hook”。

对于 “终结点”，单击 “选择终结点”，然后输入 Web 应用的 URL。

在本例中，我们将使用前面在快速入门中设置的 Azure 事件网格查看器示例 中的 URL。 示例的 URL 采用以下格式： https://{{site-name}}.azurewebsites.net/api/updates

然后选择“ 确认选择”。

查看语音和视频通话事件

触发语音和视频通话事件

若要查看事件触发器，必须首先生成事件。

• Call Started 启动 Azure 通信服务语音和视频呼叫时，将生成事件。 要触发此事件，只需启动附加到通信服务资源的呼叫。
• Call Ended 当 Azure 通信服务语音和视频呼叫结束时，将生成事件。 若要触发此事件，只需结束与通信服务资源相关联的通话。
• Call Participant Added 将参与者添加到 Azure 通信服务语音和视频呼叫时，将生成事件。 若要触发此事件，请将参与者添加到附加到通信服务资源的 Azure 通信服务语音和视频呼叫。
• Call Participant Removed 从 Azure 通信服务语音和视频呼叫中删除参与者时，将生成事件。 若要触发此事件，请从附加到通信服务资源的 Azure 通信服务语音和视频呼叫中删除参与者。

查看 Azure 通信服务支持的事件的完整列表。

接收语音和视频通话事件

完成以上任一操作后，你会发现语音和视频呼叫事件将发送到端点。 这些事件将显示在我们一开始设置的 Azure 事件网格查看器示例中 。 可以按事件旁的眼睛图标来查看整个有效负载。

详细了解事件架构和其他事件处理概念。

清理资源

如果想要清理并删除通信服务订阅，可以删除资源或资源组。 删除资源组同时也会删除与之相关联的任何其他资源。 了解有关清理资源的详细信息。

你可能还想要：

• 了解事件处理概念
• 了解事件网格