更新时间:2024-07-05 GMT+08:00

MFS消息通知

如果使用MFS服务,则消息通知是免费的。

“华北-北京一”和“华东-上海二”区域不支持使用MFS。

配置点播消息订阅

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

    1. 根据需要勾选订阅事件,并输入回调地址。
    2. (可选)如需鉴权,可单击“生成”,生成鉴权密钥。
      消息通知鉴权验证流程,如MFS消息通知鉴权验证流程所示。

      如果用户同时勾选“截图完成事件”和“封面生成完成事件”,不会触发封面通知,都只会触发截图通知。

      图1 配置消息订阅
    MFS消息通知,仅支持发送REST消息,对应的JSON消息模板请参考表1 json消息模板说明
    表1 json消息模板说明

    参数

    说明

    类型

    event_type

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

    • transcodeComplete:转码(加密)完成
    • thumbnailComplete:截图完成
    • reviewComplete:审核完成
    • createComplete:媒资创建完成
    • audioExtractComplete:音频提取完成
    • coverComplete:封面生成完成
    • parseComplete:媒资解析完成

    String

    transcode_info

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

    TranscodeInfo

    thumbnail_info

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

    ThumbnailInfo

    review_info

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

    ReviewInfo

    create_info

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

    AssetInfo

    audio_extract_info

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

    AssetInfo

    cover_info

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

    CoverInfo

    parse_info

    媒资解析完成消息,仅当是媒资解析完成事件才有该字段,具体消息说明请参考解析媒资消息体

    ParseInfo

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

MFS消息通知鉴权验证流程

  1. 视频点播服务会根据当前时间生成一个时间戳timestamp,使用2.b中配置的密钥,根据HmacSHA256(VOD_{timestamp}_{body}, key)计算出签名字符串。

    签名字符串和时间戳会在HTTP的消息头中发送至端侧,分别为header[auth_sign]和header[auth_timestamp]。其中,body为消息体中的message属性。

  2. 客户收到返回消息后,按照VOD_{timestamp}_{body}格式拼接字符串,再使用消息头中的密钥计算HmacSHA256(VOD_{timestamp}_{body}, key)生成签名字符串和消息头中的签名字符串比较是否一致。如果一致,则鉴权成功。