本文為您介紹單個清晰度轉碼完成事件、事件通知的內容和回調示例。
事件類型
StreamTranscodeComplete
事件說明
視頻的某個清晰度、某種格式的流(如:標清的MP4格式)轉碼完成時會產生此事件。目前單個清晰度至少1種格式的轉碼完成即可播放。
如果開啟了URL鑒權,則需要自己生成auth_key才能訪問播放地址,否則會返回HTTP 403
。關于URL鑒權的信息,請參見配置URL鑒權。
事件內容
參數名稱 | 類型 | 必備項 | 描述 |
EventTime | String | 是 | 事件產生時間,為UTC時間:yyyy-MM-ddTHH:mm:ssZ。 |
EventType | String | 是 | 事件類型,系統規定參數。固定為:StreamTranscodeComplete。 |
VideoId | String | 是 | 視頻ID。 |
Status | String | 是 | 視頻流轉碼狀態。
|
Bitrate | String | 否 | 視頻流碼率,單位:Kbps。 |
Definition | String | 否 | 視頻流清晰度定義。
|
Duration | Double | 否 | 視頻流長度,單位:秒。 |
Codec | String | 否 | 視頻流Codec名稱。 |
Encrypt | Boolean | 否 | 視頻流是否為加密流。 |
EncryptType | String | 否 | 加密類型。 |
ErrorCode | String | 否 | 作業錯誤碼,視頻流轉碼出錯時,會有該字段。 |
ErrorMessage | String | 否 | 作業錯誤信息,視頻流轉碼出錯時,會有該字段。 |
FileUrl | String | 否 | 視頻流的播放地址。不帶鑒權的auth_key,如果開啟了URL鑒權,則需要自己生成auth_key才能訪問。 |
Format | String | 否 | 視頻流格式。
|
Fps | String | 否 | 視頻流幀率,每秒多少幀。 |
Height | Long | 否 | 視頻流高度,單位:px。 |
Size | Long | 否 | 視頻流大小,單位:Byte。 |
Width | Long | 否 | 視頻流寬度,單位:px。 |
JobId | String | 否 | 轉碼作業ID。 |
WatermarkId | String | 否 | 水印ID列表,逗號分隔。 |
IsAudio | Boolean | 是 | 是否為音頻。 |
StartTime | String | 是 | 任務開始時間。UTC時間。 |
FinishTime | String | 是 | 任務結束時間。UTC時間。 |
Extend | String | 否 | 用戶自定義回調透傳數據,更多信息,請參見請求參數示例。 |
回調示例
回調示例說明:
對于HTTP回調,以下內容為HTTP Post Body。
對于MNS回調,以下內容為消息體。
{ "EventTime": "2017-03-20T07:49:17Z", "EventType": "StreamTranscodeComplete", "VideoId": "43q9fj74hdf****", "Status": "success", "Bitrate": "925", "Definition": "LD", "Duration": 15.0, "Encrypt": false, "FileUrl": "http://example.aliyundoc.com/DBEBDEAJS73J79BE4D****/52a53151eba5js73ke2da3b55bc5****.mp4", "Format": "mp4", "Fps": "30", "Height": 960, "Size": 1815321, "Width": 540, "JobId":"ddddddddddd", "Codec":"h264", "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", "IsAudio": false, "StartTime": "2017-03-20T07:49:17Z", "FinishTime": "2017-03-20T09:49:17Z", "Extend":"test data" }