查询视频质量审核作业的状态与结果。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String QueryVideoQualityJob

系统规定参数。取值:QueryVideoQualityJob。

JobId String 7c2abbb270474c98823dac56cc067008

作业id。

UserId Long 1253406881704637

用户标识。

返回数据

名称 类型 示例值 描述
Code String Success

错误码。请求成功返回“Success”。

Job Struct

作业详情。

JobId String 0c8f04aa60bd4377a906bd6c91ec****

作业标识。

Message String The job is completed successfully

错误信息。

Output String blockness.txt

审核结果汇总,存放于用户提供的输出文件地址。

例如:blockness.txt,用户根据需要解析。格式示例:

{"审核标签一":[ {问题帧一}, {问题帧二}, ... , {问题帧N}]} {"审核标签二":[ {问题帧一}, {问题帧二}, ... , {问题帧N}]} ... {"审核标签N":[ {问题帧一}, {问题帧二}, ... , {问题帧N}]}
Status String Success

作业状态。取值:

  • Success:处理成功。
  • Fail:处理失败。
  • Processing:处理中。
  • Submitted:已提交等待处理。
UserId Long 1253406881704637

用户标识。

VideoQualityResults String {"LessExpose":[{"Ratio":"0.9176736581346892","TimeStamp":"00:00:10.0"}],"Noise":[{"Ratio":"0.0419343847352","TimeStamp":"00:00:05.0"}],"ImageDefinition":[{"TimeStamp":"00:00:05.0"},{"TimeStamp":"00:00:10.0"}],"Border":[{"TimeStamp":"00:00:05.0"},{"TimeStamp":"00:00:10.0"}],"Freeze":[{"Score":"1","TimeStamp":"00:00:00.233"},{"Score":"1","TimeStamp":"00:00:02.600"},{"Score":"1","TimeStamp":"00:00:02.900"},{"Score":"1","TimeStamp":"00:00:02.933"},{"Score":"1","TimeStamp":"00:00:03.400"},{"Score":"1","TimeStamp":"00:00:05.166"},{"Score":"1","TimeStamp":"00:00:05.800"},{"Score":"1","TimeStamp":"00:00:07.700"},{"Score":"1","TimeStamp":"00:00:07.800"},{"Score":"1","TimeStamp":"00:00:08.633"},{"Score":"1","TimeStamp":"00:00:08.833"},{"Score":"1","TimeStamp":"00:00:09.0"}]}

审核结果摘要,有质量问题的图片信息列表,不含坐标信息。

Message String The job is completed successfully

作业信息。

RequestId String 2774ABF9-34AD*****5F53BE4EFFB9

请求ID。

VideoQualityResults示例


"VideoQualityResults":{
  "Blockness":[
      {
        "TimeStamp":"hh:mm:ss[.SSS]",
        "Score":"0.33"
     },
     {
        "TimeStamp":"hh:mm:ss[.SSS]",
        "Score":"0.66"
     }
  ],
  "Brightness":[
     {
        "TimeStamp":"hh:mm:ss[.SSS]",
        "Result":"white",
        "Score":"0.33"
     },
     {
        "TimeStamp":"hh:mm:ss[.SSS]",
        "Result":"white",
        "Score":"0.66"
     }
  ],
  "Freeze":[
      {
        "TimeStamp":"hh:mm:ss[.SSS]",
        "Score":"0.33"
     },
     {
        "TimeStamp":"hh:mm:ss[.SSS]",
        "Score":"0.66"
     }
  ],
  "ImageDefinition":[
     {
       "TimeStamp":"hh:mm:ss[.SSS]"
     },
     {
       "TimeStamp":"hh:mm:ss[.SSS]",
     }
  ],
  "LessExpose":[
      {
        "TimeStamp":"hh:mm:ss[.SSS]",
        "Ratio":"0.33"
     },
     {
        "TimeStamp":"hh:mm:ss[.SSS]",
        "Ratio":"0.66"
     }
  ],
  "OverExpose":[
      {
        "TimeStamp":"hh:mm:ss[.SSS]",
        "Ratio":"0.33"
     },
     {
        "TimeStamp":"hh:mm:ss[.SSS]",
        "Ratio":"0.66"
     }
  ],
  "Border":[
      {
        "TimeStamp":"hh:mm:ss[.SSS]"
     },
     {
        "TimeStamp":"hh:mm:ss[.SSS]"
     }
  ],
  "Noise":[
      {
        "TimeStamp":"hh:mm:ss[.SSS]",
        "Ratio":"0.33"
     },
     {
        "TimeStamp":"hh:mm:ss[.SSS]",
        "Ratio":"0.66"
     }
  ],
  "Mosaic":[
      {
        "TimeStamp":"hh:mm:ss[.SSS]"
     },
     {
        "TimeStamp":"hh:mm:ss[.SSS]"
     }
  ]
  }

Output示例


{
	"brightness": [{
		"result": "dark",
		"score": -2.5150070190429688,
		"timestamp": "5520",
		"type": "brightness"
	}, {
		"result": "dark",
		"score": -2.1238651275634766,
		"timestamp": "344000",
		"type": "brightness"
	}]
} {
	"blockness": [{
		"result": "blocking",
		"score": 4.1806020736694336,
		"timestamp": "160",
		"type": "blockness"
	}, {
		"result": "blocking",
		"score": 4.515049934387207,
		"timestamp": "240",
		"type": "blockness"
	}]
} {
	"freeze": [{
		"result": "freeze",
		"score": 4.1445174217224121,
		"timestamp": "202240",
		"type": "freeze"
	}]
} {
	"border": [{
		"border": [0, 0, 1280, 720],
		"id": 25,
		"timestamp": 1000.0
	}, {
		"border": [1, 0, 1279, 720],
		"id": 50,
		"timestamp": 2000.0
	}]
} {
	"mosaic": [{
		"box": [
			[294, 59, 328, 93],
			[124, 98, 168, 142],
			[268, 109, 300, 141],
			[162, 109, 194, 141],
			[268, 76, 300, 108],
			[162, 59, 194, 91],
			[94, 73, 130, 109],
			[94, 28, 130, 64],
			[294, 94, 328, 128],
			[222, 21, 266, 65],
			[203, 21, 247, 65],
			[241, 33, 273, 65],
			[190, 59, 220, 89],
			[333, 59, 367, 93],
			[314, 59, 358, 103],
			[124, 53, 168, 97],
			[361, 59, 391, 89],
			[1029, 77, 1057, 105],
			[349, 59, 379, 89]
		],
		"id": 25,
		"timestamp": 1000.0
	}, {
		"box": [
			[241, 33, 273, 65],
			[228, 33, 260, 65],
			[189, 81, 221, 113],
			[336, 75, 366, 105],
			[254, 21, 298, 65],
			[163, 60, 205, 102],
			[320, 59, 354, 93],
			[125, 97, 169, 141],
			[221, 39, 247, 65]
		],
		"id": 50,
		"timestamp": 2000.0
	}]
} {
	"over_expose": [{
		"ratio": "0.97276288701703",
		"id": 25,
		"timestamp": 1000.0
	}, {
		"ratio": "0.8629491725526869",
		"id": 50,
		"timestamp": 2000.0
	}]
}

视频质量审核结果算法各字段含义

花屏识别(blockness)

字段

含义

result

检测结果:blocking和normal

score

结果置信度

timestamp

问题帧发生时间,单位:ms。

黑屏、白屏(brightness)

字段

含义

result

检测结果:dark,bright,black,white,normal

score

结果置信度

timestamp

问题帧发生时间,单位:ms。

静帧(freeze)

字段

含义

result

检测结果:freeze,normal

score

结果置信度

timestamp

问题帧发生时间,单位:ms。

模糊识别(image_definition)

字段

含义

id

问题帧

timestamp

问题帧发生时间,单位:ms。

低光照识别(less_expose)

字段

含义

ratio

欠曝比例

id

问题帧

timestamp

问题帧发生时间,单位:ms。

过曝光识别(over_expose)

字段

含义

ratio

过曝比例

id

问题帧

timestamp

问题帧发生时间,单位:ms。

黑边、白边(border)

字段

含义

border

图片的位置 [x1,y1,x2,y2]

id

问题帧

timestamp

问题帧发生时间,单位:ms。

马赛克识别(mosaic)

字段

含义

box

马赛克位置[x1,y1,x2,y2]

id

问题帧

timestamp

问题帧发生时间,单位:ms。

雪花/噪点识别(noise)

字段

含义

noise_rate

噪声比例

id

问题帧

timestamp

问题帧发生时间,单位:ms。

示例

请求示例

http(s)://[Endpoint]/?Action=QueryVideoQualityJob
&JobId=7c2abbb270474c98823dac56cc067008
&UserId=1253406881704637
&<公共请求参数>

正常返回示例

XML格式

<RequestId>2774ABF9-34AD*****5F53BE4EFFB9</RequestId>
<Message>The job is completed successfully</Message>
<Job>
    <Status>Success</Status>
    <Message>The job is completed successfully</Message>
    <UserId>1253406881704637</UserId>
    <Output>blockness.txt</Output>
    <VideoQualityResults>{"LessExpose":[{"Ratio":"0.9176736581346892","TimeStamp":"00:00:10.0"}],"Noise":[{"Ratio":"0.0419343847352","TimeStamp":"00:00:05.0"}],"ImageDefinition":[{"TimeStamp":"00:00:05.0"},{"TimeStamp":"00:00:10.0"}],"Border":[{"TimeStamp":"00:00:05.0"},{"TimeStamp":"00:00:10.0"}],"Freeze":[{"Score":"1","TimeStamp":"00:00:00.233"},{"Score":"1","TimeStamp":"00:00:02.600"},{"Score":"1","TimeStamp":"00:00:02.900"},{"Score":"1","TimeStamp":"00:00:02.933"},{"Score":"1","TimeStamp":"00:00:03.400"},{"Score":"1","TimeStamp":"00:00:05.166"},{"Score":"1","TimeStamp":"00:00:05.800"},{"Score":"1","TimeStamp":"00:00:07.700"},{"Score":"1","TimeStamp":"00:00:07.800"},{"Score":"1","TimeStamp":"00:00:08.633"},{"Score":"1","TimeStamp":"00:00:08.833"},{"Score":"1","TimeStamp":"00:00:09.0"}]} </VideoQualityResults>
    <JobId>0c8f04aa60bd4377a906bd6c91ec****</JobId>
</Job>
<Code>Success</Code>

JSON格式

{
    "RequestId": "2774ABF9-34AD*****5F53BE4EFFB9",
    "Message": "The job is completed successfully",
    "Job": {
        "Status": "Success",
        "Message": "The job is completed successfully",
        "UserId": 1253406881704637,
        "Output": "blockness.txt",
        "VideoQualityResults": "{\"LessExpose\":[{\"Ratio\":\"0.9176736581346892\",\"TimeStamp\":\"00:00:10.0\"}],\"Noise\":[{\"Ratio\":\"0.0419343847352\",\"TimeStamp\":\"00:00:05.0\"}],\"ImageDefinition\":[{\"TimeStamp\":\"00:00:05.0\"},{\"TimeStamp\":\"00:00:10.0\"}],\"Border\":[{\"TimeStamp\":\"00:00:05.0\"},{\"TimeStamp\":\"00:00:10.0\"}],\"Freeze\":[{\"Score\":\"1\",\"TimeStamp\":\"00:00:00.233\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:02.600\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:02.900\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:02.933\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:03.400\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:05.166\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:05.800\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:07.700\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:07.800\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:08.633\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:08.833\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:09.0\"}]}",
        "JobId": "0c8f04aa60bd4377a906bd6c91ec****"
    },
    "Code": "Success"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParameter.JobNotFound The job is not found. 作业不存在

访问错误中心查看更多错误码。