文档首页 > > 用户指南> 全局设置> 消息订阅

消息订阅

分享
更新时间: 2019/10/22 GMT+08:00

视频点播支持消息通知功能,对转码事件,截图事件,审核事件等进行任务执行状态的实时通知。由于消息通知由消息通知服务(SMN)完成,所以SMN将对发送的消息通知进行单独计费,具体的计费标准请参考消息通知服务价格说明

功能介绍

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

创建消息主题

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

    表1 创建主题

    主题信息

    说明

    消息名称

    • 消息名称为必填。
    • 只能包含大写字母、小写字母、数字、-和_,且必须由大写字母、小写字母或数字开头
    • 长度为1~256字符

    显示名

    可不填写。推送邮件消息时:

    • 若未设置主题的显示名,发件人呈现为"username@example.com"
    • 若已设置主题的显示名,发件人则呈现为"显示名<username@example.com>"

    标签

    用于标识多种云资源,可不填写

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

    图1 添加订阅

    参数说明如表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. 添加订阅后,配置的订阅终端将收到确认订阅消息。若订阅终端为邮件,如图2所示。确认后,设置的订阅终端才能收到该主题发布的消息。

    图2 消息订阅确认

  7. 您还可以通过消息通知服务发布主题消息,配置消息模板等操作,具体操作请参见消息通知服务帮助

设置主题策略

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

    图3 设置主题策略

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

    高级模式可使用策略语言配置更加灵活的访问策略。详细说明请参见高级模式

    表3 基本模式说明

    策略对象

    参数设置

    说明

    可发布消息的用户

    仅自己(主题创建者)

    仅主题创建者有权限向该主题发布消息。

    所有人

    所有用户均有权限向该主题发布消息。

    仅如下用户

    设置可向该主题发布消息的用户。

    格式为urn:csp:iam::domainId:root

    其中,domainId即为用户的账号ID。多个用户时,以英文逗号隔开,可输入的用户数量没有限制,但生成的策略总长度不超过30KB。
    说明:
    • 您只需填写用户的“账号ID”,输入完成后,单击“确定”。其余内容由系统自动补全。
    • “账号ID”的获取方式:登录消息通知服务控制台,单击右上角用户名下的“我的凭证”,可查看“账号ID”。

    基本模式中配置的内容在高级模式中同步显示。如需要修改,也可在高级模式中修改,如何修改请参见高级模式

    可发布消息的服务

    设置项如图3中所示。

    勾选“VOD”,表示授权该云服务可对该主题进行操作。

    说明:

    默认情况云监控和Anti-DDoS拥有向所有用户的主题发布消息的权限。

配置点播消息订阅

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

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

    当前配置消息订阅,模板消息以及json消息都勾选时,对于“短信”以及“邮件”订阅协议,只能接收到模板消息,对于“HTTP”以及“HTTPS”订阅协议,只能接收到json消息。

    • 勾选“接收模板消息”,模板消息内容请参考表4 模板消息说明
      表4 模板消息说明

      事件

      事件处理结果状态

      通知文本消息内容

      备注

      转码完成

      成功

      尊敬的用户,您的视频转码任务已成功完成。视频ID:{asset_id},名称:{title},请登录点播Console或调用点播API获取详细转码信息。

      asset_id、title、err_code、err_msg根据具体转码的视频而定。

      失败

      尊敬的用户,您的视频转码任务处理时出现错误。视频ID:{asset_id},名称:{title},错误码:{err_code},错误信息:{err_msg}。

      截图完成

      成功

      尊敬的用户,您的视频截图任务已成功完成。视频ID:{asset_id},名称:{title},请登录点播Console或调用点播API获取详细截图信息。

      asset_id、title、err_code、err_msg根据具体截图的视频而定。

      失败

      尊敬的用户,您的视频截图任务处理时出现错误。视频ID:{asset_id},名称:{title},错误码:{err_code},错误信息:{err_msg}。

      审核完成

      成功

      尊敬的用户,您的视频审核任务已成功完成。视频ID:{asset_id},名称:{title},审核建议:{suggestion},请登录点播Console或调用点播API获取详细审核信息。

      asset_id、title、err_code、err_msg、suggestion根据具体审核的视频而定。

      失败

      尊敬的用户,您的视频审核任务处理时出现错误。视频ID:{asset_id},名称:{title},错误码:{err_code},错误信息:{err_msg}。

      拼接完成

      成功

      尊敬的用户,您的视频拼接任务已成功完成。生成视频ID:{asset_id},生成视频名称:{title},请登录点播Console或调用点播API获取详细生成视频信息。

      asset_id、title、err_code、err_msg根据具体拼接而成的视频而定。

      失败

      尊敬的用户,您的视频拼接任务处理时出现错误。生成视频ID:{asset_id},生成视频名称:{title},错误码:{err_code},错误信息:{err_msg}。

      剪切完成

      成功

      尊敬的用户,您的视频剪切任务已成功完成。生成视频ID:{asset_id},生成视频名称:{title},请登录点播Console或调用点播API获取详细生成视频信息。

      asset_id、title、err_code、err_msg根据具体剪切而成的视频而定。

      失败

      尊敬的用户,您的视频剪切任务处理时出现错误。生成视频ID:{asset_id},生成视频名称:{title},错误码:{err_code},错误信息:{err_msg}。

      媒资创建完成

      成功

      尊敬的用户,您的视频创建完成。视频ID:{asset_id},视频名称:{title},请登录点播Console或调用点播API获取详细视频信息。

      asset_id、title、err_code、err_msg根据具体创建的媒资而定。

      失败

      尊敬的用户,您的视频创建时出现错误。视频ID:{asset_id},视频名称:{title},错误码:{err_code},错误信息:{err_msg}。

      音频提取完成

      成功

      尊敬的用户,您的音频提取完成。音频ID:{asset_id},音频名称:{title},请登录点播Console或调用点播API获取详细音频信息。

      asset_id、title、err_code、err_msg根据具体提取音频的媒资而定。

      失败

      尊敬的用户,您的音频提取时出现错误。音频ID:{asset_id},音频名称:{title},错误码:{err_code},错误信息:{err_msg}。

      封面生成完成

      成功

      尊敬的用户,您的视频封面已生成。视频ID:{asset_id},视频名称:{title},请登录点播Console或调用点播API获取详细视频信息。

      asset_id、title、err_code、err_msg根据具体生成封面的媒资而定。

      失败

      尊敬的用户,您的视频封面生成失败。视频ID:{asset_id},视频名称:{title},错误码:{err_code},错误信息:{err_msg}。

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

      参数

      说明

      类型

      event_type

      事件类型,当前支持的取值如下:

      • TranscodeComplete:转码(加密)完成
      • ThumbnailComplete:截图完成
      • ReviewComplete:审核完成
      • ConcatComplete:拼接完成
      • CutComplete:剪切完成
      • CreateComplete:媒资创建完成
      • AudioExtractComplete:音频提取完成
      • coverComplete:封面生成完成

      String

      transcode_info

      转码(含加密)信息,仅当是转码(加密)事件才有该字段,具体消息说明请参考转码消息体

      TranscodeInfo

      thumbnail_info

      截图信息,仅当是截图事件才有该字段,具体消息说明请参考截图消息体

      ThumbnailInfo

      review_info

      审核信息,仅当是审核事件才有该字段,具体消息说明请参考审核消息体

      ReviewInfo

      concat_info

      拼接信息,仅当是拼接事件才有该字段,具体消息说明请参考拼接消息体

      ConcatInfo

      cut_info

      剪切信息,仅当是剪切事件才有该字段,具体消息说明请参考剪切消息体

      CutInfo

      create_info

      新创建的媒资信息,仅当是媒资创建事件才有该字段,具体消息说明请参考创建媒资&音频提取消息体

      AssetInfo

      audio_extract_info

      新提取的音频信息,仅当是音频提取事件才有该字段,具体消息说明请参考创建媒资&音频提取消息体

      AssetInfo

      cover_info

      封面生成消息,仅当是封面生成事件才有该字段,具体消息说明请参考封面生成消息体

      CoverInfo

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

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区