你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
快速入门:处理语音和视频通话事件
重要
本文中所述的功能目前处于公共预览状态。 此预览版在提供时没有附带服务级别协议,我们不建议将其用于生产工作负荷。 某些功能可能不受支持或者受限。 有关详细信息,请参阅 Microsoft Azure 预览版补充使用条款。
通过使用 Azure 事件网格来处理通信服务语音和视频通话事件,开始使用 Azure 通信服务。
关于 Azure 事件网格
Azure 事件网格是一种基于云的事件处理服务。 在本文中,你将了解如何针对通信服务事件订阅事件,以及触发事件以查看结果。 通常,你会将事件发送到处理事件数据并执行操作的终结点。 在本文中,我们会将事件发送到收集并显示消息的 Web 应用。
先决条件
- 具有活动订阅的 Azure 帐户。 免费创建帐户。
- Azure 通信服务资源。 可在创建 Azure 通信服务资源快速入门中找到更多详细信息。
- 启用了 Azure 通信服务语音和视频通话的客户端。 在应用中添加语音通话。
设置
启用事件网格资源提供程序
如果以前未在 Azure 订阅中使用过事件网格,则可能需要按照以下步骤注册事件网格资源提供程序:
在 Azure 门户中:
- 在左侧菜单中,选择“订阅”。
- 选择要用于事件网格的订阅。
- 在左侧菜单中的“设置”下,选择“资源提供程序”。
- 找到 Microsoft.EventGrid。
- 如果尚未注册,请选择“注册”。
完成注册可能需要一些时间。 选择“刷新”可更新状态。 当“状态”为“已注册”后,即可继续。
事件网格查看器部署
对于本快速入门,我们将使用 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 通信服务语音和视频通话结束后生成。 要触发此事件,只需结束附加到通信服务资源的呼叫。- 将参与者添加到 Azure 通信服务语音和视频通话后,将生成
Call Participant Added
事件。 要触发此事件,请将参与者添加到附加到通信服务资源的 Azure 通信服务语音和视频通话。 - 将参与者从 Azure 通信服务语音和视频通话中删除后,将生成
Call Participant Removed
事件。 要触发此事件,请从附加到通信服务资源的 Azure 通信服务语音和视频通话中删除参与者。
查看 Azure 通信服务支持的事件的完整列表。
接收语音和视频通话事件
完成以上任一操作后,你会注意到语音和视频通话事件会发送到你的终结点。 这些事件会显示在我们在开始时设置的 Azure 事件网格查看器示例中。 可以按事件旁的眼睛图标来查看整个有效负载。
详细了解事件架构和其他事件处理概念。
清理资源
如果想要清理并删除通信服务订阅,可以删除资源或资源组。 删除资源组同时也会删除与之相关联的任何其他资源。 了解有关清理资源的详细信息。
你可能还想要: