综述

媒体处理中对视频发起的上传、删除、视频处理等操作，都可以被称为一个事件。由于媒体处理的转码、截图等操作属于算力密集型服务，执行任务需要一定的时间。因此在发起一个事件后，用户无法在第一时间获得任务结果，需要在事件结束后，通过回调通知的方式告知执行结果，即为事件通知。

事件通知类型

媒体处理支持以下几种事件通知：

事件通知详情

音视频转码完成

事件名称

TranscodeComplete

事件说明

音视频转码完成。

示例

{
    "eventTime":"2017-03-20T07:49:17Z",
    "eventType":"TranscodeComplete", 
    "workflowId":"1000010",
    "taskId":"0003#96ea85118429465b99a794951ffd4310",
    "originalFileUrl":"https://sample.gdoss.xstore.ctyun.cn/mediatest/1.mp4",
    "status": "SUCCESS",
    "taskMessage":"写入文件失败",
    "transcodeInfo": {
        "transcodeTemplateID": "100000000102",
        "watermarkTemplateID": "100000000005",
        "md5":"etdj945djdfkj",
        "format": "mp4",
        "size":1110000,
        "bitrate": 925,
        "duration": 15,
        "transcodeFileUrl": "http://transcode.gdoss.xstore.ctyun.cn/ABEBDE1JSU79FD4D1329/62cb3151eba52js82j2da3b55bc5****.mp4",
        "encrypt": false,
        "streamInfo":[{
	        "streamType": "Video",
	        "fps": 30,
	        "height": 960,
	        "width": 540,
	        "codec":"H264"
	      },
	      {
	        "streamType": "Audio",
	        "sampleRate":"44100",
	        "codec":"AAC",
	      }
       ]
    }
}

返回数据描述

表transcodeInfo

表streamInfo

审核完成

事件名称

AIContentReviewComplete

事件说明

视频审核完成。

示例

{
    "eventTime":"2017-03-20T07:49:17Z",
    "eventType":"AIContentReviewComplete", 
    "workflowId":"1000010",
    "taskId":"0003#fgty85118429465b99a794951ffd4310",
    "originalFileUrl":"https://sample.gdoss.xstore.ctyun.cn/mediatest/1.mp4",
    "status": "SUCCESS",
    "taskMessage":"写入文件失败",
    "aiVideoContentReviewInfo":{
	   "snapshot":{
	      "aiTimeList":["00.0", "10.0", "20.0"],
	      "aiSnapshotRegular":"https://sampleout.gdoss.xstore.ctyun.cn/outputdir/test-video-selfdes-{time}.jpg"
	   },
	   "porn":{
	        "status":"SUCCESS",
	        "output":{
	            "label":"sexy",
	            "segmentSet":[{
	                "confidence":98,
	                "label":"sexy", 
	                "url":"https://sample.gdoss.xstore.ctyun.cn/xxx/xxx/xx1.jpg"
	             }]
	        }
	    },
	    "terrorism":{
	       "status":"SUCCESS",
	        "output":{
	            "label":"normal"
	        }
	    },
	}
}

返回数据描述

表aiVideoContentReviewInfo

表snapshot

表porn

表porn-output

表pron-output-segmentSet

表terrorism

表terrorism-output

表terrorism-output-segmentSet

视频截图完成

事件名称

SnapshotComplete

事件说明

视频截图完成。

示例

{
    "eventTime":"2017-03-20T07:49:17Z",
    "eventType":"SnapshotComplete", 
    "workflowId":"1000010",
    "taskId":"0003#de3485118429465b99a794951ffd4310",
    "originalFileUrl":"https://sample.gdoss.xstore.ctyun.cn/mediatest/1.mp4",
    "status": "SUCCESS",
    "taskMessage":"写入文件失败",
    "snapshotInfo":{
        "snapshotTemplateID": "100000000102",
        "watermarkTemplateID": "100000000005",
        "snapshotType": "NormalSnapshot",
        "timeList": ["00.0", "10.0", "20.0"],
        "snapshotRegular": "https://sample.gdoss.xstore.ctyun.cn/990f3820db2948b5b4a13d65d9a4****-{time}.jpg",
        "webVTTUrl": "https://sample.gdoss.xstore.ctyun.cn/990f3820db2948b5b4a13d65.vtt"
    }
}

返回数据描述

表snapshotInfo

视频拼接完成

事件名称

StitchingComplete

事件说明

视频拼接完成。

示例

{
    "eventTime":"2022-10-13T18:06:16Z",
    "eventType":"StitchingComplete", 
    "workflowId":"1000010",
    "taskId":"0003#96ea85118429465b99a794951ffd4310",
    "originalFileUrl":"https://sample.gdoss.xstore.ctyun.cn/mediatest/1.mp4",
    "status": "SUCCESS",
    "taskMessage":"写入文件失败",
    "stitchingInfo": {
        "stitchingTemplateID": "100000000102",
        "watermarkTemplateID": "100000000005",
        "md5":"etdj945djdfkj",
        "format": "mp4",
        "size":1110000,
        "bitrate": 925,
	"duration": 15,
        "stitchingFileUrl": "https://transcode.gdoss.xstore.ctyun.cn/ABEBDE1JSU79FD4D1329/62cb3151eba52js82j2da3b55bc5****.mp4",
        "streamInfo":[{
	        "streamType": "Video",
	        "fps": 30,
	        "height": 960,
	        "width": 540,
	        "codec":"H264"
	      },
	      {
	        "streamType": "Audio",
	        "codec":"AAC",
	      }
       ]
    }
}

返回数据描述

表stitchingInfo

表streamInfo

工作流回调

操作步骤

登录媒体存储控制台，点击左侧导航栏的【媒体处理】–【工作流管理】，进入“工作流管理”界面。选择新建或修改一条工作流，在第一步【输入设置】中，找到【工作流回调】的配置入口，填入您需要接收回调的地址即可。回调事件将以HTTP POST方法，以json格式返回回调数据。

重新发起回调

操作步骤

登录媒体存储控制台，点击左侧导航栏的【媒体处理】-【任务管理】-【转码任务】（或【拼接任务】），找到需要重新发起回调的任务。在该任务的操作栏点击【回调重试】即可重新发起回调。

如本次重试回调失败，您可以在【回调状态】栏点击叹号图标，查看由回调接收服务返回的响应信息。请注意，本功能仅在当前页面发起重试时有效。如您在发起重试以后关闭当前页面，则无法再返回本次回调的调试信息。请在发起调测时保持该页面开启。