媒体质检接入
下载
聚焦模式
字号
功能简介
媒体质检支持检测直播、离线视频中的格式问题、画面内容问题、音频问题，并提供视频整体无参考评分。
质检类型 | 检测类型 | 检测项说明 |
格式质检 | 离线视频格式质检 直播流格式质检 | 检测 DTS、PTS 问题、分辨率变化、采样率变化、丢帧、重复帧等格式问题。 |
无参考评分 | 视频&音频无参考评分（MOS） | 根据多维度检测标准，对视频&音频质量进行百分制打分。 |
质量审核 | 画面质量 | 支持对视频的画面质量进行检测，具体检测项如下： JitterResults：画面抖动。 BlurResults：画面模糊。 AbnormalLightingResults：低光、过曝。 CrashScreenResults：花屏 BlackWhiteEdgeResults：画面黑边、白边、黑屏、白屏、纯色屏时间段。 NoiseResults：画面有噪点。 MosaicResults：画面有马赛克。 QRCodeResults：画面有二维码。 |
| 声音质量 | 支持对视频的声音质量做出检测，具体检测项如下： VoiceResults：音频异常，包括静音、低音、爆音。 |
场景一：处理离线文件
方法1：控制台发起任务
步骤1：创建离线服务编排
1. 登录媒体处理控制台 创建离线服务编排，在服务编排任务配置中插入“媒体质检”编排节点。
2. 添加节点后，会弹出新的页面，在页面中根据业务实际场景选择系统预设模板或者创建自定义模板，并保存设置。
3. 节点配置完成后，单击页面下方创建，完成创建服务编排。
4. 服务编排创建完成后返回离线服务编排列表页，在列表页中找到刚创建的编排，单击“启用”，按钮开启后约3 - 5分钟编排生效。
步骤2：发起质检任务
待服务编排生效后，即可往编排配置中的触发目录中上传需要质检的离线文件，此时将会按照编排中节点及模板的配置内容对上传的文件进行质检处理。
步骤3：管理质检任务
方法2：调用 API 处理
步骤1：发起质检任务
请求示例：
POST / HTTP/1.1Host: mps.tencentcloudapi.comContent-Type: application/jsonX-TC-Action: ProcessMedia
{"InputInfo": {"Type": "COS","CosInputInfo": {"Bucket": "test-<appid>","Region": "ap-shanghai","Object": "/video/test.mp4"}},"AiQualityControlTask": {"Definition": 10}}
示例说明：
1. Type 可以为 COS 和 URL，根据类型填写源文件路径。
2. Definition 为任务配置模板 ID，模板通过 CreateQualityControlTemplate 生成。
响应示例：
{"Response": {"TaskId": "26000002-ScheduleTask-8c0bb3a13e10462fc405262c623aeff4tt7"}}
示例说明：TaskId 是唯一任务标记，可用于查询和管理任务。
步骤2：查询任务详情
请求示例：
POST / HTTP/1.1Host: mps.tencentcloudapi.comContent-Type: application/jsonX-TC-Action: DescribeTaskDetail
{"TaskId": "26000002-ScheduleTask-8c0bb3a13e10462fc405262c623aeff4tt7"}
响应示例：
{"Response": {"WorkflowTask": {"Output": {"QualityControlResultSet": [{"Type": "BackWhiteEdge","QualityControlItems": [{"Confidence": 100,"StartTimeOffset": 12,"EndTimeOffset": 12}]}],"ContainerDiagnoseResultSet": [{"Category": "StreamAbnormalCharacteristics","DateTimeSet": [],"SeverityLevel": "Warning","TimestampSet": [11.006],"Type": "AudioDuplicatedFrame"}],"QualityEvaluationScore": 68}}}}
查看质检结果
质检结果报告
质检结果报告，是对质检结果的完整展现，可以查询视频的基本信息，和预览视频。在开启了对应的检测项后，能够查看对应质检问题的出现次数和视频整体评分。
如视频质检出现问题，会显示每项视频问题出现的时间段。支持鼠标点击时间轨道，跳转到对应的视频片段查看具体问题。
在质检问题列表页面，可以查看每一条质检问题上报的具体时间，帮助您对质检问题做进一步的定位和分析。
场景二：处理直播流
方法1：控制台发起任务
步骤1：创建直播服务编排
1. 登录媒体处理控制台 创建直播服务编排，在服务编排任务配置中插入“媒体质检”编排节点。
2. 添加节点后，会弹出新的页面，在页面中根据业务实际场景选择系统预设模板或者创建自定义模板，并保存设置。
3. 节点配置完成后，单击页面下方创建，完成创建服务编排。
4. 服务编排创建完成后返回直播服务编排列表页，列表页中可以找到刚创建的直播服务编排。
步骤2：创建直播质检任务
步骤3：管理直播质检任务
方法2：调用 API 处理
步骤1：发起直播质检任务
请求示例：
POST / HTTP/1.1Host: mps.tencentcloudapi.comContent-Type: application/jsonX-TC-Action: ProcessLiveStream
{"Url": "rtmp://tlivecloud.com/live/test","TaskNotifyConfig": {"NotifyType": "URL","NotifyUrl": "http://tlivecloud.com/callback"},"AiQualityControlTask": {"Definition": 10}}
示例说明：
1. Url 为直播流地址。
2. TaskNotifyConfig 为回调服务地址，当视频流诊断出异常时，将异常信息实时回调给该地址。
响应示例：
{"Response": {"TaskId": "24000002-live-procedure-813dc41e6fdc22dcf24aa6e9c61cp92"}}
示例说明：TaskId 是唯一任务标记，可用于查询和管理任务。
步骤2：解析直播异常回调
如果发起直播质检任务时配置了 TaskNotifyConfig，当视频流诊断出异常时，会将异常信息实时回调给配置的地址。
回调请求示例：
POST / HTTP/1.1Content-Type: application/json
{"NotificationType": "AiQualityControlResult","TaskId": "24000002-procedure-live-813dc41e6fdc22dcf24aa6e9c61cp92","AiQualityControlResultInfo": {"QualityControlResultSet": [{"Type": "BackWhiteEdge","QualityControlItems": [{"Confidence": 100,"StartTimeOffset": 12,"EndTimeOffset": 12}]}],"DiagnoseResultSet": [{"Category": "StreamStatusException","Type": "StreamOpenFailed","Timestamp": 0,"Description": "Open url failed.","DateTime": "2023-11-06T06:37:28Z","SeverityLevel": "Fatal"}]}}
示例说明：QualityControlResultSet 为内容质检的异常信息，DiagnoseResultSet 为格式诊断的异常信息。
文档反馈