配置消息通知

背景介绍

• 主题是消息发布或客户端订阅通知的特定事件类型。它作为发送消息和订阅通知的信道，为发布者和订阅者提供一个可以相互交流的通道。在配置直播消息订阅前必须定制主题。
• 消息订阅是客户将订阅者注册到主题的操作，客户可以拥有多个主题，每个主题有多个订阅者。
• 消息订阅暂以项目ID进行区分，即同一个项目ID的域名暂只能使用同一个消息订阅，消息订阅配置对同一个项目ID的所有域名生效。

配置流程

消息订阅的配置流程，如图1所示。

图1 消息订阅配置流程图

1. 创建消息主题：在消息通知服务控制台新建消息主题，用于消息发送和订阅通知。
2. 添加订阅：将消息主题添加到订阅中接收发布至主题的消息，在订阅主题且确认订阅后，终端节点能够接收到向该主题发布的所有消息。
3. 设置主题策略：授权直播服务可对该主题发布消息。
4. 配置直播消息订阅：在直播控制台配置消息订阅，在直播推流开始和结束，以及录制时收到对应的消息通知。

前提条件

• 已添加推流域名。
• 已在域名DNS服务商处完成CNAME解析配置。

步骤一：创建消息主题

详细操作请参见创建主题，需注意下述参数配置：

• 主题名称：不需要修改。
• 协议：直播服务常用的消息通知方式为“短信”、“邮件”和“HTTP/HTTPS”。

步骤二：添加订阅

详细操作请参见订阅主题。

添加订阅后，配置的订阅终端将收到确认订阅消息。若订阅终端为邮件，如图2所示。确认后，设置的订阅终端才能收到该主题发布的消息。

图2 消息订阅确认

步骤三：设置主题策略

详细操作请参见设置主题策略，需注意下述参数配置：

可发布消息的服务：勾选“LIVE”，表示授权该云服务可对该主题进行操作。

步骤四：配置直播消息订阅

1. 登录视频直播控制台。
2. 在左侧导航栏中，选择“域名管理”，进入域名管理页面。
3. 在需要配置消息订阅的播放域名行，单击“管理”。
4. 在左侧导航树中，选择“模板配置 > 消息订阅”，进入消息订阅页签。

   消息模板详细介绍请参见录制通知消息模板。

   图3 消息订阅模板
   

5. 在需要配置消息通知的模板行单击“设置”，弹出消息通知配置页面。
   图4 模板设置
   
   • 模板名称：录制通知的模板名称，不可修改。
   • 订阅主题：单击右侧的+图标，添加在消息通知服务中创建的主题。
   • 是否开启：选择“开启”订阅终端才能收到该消息通知。

6. 单击“确定”，完成消息订阅配置。

录制通知消息模板

录制通知的消息模板如下所示，消息中各字段说明如表1所示。

Live Record Notify, domain: {domain}, app_name: {app_name}, stream_name: {stream_name}, download_url: {download_url},  filename: {filename},asset_id: {asset_id}, duration: {duration}, event: {event}, timestamp: {timestamp}