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

快速入门:处理语音和视频通话事件

重要

本文中所述的功能目前处于公共预览状态。 此预览版在提供时没有附带服务级别协议,我们不建议将其用于生产工作负荷。 某些功能可能不受支持或者受限。 有关详细信息,请参阅 Microsoft Azure 预览版补充使用条款

通过使用 Azure 事件网格来处理通信服务语音和视频通话事件,开始使用 Azure 通信服务。

关于 Azure 事件网格

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

先决条件

设置

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

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

在 Azure 门户中:

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

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

事件网格查看器部署

对于本快速入门,我们将使用 Azure 事件网格查看器示例,以便几乎实时地查看事件。 这会为用户提供实时源体验。 此外,每个事件的有效负载还应该可进行检查。

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

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

Screenshot showing selecting the event subscription button within a resource's events page.

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

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

可以订阅特定事件,以告知事件网格要订阅哪些语音和视频事件,以及要将事件发送到何处。 从下拉菜单中选择要订阅的事件。 针对语音和视频通话,可以选择 Call StartedCall EndedCall Participant addedCall Participant Removed

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

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

Screenshot showing the calling event types being selected.

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

Screenshot showing the Endpoint Type field being set to Web Hook.

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

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

然后选择“确认选择”。

Screenshot showing confirming a Web Hook Endpoint.

查看语音和视频通话事件

触发语音和视频通话事件

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

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

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

接收语音和视频通话事件

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

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

清理资源

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

你可能还想要: