接收任务完成后的消息通知_媒体处理(MPS)-阿里云帮助中心

通知发布成功后，您可以在消息服务MNS（Message Service）中通过队列方式或主题通知方式接收消息通知。本文为您介绍如何接收消息通知。

前提条件

您已设置消息通知。具体操作，请参见设置消息通知。

队列方式接收消息通知

使用Java SDK接收消息通知。
说明
示例语言采用Java，其他语言使用说明，请参见SDK使用手册。
使用控制台接收消息通知。

主题通知方式接收消息通知

使用Java SDK接收消息通知。
说明
示例语言采用Java，其他语言使用说明，请参见SDK使用手册。
使用控制台接收消息通知。

单任务消息格式

参数名称	说明
jobId(JobId)	作业ID。
requestId(RequestId)	请求ID。
type(Type)	作业类型。值为： Transcode：转码。 Analysis：智能模板分析。 Snapshot：截图。 MediaInfo：媒体信息。
state(State)	作业状态。值为： Success：成功。 Fail：失败。
code	错误码。任务出错时返回。
msg	错误消息详情。任务出错时返回。
UrlPattern	截图含占位符的URL，相当于URL模板。说明 type(Type)为Snapshot，且截图场景为按指定时间点截图时返回。
LastUrl	最后一张截图的URL。说明 type(Type)为Snapshot，且截图场景为按指定时间点截图时返回。
Count	截图总张数。说明 type(Type)为Snapshot，且截图场景为按指定时间点截图时返回。
TimeArray	截图时间点，由小到大。说明 type(Type)为Snapshot，且截图场景为按指定时间点截图时返回。

成功回调示例

{
  "jobId": "8f91f1b630f3469eb5ecf445028f****",
  "JobId": "8f91f1b630f3469eb5ecf445028f****",
  "Type": "Snapshot",
  "userData": "{}",
  "UserData": "{}",
  "State": "Success",
  "state": "Success",
  "type": "Snapshot",

  "LastUrl": "http://example.oss-cn-shanghai.aliyuncs.com/example_output/2021-11-14/V4/Async-V2-00005.jpg",
  "TimeArray": [10050, 50000, 110000, 1000500, 1100500],
  "UrlPattern": "http://eaxmple.oss-cn-shanghai.aliyuncs.com/example_output/2021-11-14/V4/Async-V2-{Count}.jpg",
  "Count": 5
}

失败回调示例

{
  "msg": "TimeArray greater than video duration.",
  "Msg": "TimeArray greater than video duration.",
  "code": "InvalidParameter.TimeArray",
  "userData": "{}",
  "UserData": "{}",
  "type": "Snapshot",
  "Code": "InvalidParameter.TimeArray",
  "jobId": "f8abc5d9dee0425fa26bb9946df1****",
  "Type": "Snapshot",
  "State": "Fail",
  "UrlPattern": "http://example.oss-cn-shanghai.aliyuncs.com/example_output/2023-11-15/regression_test/TimePoint/V1/Async-V1-{Count}.jpg",
  "TimeArray": [10050, 50000, 110000, 1000500, 1100500, 1800000],
  "state": "Fail",
  "JobId": "f8abc5d9dee0425fa26bb9946df1****"
}

工作流消息格式

媒体工作流消息通知的消息体是JSON格式，详细的字段名称、类型、描述请参见新增媒体中媒体工作流消息部分。

结构的层次定义如下：

开始
活动基本属性中活动类型Type是Start。
结构
详细说明见下文代码注释。
完成
活动基本属性中活动类型Type是Report。

示例

{ 
      //顶层，JSON对象，定义：{当前活动基本属性，工作流执行对象}
      //当前活动基本属性：非独立对象，是直接属于顶层的键值属性。定义：{工作流执行ID，活动名称，活动类型，活动状态，错误信息（如有）}
      "RunId": "8f8aba5a62ab4127ae2add18da20****",
      "Name": "Act-4",
      "Type": "Report",
      "State": "Success",
      //工作流执行详情对象：JSON对象，定义：{工作流执行ID，媒体工作流ID，媒体工作流名称，媒体ID，输入文件，工作流执行类型，活动对象数组，创建时间}
      "MediaWorkflowExecution": {
        "Name": "ConcurrentSuccess",
        "RunId": "8f8aba5a62ab4127ae2add18da20****",
        "Input": {
            "InputFile": {
                "Bucket": "exampleBucket****",
                "Location": "oss-test", 
               "Object": "mediaWorkflow/ConcurrentSuccess/01.wmv",
           }
        },
        "State": "Success",
        "MediaId": "2be491ab4cb6499cd0befe5fcf0c****",
        //活动对象数组：JSON对象，包含执行到当前状态的所有活动
        //例如：开始消息中只有一个Start活动对象，完成消息则包含所有活动对象。
        //定义：[活动对象1，活动对象2，...]
        "ActivityList": 
[
            //活动对象：JSON对象，定义：{活动名称，活动类型，作业ID，活动状态，开始时间，结束时间，错误信息（如有）}    
            {
                "RunId": "8f8aba5a62ab4127ae2add18da20****",
                "Name": "Act-1",
                "Type": "Start",
                "State": "Success",
                "StartTime": "2016-03-15T02: 53: 41Z",
                "EndTime": "2016-03-15T02: 53: 41Z",
            },
            {                
                "RunId": "8f8aba5a62ab4127ae2add18da20****",
                "Name": "Act-2",
                "Type": "Transcode",
                "JobId": "f34b6d1429dd491faa7a6c1c8f90****",
                "State": "Success",
                "StartTime": "2016-03-15T02: 53: 43Z",
                "EndTime": "2016-03-15T02: 53: 47Z",
            },
            {                
                "RunId": "8f8aba5a62ab4127ae2add18da20****",
                "Name": "Act-3",
                "Type": "Snapshot",
                "JobId": "c14150be33304825a5d67cd5364c****",
                "State": "Success",
                "StartTime": "2016-03-15T02: 53: 44Z",                
                "EndTime": "2016-03-15T02: 53: 45Z",
            },
            {                
                "RunId": "8f8aba5a62ab4127ae2add18da20****",
                "Name": "Act-4",
                "Type": "Report",
                "State": "Success",
                "StartTime": "2016-03-15T02: 53: 49Z",
                "EndTime": "2016-03-15T02: 53: 49Z", 
           }
        ],
        "CreationTime": "2016-03-15T02: 53: 39Z",
      }
  }