tencent cloud

Video on Demand

Task Flow Status Change

PDF
Focus Mode
Font Size
Last updated: 2023-03-13 11:41:15

Event Name

ProcedureStateChanged

Event Description

If you have configured event notifications for your application, after the status of a task flow is changed, your application backend will be notified either by a “normal callback” or a “reliable callback”. For the content of the callback, see ProcedureTask.

Example

Normal callback

In the normal callback mode, your callback URL will receive an HTTP POST request from VOD. The content of the callback is included in the request body, as shown below (fields with null values are omitted):
{
"EventType":"ProcedureStateChanged",
"ProcedureStateChangeEvent":{
"TaskId":"1256768367-Procedure-475b72xxxcb177t1",
"Status":"FINISH",
"ErrCode":0,
"Message":"",
"FileId":"5285890784246869930",
"FileName":"Animal World",
"FileUrl":"https://1256768367.vod2.myqcloud.com/xxx/xxx/xxx.mp4",
"MetaData":{
"AudioDuration":59.990001678467,
"AudioStreamSet":[
{
"Bitrate":383854,
"Codec":"aac",
"SamplingRate":48000
}
],
"Bitrate":1021028,
"Container":"mov,mp4,m4a,3gp,3g2,mj2",
"Duration":60,
"Height":480,
"Rotate":0,
"Size":7700180,
"VideoDuration":60,
"VideoStreamSet":[
{
"Bitrate":637174,
"Codec":"h264",
"Fps":23,
"Height":480,
"Width":640
}
],
"Width":640
},
"MediaProcessResultSet":[
{
"Type":"Transcode",
"TranscodeTask":{
"Status":"SUCCESS",
"ErrCode":0,
"Message":"SUCCESS",
"Input":{
"Definition":20
},
"Output":{
"Url":"https://1256768367.vod2.myqcloud.com/xxx/xxx/v.f20.mp4",
"Size":4189073,
"Container":"mov,mp4,m4a,3gp,3g2,mj2",
"Height":480,
"Width":640,
"Bitrate":552218,
"Md5":"eff7031ad7877865f9a3240e9ab165ad",
"Duration":60.04700088501,
"VideoStreamSet":[
{
"Bitrate":503727,
"Codec":"h264",
"Fps":24,
"Height":480,
"Width":640
}
],
"AudioStreamSet":[
{
"Bitrate":48491,
"Codec":"aac",
"SamplingRate":44100
}
],
"Definition":0
}
}
},
{
"Type":"CoverBySnapshot",
"CoverBySnapshotTask":{
"Status":"SUCCESS",
"ErrCode":0,
"Message":"SUCCESS",
"Input":{
"Definition":10,
"PositionType":"Time",
"PositionValue":0
},
"Output":{
"CoverUrl":"http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx.100_0.jpg"
}
}
}
]
}
}

Reliable callback

In the reliable callback mode, after calling the PullEvents API, you will receive an HTTP response in the following format (fields with null values are omitted):
{
"Response": {
"EventSet":[
{
"EventHandle": "EventHandleX",
"EventType": "ProcedureStateChanged",
"ProcedureStateChangeEvent":{
"TaskId": "1256768367-Procedure-475b72xxxcb177t1",
"Status": "FINISH",
"FileId": "5285890784246869930",
"FileName": "Animal World",
"FileUrl": "https://1256768367.vod2.myqcloud.com/xxx/xxx/xxx.mp4",
"MetaData":{
"AudioDuration": 59.990001678467,
"AudioStreamSet": [{
"Bitrate": 383854,
"Codec": "aac",
"SamplingRate": 48000
}],
"Bitrate": 1021028,
"Container": "mov,mp4,m4a,3gp,3g2,mj2",
"Duration": 60,
"Height": 480,
"Rotate": 0,
"Size": 7700180,
"VideoDuration": 60,
"VideoStreamSet": [{
"Bitrate": 637174,
"Codec": "h264",
"Fps": 23,
"Height": 480,
"Width": 640
}],
"Width": 640
},
"MediaProcessResultSet": [{
"Type": "Transcode",
"TranscodeTask":{
"Status": "SUCCESS",
"ErrCode": 0,
"Message": "SUCCESS",
"Input":{
"Definition": 20
},
"Output": {
"Url": "https://1256768367.vod2.myqcloud.com/xxx/xxx/v.f20.mp4",
"Size": 4189073,
"Container": "mov,mp4,m4a,3gp,3g2,mj2",
"Height": 480,
"Width": 640,
"Bitrate": 552218,
"Md5": "eff7031ad7877865f9a3240e9ab165ad",
"Duration": 60.04700088501,
"VideoStreamSet": [{
"Bitrate": 503727,
"Codec": "h264",
"Fps": 24,
"Height": 480,
"Width": 640
}],
"AudioStreamSet": [{
"Bitrate": 48491,
"Codec": "aac",
"SamplingRate": 44100
}],
"Definition": 0
}
}
},
{
"Type": "CoverBySnapshot",
"CoverBySnapshotTask":{
"Status": "SUCCESS",
"ErrCode": 0,
"Message": "SUCCESS",
"Input":{
"Definition": 10,
"PositionType": "Time",
"PositionValue":0
},
"Output": {
"CoverUrl": "http://1256768367.vod2.myqcloud.com/xxx/xxx/xxx.100_0.jpg"
}
}
}
]
}
}
],
"RequestId": "335bdaa3-db0e-46ce-9946-51941d9cb0f5"
}
}


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback