视频质量诊断系统诊断服务接口 V1.1.3.doc

视频质量诊断服务模块

二次开发接口说明

V1.

武汉东智科技有限公司

2013-5

前言

非常感谢您使用我们公司的产品，如果您有什么疑问或者需要请随时联系我们。

我们已尽量保证文档内容的完整性与准确性，但也无法避免出现技术升级以，及各模块版本差异性不同，造成的操作不相符等情况出现，如有疑问或者争议，请以本公司解释为主。

诊断服务模块和诊断服务文档将实时进行更新升级，无法通知到每个用户，如需最新版本诊断服务模块，请联系我们。

本文档内容仅为用户提供诊断服务模块接入第三方系统开发参考指导作用。

目录

TOC\o1-3\h\z\u前言 2

1.算法简介 4

1.1使用指南 4

1.2算法简介 4

3.运行环境 5

4.调用流程 5

5.数据类型 7

5.1诊断结果结构体 7

5.1.1诊断结果结构体定义 7

5.1.2诊断结果结构体参数说明 7

6接口函数 9

6.1初始化算法 9

6.2初始化库函数 9

6.3设置场景变换模板函数 9

6.4图像分析函数 10

6.5结果输出函数 11

6.6重启库函数 11

6.7退出算法 11

7算法配置文件说明 12

7.1文件vgscore.ini说明 12

7.2文件vgslost.ini说明 15

7.3整体配置文件说明 16

8调用示例 16

8帮助 18

8.1注意事项 18

8.2常见问题解答 18

1.简介

1.1使用指南

本说明书由前言、简介、运行环境、应用结构、数据说明、使用说明、配置文件说明、调用示例、帮助9部分组成。

“简介”中简单的介绍了诊断服务的应用功能和流程。

“应用结构”部分介绍了诊断服务程序和第三方系统已经视频数据源的出来流程结构。

“数据说明”部分列出了诊断指标项和诊断结果的详细说明。

“使用说明”部分包含了诊断服务配套的视频插件和诊断任务、诊断分组、诊断参数的设置应用。

“调用示例”部分包含了第三方应用程序如何简单调用算法接口函数的部分代码流程以及示例。

“帮助”部分列出了一些常见问题的解答。

1.2诊断服务简介

视频质量检测服务是基于视频质量检测算法，为客户提供灵活、便捷的视频质量诊断服务功能。实现与用户原有系统的快速对接，分派诊断任务，视频质量检测服务自动获取视频监控平台数据，完成智能视频诊断任务，并实时反馈结果，满足了用户在现有系统上扩展视频质量诊断服务的智能化运维功能需求。

3.运行环境

操作系统：

MicrosoftWindows7/Windows2008(支持32/64位系统)。

Windows2003/WindowsXP/Windows2000(支持32/64位系统)。

CPU：IntelPentiumIV3.0GHz或以上

内存：1G或更高。

4.应用结构

厂家自有系统可以设置诊断任务信息(包括诊断对像、诊断时间、诊断项目、诊断次数)。

视频质量检测服务返回诊断结果给厂家自有系统。

视频质量检测服务可以通过访问平台和设备两种方式获取视频诊断所需的数据。

5.数据说明

5.1诊断指标项定义

连通性|

连通状态

1：正常

0：异常

2：离线（设备在线，但是账号异常无法登陆）

3：阻塞（在线可登陆但视频浏览时卡或者无法抓取图片进行诊断）

信号缺失|

信号缺失

60差，60好，=200未诊断

偏色|

画面偏色

60差，60好，=200未诊断

清晰度|

清晰度故障

60差，60好，=200未诊断

亮度|

亮度故障

60差，60好，=200未诊断

条纹干扰|

条纹干扰

60差，60好，=200未诊断

雪花干扰|

雪花干扰

60差，60好，=200未诊断

场景变换|

场景变换

60差，60好，=200未诊断

画面冻结|

画面冻结

60差，60好，=200未诊断

PTZ速度|

暂时不用

60差，60好，=200未诊断

PTZ角度|

云台控制失效

60差，60好，=200未诊断

人为遮挡

人为遮挡

60差，60好，=200未诊断

5.2诊断结果说明

数据视频名称：v_vqd_result

字段编码

字段名称

字段类型

说明

备注

channelId

通道唯一id

Varchar

为后续平台对接提供备用

备用，后续如果对接平台，这个作为三方系统唯一标识一路图像的标识

vqdTime

诊断时间

TimeStamp

数据类型最好转为Datetime

诊断的时间，精确到秒

device_name

摄像机名称

varchar

摄像机名称

ipAddr

摄像机ip

varchar

摄像机ip地址

device_port

设备端口

Varchar