消息订阅

功能介绍

• 主题是消息发布或客户端订阅通知的特定事件类型。它作为发送消息和订阅通知的信道，为发布者和订阅者提供一个可以相互交流的通道。在配置点播消息订阅前必须定制主题。
• 点播消息通知包括“转码完成”、“截图完成”、“审核完成”、“创建完成”、“音频提取完成”、“封面生成完成”几类。消息订阅是客户将订阅者注册到主题的操作，客户可以拥有多个主题，每个主题有多个订阅者。

配置流程

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

图1 消息订阅配置流程图

1. 创建消息主题：在消息通知服务控制台新建消息主题，用于消息发送和订阅通知。
2. 设置主题策略：授权点播服务可对该主题发布消息。
3. 配置点播消息订阅：在点播控制台配置消息订阅，即可在转码、截图、审核等操作时接收到消息通知。

创建消息主题

1. 登录消息通知服务控制台，单击“主题管理 > 主题”，进入主题管理页面。
2. 单击右上角“创建主题”，创建消息通知的主题。
3. 在创建主题弹窗配置主题的信息，信息说明请参见表1。配置完成后，单击“确定”。

   表1 创建主题

   主题信息	说明
   消息名称	消息名称为必填 只能包含大写字母、小写字母、数字、-和_，且必须由大写字母、小写字母或数字开头 长度为1～256字符
   显示名	可不填写。推送邮件消息时： 若未设置主题的显示名，发件人呈现为"username@example.com" 若已设置主题的显示名，发件人则呈现为"显示名<username@example.com>"
   标签	用于标识多种云资源，可不填写

4. 在已创建的主题行单击“操作”列的“添加订阅”，进入添加订阅页面。
5. 配置消息通知的协议和订阅终端，如图2所示。
   图2 添加订阅
   

   参数说明如表2所示。

   表2 添加订阅参数说明

   参数	说明
   主题名称	待添加订阅的主题名称，不需要修改。
   协议	消息通知的方式。在下拉框中选择需要订阅终端支持的协议。 媒体处理服务常用的消息通知方式为“短信”、“邮件”和“HTTP/HTTPS”。
   订阅终端	订阅的终端地址，短信、邮件、HTTP以及HTTPS终端支持批量输入，批量添加时，每个终端地址占一行。最多可输入10个终端。 选择“短信”，请输入有效手机号码。 输入规则为[+] [国家码][手机号码]。国内手机号码可省略[+]或[+] [国家码]。 例如： +8600000000000 +8600000000001 选择“邮件”，请输入有效电子邮件地址。 例如： username@example.com username2@example.com 选择“HTTP”或“HTTPS”，请输入公网网址。 例如： http://example.com/notification/action http://example2.com/notification/action

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

设置主题策略

1. 在消息通知服务控制台的左侧导航树中选择“主题管理 > 主题”，进入主题页面。
2. 在创建的主题行单击“操作”列的“更多 > 设置主题策略”，弹出主题策略设置页面。
3. 配置主题策略的参数，如图4所示。
   图4 设置主题策略
   

   访问策略分为基本模式和高级模式，其中基本模式只可对用户和服务设置发布消息的操作权限，如图4所示。

   表3 基本模式说明

   策略对象	参数设置	说明
   可发布消息的用户	仅自己（主题创建者）	仅主题创建者有权限向该主题发布消息。
   	所有人	所有用户均有权限向该主题发布消息。
   	仅如下用户	设置可向该主题发布消息的用户。 格式为urn:csp:iam::domainId:root 其中，domainId即为用户的账号ID。多个用户时，以英文逗号隔开，可输入的用户数量没有限制，但生成的策略总长度不超过30KB。 说明： 您只需填写用户的“账号ID”，输入完成后，单击“确定”。其余内容由系统自动补全。 “账号ID”的获取方式：登录消息通知服务控制台，单击右上角用户名下的“我的凭证”，可查看“账号ID”。
   可发布消息的服务	设置项如图4中所示。	勾选“VOD”，表示授权该云服务可对该主题进行操作。

配置点播消息订阅

1. 登录视频点播控制台。
2. 在左侧导航树中选择“全局设置 > 消息订阅”，进入消息订阅页签。
   图5 配置消息订阅
   

3. 根据需要勾选订阅事件。
4. 根据需要勾选订阅消息类型。
   

   若消息类型“模板消息”和“json消息”都勾选，则对于“短信”以及“邮件”订阅协议，只能接收到模板消息，对于“HTTP”以及“HTTPS”订阅协议，只能接收到json消息。

   • 勾选“接收模板消息”，模板消息内容请参考表4 模板消息说明。通知文本消息内容中的各变量参数与实际操作相关，请以实际收到的消息内容为准。

     表4 模板消息说明

     事件	事件处理结果状态	通知文本消息内容
     转码完成	成功	尊敬的用户，您的视频转码任务已成功完成。视频ID：{asset_id}，名称：{title}，请登录点播Console或调用点播API获取详细转码信息。
     	失败	尊敬的用户，您的视频转码任务处理时出现错误。视频ID：{asset_id}，名称：{title}，错误码：{err_code}，错误信息：{err_msg}。
     截图完成	成功	尊敬的用户，您的视频截图任务已成功完成。视频ID：{asset_id}，名称：{title}，请登录点播Console或调用点播API获取详细截图信息。
     	失败	尊敬的用户，您的视频截图任务处理时出现错误。视频ID：{asset_id}，名称：{title}，错误码：{err_code}，错误信息：{err_msg}。
     审核完成	成功	尊敬的用户，您的视频审核任务已成功完成。视频ID：{asset_id}，名称：{title}，审核建议：{suggestion}，请登录点播Console或调用点播API获取详细审核信息。
     	失败	尊敬的用户，您的视频审核任务处理时出现错误。视频ID：{asset_id}，名称：{title}，错误码：{err_code}，错误信息：{err_msg}。
     媒资创建完成	成功	尊敬的用户，您的视频创建完成。视频ID：{asset_id}，视频名称：{title}，请登录点播Console或调用点播API获取详细视频信息。
     	失败	尊敬的用户，您的视频创建时出现错误。视频ID：{asset_id}，视频名称：{title}，错误码：{err_code}，错误信息：{err_msg}。
     音频提取完成	成功	尊敬的用户，您的音频提取完成。音频ID：{asset_id}，音频名称：{title}，请登录点播Console或调用点播API获取详细音频信息。
     	失败	尊敬的用户，您的音频提取时出现错误。音频ID：{asset_id}，音频名称：{title}，错误码：{err_code}，错误信息：{err_msg}。
     封面生成完成	成功	尊敬的用户，您的视频封面已生成。视频ID：{asset_id}，视频名称：{title}，请登录点播Console或调用点播API获取详细视频信息。
     	失败	尊敬的用户，您的视频封面生成失败。视频ID：{asset_id}，视频名称：{title}，错误码：{err_code}，错误信息：{err_msg}。

   • 勾选“接收json消息”，消息模板请参考表5 json消息模板说明。

     表5 json消息模板说明

     参数	说明	类型
     event_type	事件类型，当前支持的取值如下： TranscodeComplete：转码（加密）完成 ThumbnailComplete：截图完成 ReviewComplete：审核完成 CreateComplete：媒资创建完成 AudioExtractComplete：音频提取完成 coverComplete：封面生成完成	String
     transcode_info	转码（含加密）信息，仅当是转码（加密）事件才有该字段，具体消息说明请参考转码消息体。	TranscodeInfo
     thumbnail_info	截图信息，仅当是截图事件才有该字段，具体消息说明请参考截图消息体。	ThumbnailInfo
     review_info	审核信息，仅当是审核事件才有该字段，具体消息说明请参考审核消息体。	ReviewInfo
     create_info	新创建的媒资信息，仅当是媒资创建事件才有该字段，具体消息说明请参考创建媒资&音频提取消息体。	AssetInfo
     audio_extract_info	新提取的音频信息，仅当是音频提取事件才有该字段，具体消息说明请参考创建媒资&音频提取消息体。	AssetInfo
     cover_info	封面生成消息，仅当是封面生成事件才有该字段，具体消息说明请参考封面生成消息体。	CoverInfo

5. 勾选在消息通知服务创建的SMN主题。
6. 单击“确定”，完成消息订阅配置。