本文为您介绍音视频分析完成事件、事件通知的内容和回调示例。
事件类型
VideoAnalysisComplete
事件说明
视频点播会对上传完成的音视频源文件进行分析,完成后会产生此事件。
说明
- 所有上传的音视频文件,默认都会进行源文件分析,且整个过程完全免费。
- 分析过程会提取源文件的时长、分辨率(宽高)、码率、帧率等基本的Meta信息。
- 分析完成后的Meta信息会录入媒资库,可通过获取源文件信息接口,获取更多的源文件Meta信息。
事件内容
参数名称 | 类型 | 必备项 | 描述 |
---|---|---|---|
EventTime | String | 是 | 事件产生时间,为UTC时间:yyyy-MM-ddTHH:mm:ssZ。 |
EventType | String | 是 | 事件类型,系统规定参数。固定为:VideoAnalysisComplete。 |
VideoId | String | 是 | 音视频ID。 |
Status | String | 是 | 分析源文件结果状态。
|
Width | Long | 否 | 源文件宽 ,源片为纯音频不会有该字段。 |
Height | Long | 否 | 源文件高 ,源片为纯音频不会有该字段。 |
Duration | Float | 否 | 源文件时长 ,单位:秒。 |
Bitrate | String | 否 | 源文件码率 ,单位:Kbps。 |
Fps | String | 否 | 源文件帧率 ,每秒多少帧,源片为纯音频不会有该字段。 |
Size | Long | 否 | 源文件大小,单位:Byte(字节)。 |
ErrorCode | String | 否 | 作业错误码,分析源文件信息出错时,会有该字段。 |
ErrorMessage | String | 否 | 作业错误信息,分析源文件信息出错时,会有该字段。 |
说明 Status=fail,表示分析不成功,则不会有源文件的基本信息,通常失败的原因是源文件封装信息有异常导致。
回调示例
回调示例说明:
- 对于HTTP回调,以下内容为HTTP Post Body。
- 对于MNS回调,以下内容为消息体。
分析成功回调消息,示例如下:
{
"VideoId":"84bd5b0566ddj39549986befd0e80****",
"Duration":"12",
"Height":"360",
"Width":"630",
"Fps":"30",
"Bitrate":"499",
"Size":"1234568",
"EventTime":"2018-11-28T10:12:48Z",
"EventType":"VideoAnalysisComplete",
"Status":"success"
}
分析失败回调消息,示例如下:
{
"VideoId":"84bd5b0566ddj39549986befd0e80****",
"EventTime":"2018-11-28T10:12:48Z",
"EventType":"VideoAnalysisComplete",
"Status":"fail",
"ErrorCode":"InvalidParameter.ResourceContentBad",
"ErrorMessage":"The resource operated InputFile is bad"
}