# 配置消息通知 直播服务使用消息通知服务对直播录制状态进行实时通知，如需使用该功能，需要先配置消息通知服务。由于消息通知由消息通知服务（SMN）完成，所以SMN将对发送的消息通知进行单独计费，具体的计费标准请参考[SMN产品价格详情](https://www.huaweicloud.com/pricing/calculator.html#/smn)。 ![](https://support.huaweicloud.com/iLive-live/public_sys-resources/notice_3.0-zh-cn.png) 该功能为历史功能，直播服务目前已提供录制回调消息通知功能，推荐用户优先使用，详见[配置录制回调](https://support.huaweicloud.com/iLive-live/live_01_0035.html)。 #### 背景介绍 - 主题是消息发布或客户端订阅通知的特定事件类型。它作为发送消息和订阅通知的信道，为发布者和订阅者提供一个可以相互交流的通道。在配置直播消息订阅前必须定制主题。 - 消息订阅是客户将订阅者注册到主题的操作，客户可以拥有多个主题，每个主题有多个订阅者。 - 消息订阅暂以项目ID进行区分，即同一个项目ID的域名暂只能使用同一个消息订阅，消息订阅配置对同一个项目ID的所有域名生效。 #### 配置流程 消息订阅的配置流程，如[图1]所示。 图1消息订阅配置流程图 ![](https://support.huaweicloud.com/iLive-live/zh-cn_image_0237948276.png) 1. [创建消息主题]：在消息通知服务控制台新建消息主题，用于消息发送和订阅通知。 2. [添加订阅]：将消息主题添加到订阅中接收发布至主题的消息，在订阅主题且确认订阅后，终端节点能够接收到向该主题发布的所有消息。 3. [设置主题策略]：授权直播服务可对该主题发布消息。 4. [配置直播消息订阅]：在直播控制台配置消息订阅，在直播推流开始和结束，以及录制时收到对应的消息通知。 #### 前提条件 - 已[添加推流域名](https://support.huaweicloud.com/iLive-live/live010002.html)。 - 已在域名DNS服务商处完成[CNAME解析配置](https://support.huaweicloud.com/iLive-live/live010010.html)。 #### 步骤一：创建消息主题 详细操作请参见[创建主题](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0043961401.html)，需注意下述参数配置： - 主题名称：不需要修改。 - 协议：直播服务常用的消息通知方式为"短信"、"邮件"和"HTTP/HTTPS"。 #### 步骤二：添加订阅 详细操作请参见[订阅主题](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0043961402.html)。 添加订阅后，配置的订阅终端将收到确认订阅消息。若订阅终端为邮件，如[图2]所示。确认后，设置的订阅终端才能收到该主题发布的消息。 图2消息订阅确认 ![](https://support.huaweicloud.com/iLive-live/zh-cn_image_0237948281.jpg) #### 步骤三：设置主题策略 详细操作请参见[设置主题策略](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0043394891.html)，需注意下述参数配置： 可发布消息的服务：勾选"LIVE"，表示授权该云服务可对该主题进行操作。 #### 步骤四：配置直播消息订阅 1. 登录[视频直播控制台](https://console.huaweicloud.com/live2/#/live/home)。 2. 在左侧导航栏中，选择"域名管理"，进入域名管理页面。 3. 在需要配置消息订阅的播放域名行，单击"管理"。 4. 选择"消息订阅"页签，消息模板详细介绍请参见[录制通知消息模板]。 图3消息订阅模板 ![](https://support.huaweicloud.com/iLive-live/zh-cn_image_0237948283.png) 5. 在需要配置消息通知的模板行单击"设置"，弹出消息通知配置页面。 图4模板设置 ![](https://support.huaweicloud.com/iLive-live/zh-cn_image_0237948284.png) - **模板名称**：录制通知的模板名称，不可修改。 - **订阅主题**：单击右侧的+图标，添加在消息通知服务中创建的主题。 - **是否开启**：选择"开启"订阅终端才能收到该消息通知。 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} ``` 表1RecordNotifyTemplate字段说明 | 字段 | 描述 | |:---|:---| | domain | 推流域名。 | | app_name | 应用名称，与推流地址中的AppName保持一致。 | | stream_name | 直播流名称。 | | download_url | 录制文件的下载地址，当event的值不为RECORD_NEW_FILE时，该字段为空。 | | filename | 录制文件的名称，当event的值不为RECORD_NEW_FILE时，该字段为空。 | | asset_id | 录制文件的媒资ID，点播服务分配给该录制文件的唯一标识，当event的值不为RECORD_NEW_FILE时，该字段为空。 | | duration | 录制文件的时长，当event的值不为RECORD_NEW_FILE时，该字段为0。 | | event | 录制事件，包括： - RECORD_START： 录制任务开始。 - RECORD_NEW_FILE：产生新的录制文件。 - RECORD_OVER：录制任务结束。 - RECORD_FAIL：录制任务失败。 | | timestamp | 录制时间戳。 |