消息订阅
视频点播支持消息通知功能,实时通知转码、截图等任务的执行状态。由于消息通知由消息通知服务(SMN)完成,所以SMN将对发送的消息通知进行单独计费,具体的计费标准请参考SMN价格详情。
功能介绍
- 主题是消息发布或客户端订阅通知的特定事件类型。它作为发送消息和订阅通知的信道,为发布者和订阅者提供一个可以相互交流的通道。在配置点播消息订阅前必须定制主题。
- 点播消息通知包括“转码完成”、“截图完成”、“审核完成”、“创建完成”、“音频提取完成”、“封面生成完成”几类。消息订阅是客户将订阅者注册到主题的操作,客户可以拥有多个主题,每个主题有多个订阅者。
配置流程
消息订阅的配置流程,如图1所示。
创建消息主题
设置主题策略
- 在消息通知服务控制台的左侧导航树中选择 ,进入主题页面。
- 在创建的主题行单击 列的“更多 > 设置主题策略”,弹出主题策略设置页面。
- 配置主题策略的参数,如图4所示。
访问策略分为基本模式和高级模式,其中基本模式只可对用户和服务设置发布消息的操作权限,如图4所示。
表3 基本模式说明 策略对象
参数设置
说明
可发布消息的用户
仅自己(主题创建者)
仅主题创建者有权限向该主题发布消息。
所有人
所有用户均有权限向该主题发布消息。
仅如下用户
设置可向该主题发布消息的用户。
格式为urn:csp:iam::domainId:root
其中,domainId即为用户的账号ID。多个用户时,以英文逗号隔开,可输入的用户数量没有限制,但生成的策略总长度不超过30KB。说明:- 您只需填写用户的“账号ID”,输入完成后,单击“确定”。其余内容由系统自动补全。
- “账号ID”的获取方式:登录消息通知服务控制台,单击右上角用户名下的“我的凭证”,可查看“账号ID”。
可发布消息的服务
设置项如图4中所示。
勾选“VOD”,表示授权该云服务可对该主题进行操作。
配置点播消息订阅
- 登录视频点播控制台。
- 在左侧导航树中选择“全局设置 > 消息订阅”,进入消息订阅页签。图5 配置消息订阅
- 根据需要勾选订阅事件。
- 根据需要勾选订阅消息类型。
若消息类型“模板消息”和“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
- 勾选“接收模板消息”,模板消息内容请参考表4 模板消息说明。通知文本消息内容中的各变量参数与实际操作相关,请以实际收到的消息内容为准。
- 勾选在消息通知服务创建的SMN主题。
- 单击“确定”,完成消息订阅配置。
