中国电信网络视频监控业务技术规范v3—客户端单元分册-v5

'中国电信网络视频监控业务技术规范-V3.0客户端分册（送审稿）中国电信集团公司中国电信股份有限公司上海研究院2008年04月中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册内部资料，注意保密，未经同意，请勿翻印文档信息文档名称文件编号编制人保密级别修改过程版本号日期作者概述0.982007-04-13电信上海研究院删除所有电信客户端内容，建议在网管客户端体现。0.982007-04-13CU讨论组平台信令需增加电子地图经纬度信息设置和查询，以及电子地图的动态加载机制。0.982007-04-14CU讨论组历史录像记录查询的返回结果应根据CU与平台的定义进行规范评审过程版本号日期评审者概述V3.0-v52008-04-02梁笃国提交分发范围4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册目录1.适用范围12.引用标准13.定义和缩略语14.系统结构15.CU客户端系统15.1.CU概述15.2.CU的组成25.3.CU分类45.4.CU实现方式要求56.CU功能要求56.1.企业控制台/客户端66.2.电信客户端107.CU性能要求117.1.使用环境117.2.外观117.3.电磁兼容性117.4.抗雷性117.5.环境适应性117.6.可靠性要求128.软件的要求128.1.基本要求128.2.软件设计要求129.接口协议139.1.集成应用二次开发接口规范131.适用范围12.引用标准13.定义和缩略语14.系统结构15.CU客户端系统15.1.CU概述15.2.CU的组成25.3.CU分类45.4.CU实现方式要求56.CU功能要求54242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册6.1.企业控制台/客户端66.2.电信客户端107.CU性能要求117.1.使用环境117.2.外观117.3.电磁兼容性117.4.抗雷性117.5.环境适应性117.6.可靠性要求128.软件的要求128.1.基本要求128.2.软件设计要求129.接口协议139.1.集成应用二次开发接口规范134242中国电信集团公司中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册4242中国电信集团公司中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册1.适用范围本规范规定了中国电信网络视频监控系统的客户端单元实现要求。包括客户端的功能、性能指标、接口、传输的通信协议，以及子系统的和环境要求等。本规范主要适用于客户端子系统的开发设计。本标准起草单位：中国电信股份有限公司上海研究院。2.引用标准参见《中国电信网络视频监控业务技术规范V3.0-总体技术要求》。4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册1.定义和缩略语参见《中国电信网络视频监控业务技术规范V3.0-总体技术要求》。2.系统结构参见《中国电信网络视频监控业务技术规范V3.0-总体技术要求》。3.CU客户端系统3.1.CU概述CU是系统的客户端单元，负责对系统功能对用户的集中呈现、人机交互。可实现监控中心及普通客户端等多种应用。在系统中，CU所处位置如图5.1.1所示。图5.1.1CU在系统中的位置CU对前端设备的访问和控制信令都需要通过中心服务系统交互实现。CU和中心服务系统构成完整的服务器/客户应用架构，CU作为客户端应用。3.2.CU的组成CU主要分为监控中心、普通客户端两种应用模式。监控中心由数字矩阵、4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册软/硬件解码器、控制台等设备组成。利用数字矩阵实现的监控中心设备组成如图5.2.1所示：图5.2.1监控中心设备（一）利用解码器实现的监控中心设备组成如图5.2.2所示：图5.2.2监控中心设备（二）4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册1.1.1.数字矩阵数字矩阵可以将从网络接收到的视频解码，输出到一台或多台监视器上，并可实现多画面分割显示和视频拼接，单画面轮巡显示，多画面分组轮巡显示。一般通过在工控机中加装视频转换卡实现。输出接口为标准BNC接口或RCA接口可通过控制台设置、控制数字矩阵。1.1.2.解码器解码器可以将从网络接收到的视频解码，输出到一台或多台监视器上，并可实现多画面分割显示，单画面轮巡显示，多画面分割轮巡显示。一般通过嵌入式系统实现。输出接口为标准BNC接口或RCA接口。可通过控制台设置、控制各个解码器。1.1.3.控制台控制台由控制台软件实现，主要完成平台的接入、视频接收播放、报警信号接收/联动、画面控制、系统设置、数字矩阵及解码器的控制等功能。1.1.4.客户端客户端由客户端软件实现，主要完成平台的接入、视频接收播放、报警信号接收/联动、画面控制、系统设置等功能。1.2.CU分类CU实现需提供下列客户端管理应用系统：1）企业客户端4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册针对电信全球眼业务客户使用，提供远程图象监控系统应用，包括提供电视墙应用解决方案，包括：。(1)普通用户客户端(2)企业管理员客户端2）电信客户端针对电信运维部门使用，提供设备维护（添加、删除、划归）、用户维护、权限分配、设备参数的设置和控制、系统维护以及网管等功能。1.1.CU实现方式要求1）跨操作系统平台的支持要求应用系统必须支持WINDOWS平台用户，宜支持LINUX平台用户。2）模块化设计系统采用模块化的结构设计思想，将数据业务（音视频数据、控制命令、报警数据、可选电子地图）和应用逻辑（监控应用）分开，并提供二次开发插件。(1)音视频控件音视频软解压控件是整个软件设计的核心，它嵌入在客户端应用软件中，应具备与中心服务（CMS/VTDU）或直接与PU的图像监控数据接收，图像显示、录像及云台控制，I/O监控等基本功能，并须向用户提供统一编程接口。(2)报警模块业务报警的采集，比如：视频丢失报警、开关量报警、移动侦测报警信号。(3)电子地图采用多图层、可伸缩、可平移的地图展示方式。3）支持C/S、B/S两种企业客户端应用系统企业CU客户端系统可以考虑提供C/S结构的胖客户端系统，也可以考虑基于WEB方式的客户端系统，基于WEB方式的客户端系统需要在中心服务端提供相应的WEB服务应用。4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册1.CU功能要求用于浏览和控制远端视频及系统的设备。企业客户端包括播放图像、云台控制、录像检索、录像配置、报警联动、设备配置、用户登录、用户管理、电视墙控制、日志察看等。1.1.企业控制台/客户端企业CU客户端是面向业务客户的集中监控应用系统。主要功能有应：1）登录认证：提供登录验证界面，实现与平台PAG（或CCS）及CMS的交互后进入系统。2）远程浏览：(1)支持自动以树形结构将浏览的前端设备和摄影头排列出来，可以根据业务、区域等进行分组。同时结合手工自由点播实时或历史画面(2)支持1、4、6、9、16等多种画面分割模式，以及全屏显示；要求程序界面能够自适应屏幕显示分辨率(3)支持对音频的实时接收，可选择静音/打开音频，本地音量调节(4)支持多画面轮巡，即系统应具备视频自动巡视功能，在可设定的间隔时间内对所有的监控点进行图像巡检，参与轮巡的对象可以任意设定，包括不同监控点的图像、同一监控点内不同摄像机、同一摄像机的不同预置位等，轮巡间隔时间可设置(5)支持本地字幕半透明叠加，且字幕位置可调(6)支持图象实时抓拍功能(7)支持本地实时录像功能(8)抓拍和录像路径可设置(9)提供实时码率显示功能，显示与关闭提供开关操作(10)可通过web方式监视即时画面并调阅录像资料2）提供电子地图功能n支持多级电子地图（可选择矢量图、三维立体图或图片格式的地图）n支持电子地图的伸缩、平移、分图层显示4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册n图片格式的地图的方式支持客户自动上载更新图片n报警发生时，报警地点以醒目的标记闪烁在电子地图上，准确判断报警类型和地点2）远程控制(1)云台控制（上、下、左、右），包括自动巡航，预置位、灯光/雨刷功能的支持(2)摄象机色度、亮度、饱和度、对比度的实时控制(3)镜头控制应包括变倍、调焦（应具有手动和自动调焦功能）、光圈（应具有手动和自动光圈调节功能）(4)镜头控制要求客户端在图像分屏和全屏显示状态下都可进行3）报警信息的接收以及报警联动：(1)支持报警信息的接收。报警信息经管理中心服务器转发，能够精确的将报警信息传送到客户机，同时具备语音、图像（画面弹出）的提示，并在本机生成报警日志，报警提示可根据设备一直发生作用，终止条件是操作人员人工进行干预(2)报警类别，可能包括消防报警、防盗报警、防火报警、门禁报警、非法闯入及画面异动报警、图像设备故障报警以及通过温度、湿度探测器发出报警信息等(3)支持红外、光敏报警，当发生报警时，监控中心能自动进行存盘录像，并自动在地理图上提示报警位置及类型(4)当发生报警时，能联动多路相关设备，如临近摄像头、启动现场照明、警笛等，且联动策略可按不同时段独立设定(5)报警信息应该和录像数据相结合，可由报警信息检索回放相应的图像录像(6)支持报警信息的查询，并提供报警信息查询和浏览窗口(7)支持开关量/移动侦测的布防、撤防的设置(8)画面移动侦测报警的参数可设置(9)支持联动策略的配置（支持联动输出报警设备/灯光打开/录像开启）(10)对移动目标具有自动跟踪功能，该功能应能随时启动关闭（可选）4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册4）支持录像控制(1)支持前端录像、中心录像、本地录像三种录像存储方式(2)支持手动、定时、周期录像(3)录像的远程检索回放、下载本地回放(4)可依输入时间、地点直接搜寻历史录像，并可实现快进、快退、单帧放、慢放、暂停等功能(5)客户端的录像资料支持通用播放软件播放。(RealPlayer或MediaPlayer)5）远程操作：对指定的远端PU进行远程操作，如PU的参数设置、通道参数的设置、串口参数的配置、报警参数的设置和查询、字母叠加设置、字母位置调节6）系统功能(1)支持键盘快捷键云台控制(建议)快捷键功能TAB焦点视频窗口切换空格焦点视频窗口最大化/回复切换方向键焦点摄像头云台转动Home/End焦点摄像头镜头放大/缩小F11全屏(2)锁定系统功能“锁定系统”：就是将系统控制权限降为最低，使当前系统处于锁定状态，只提供最基本的监视功能，包括禁用关闭系统。“解除锁定”：在锁定系统后，要重新恢复对系统的控制权，必须首先解除锁定。(3)在线升级客户端软件需提供新版本提示及在线升级(4)系统日志支持系统日志的查询，并提供当前系统日志的查询和浏览窗口。4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册7）与PU双向语音交流能与自己权限许可的前端设备之间进行双向的实时语音对讲，同时具有对前端设备分组进行语音广播。8）辅助功能(可选)(1)操作杆功能(2)辅助键盘控制9）电视墙的控制（可选）电视墙是由多个监视器组成的，每个监视器对应一路视频输出（比如对应一个解码器的视频输出），这些关系是固定的。可以从PU列表中把某个PU拖到电视墙上，并能对这个PU的图像控制，如开始播放和停止播放；还可以控制该PU的云镜。支持手动调看、序列切换、群组序列调看、群组序列切换功能：n通过中文名称列表方式或电子地图图标方式手动在任意监视器上切换系统中任一个摄像机图像n在任一个监视器上调用任一个序列进行自动切换显示n在多个监视器一次性同时调看任一个编组序列的所有摄像机图像n将多个编组序列同时在多个监视器上进行群组的自动切换显示n切换间隔时间可调10）多画面合成的控制（可选）支持对用户选择的多个PU视频流合成包括多个画面的一路视频流。11）解码器/解码矩阵的管理功能（可选）n对中心一个或多个解码器/解码矩阵的配置管理；其IP地址、通道数、每个通道对应的默认的显示图象的IP地址、通道号配置信息的存储n每个解码器通道对应的电视墙信息的存储n每个监视器可显示多个通道的信息（IP）配置管理n是否轮跳配置管理。轮跳策略n4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册可设定每个解码器/解码矩阵报警时输出图象的通道；当收到报警联动输出信息时将指定图象在设定的通道输出n可设定每个解码器/解码矩阵音频的通道选择和控制n将网络中任意若干个摄像机编组成若干个切换序列12）客户自助管理可由客户管理员自助进行相应的管理如，配置管理、权限管理、操作员管理、告警管理、日志管理等。13）图像辨识功能（可选）通过图像辨识处理实现行业的智能辨识需要，如交通系统和交警系统需要的车牌辨识功能。1.1.电信客户端电信客户端是电信运维部门实施业务开通,设备管理以及权限管理的系统，为业务开展提供支持平台。1）设备管理：(1)监控设备的系统添加维护管理操作界面(2)支持设备状态的查询，并提供系统设备（如前端）状态浏览、参数设置、初始化等操作界面(3)支持平台间设备划归1)2）用户管理：(1)用户组的维护，可以实现一个企业的多个用户为一个组(2)负责客户用户的受理，使用情况的统计(3)提供用户帐号、口令等控制界面(4)提供多级区域、机构的设置界面3）权限设置：(1)用户/用户组可访问的设备的列表信息维护(2)用户/用户组相应的控制操作权限设置界面4）业务开通：提供开户、禁用/启用、注销等业务开通管理5）系统维护：4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册(1)系统日志管理(2)对中心各功能服务运行状态的监控(3)前端设备的状态管理6）巡检与校时：(1)定时对前端设备进行巡检，当设备有故障时（断线、无视频），产生告警信息；(2)可以统一对系统中的设备进行校时7）平台注册：对有跨平台访问的平台的信息注册。1.CU性能要求CU的控制台、客户端、解码器及数字矩阵必须达到如下性能要iu11.1.使用环境工作温度要求为0 ℃～50 ℃范围内，相对湿度要求在10%～90%内。1.2.外观按照中国电信2.0＋测试规范要求。1.3.电磁兼容性符合我国电磁兼容标准GB3907－1983。符合classA级别。1.4.抗雷性1.4.1.防雷设计方案为增强电源的防雷击效果，需要在电源的输入前端加入电源避雷器，这样可大大增强电源的抗雷击能力。4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册1.1.1.接地设计方案保证设备用接地线与大地保持良好接触，保证交流电源插座的中性线与大地良好接触。1.2.环境适应性交流电源电压标称值为220 V，频率标称值为50 Hz。电压在187 V～253 V范围内波动、频率在47.5 Hz～52.5 Hz范围内波动时，设备应能正常工作。1.3.可靠性要求应该满足5个9的要求，达到99.999%。2.软件的要求2.1.基本要求1)要求软件采用分层的模块化结构，模块之间的通信应按规定接口进行。任何一层的任何一个模块的维护和更新以及新模块的追加都不影响其它模块。2)系统参数、用户资料与处理程序应有相对的独立性。用户资料的任何变更都不应引起运行版本程序的变更。处理程序应与系统参数、用户资料相适应。3)软件应有容错能力，一般的软件故障不应引起各类严重的系统再激活。4)软件设计应有防护性能，某一软件模块内的软件错误应限制在本模块内，而不应造成其它软件模块的错误。5)应具有软件运行故障的监视功能。一旦软件出现死循环等重大故障，应能自动再激活，并能出实时故障报告信息。6)系统中所有涉及到时间的信息和资料其年份部分采用带纪元表示法。7)软件具有详细、完善、灵活的业务、用户等资料的统计、分析、预测能力。2.2.软件设计要求4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册1)应用软件应采用分层次的体系结构，以便于系统的维护和扩展；2)应用软件应能根据用户规模的不同支持集中处理模式和分布式处理；3)应用软件应具有很好的开放性，以便于与其它应用系统的连接；系统应提供完整的二次开发工具及使用说明，便于进行客户化工作；4)应用软件应具有很好的可移植性，支持多种操作系统，并能移植到不同厂家的硬件平台上运行；5)系统的运行应是安全、可靠的，具备完善的、分级的操作/访问权限控制；6)系统应具有资料备份及灾难恢复功能。1.接口协议1.1.集成应用二次开发接口规范1.1.1.接口规范目标要求提供标准的客户端二次开发控件，便于第三方的二次开发。1.1.2.接口原则插件封装CU与VTDU音视频数据请求和回应接口；同时可以封装CU预CMS的控制命令接口。接口使对外提供调用的方法，使用的属性以及事件。1.1.3.接口规范1.1.3.1.客户端插件功能需求控件基本要求：控件可以在同一个程序中进行多个实例化；控件可以初始化，自动销毁销毁，并支持多线程调用；控件可以通过认证登录到平台服务器；控件可以根据用户权限获取视频列表，以及分组信息。4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册控件能够支持动态获取视频点的情况，如设备上线或者下线等情况。控件能够支持动态获取告警信息。实时流模式的功能要求：在指定的窗口中播放实时视频视频播放可以暂停，暂停时窗口要保持为当时的帧图像取消暂停后要能继续播放当前的实时视频（要丢掉暂停时没有观看的帧）清除播放缓冲区中的数据，以改善播放迟时把当前帧以BMP或JPEG文件格式保存在播放过程中，打开或关闭声音，并支持双向语音功能。（同时播多个图像时，可以同时播放声音）关闭视频播放录像功能要求：能够进行本地录像；录像时候，可以播放视频，也可以不播放。录像格式可以直接用MediaPlay进行播放或者点播，推荐使用ASF格式；文件播放模式的功能要求：在指定的窗口中播放视频文件视频播放可以暂停，暂停时窗口要保持为当时的帧图像取消暂停后要能继续播放当前的视频文件查询当前播放的位置，第几帧设置当前播放的位置，第几帧查询文件的总长度，多少帧支持1/21/41/81/16每秒一帧五种慢放功能可以支持向前或向后两种回放方向支持×2×4×8×16四种快放功能可以把当前帧以BMP或JPEG文件格式保存在播放过程中，打开或关闭声音。（同时播多个图像时，可以同时播放声音）4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册1.1.1.1.音视频插件接口定义9.3.3.2.1插件初始化HRESULTInitialize()功能描述初始化插件资源参数说明无参数返回说明执行成功返回0，错误时返回错误码9.3.3.2.2插件反初始化HRESULTUninitialize()功能描述释放插件资源参数说明无参数返回说明执行成功返回0，错误时返回错误码9.3.3.2.3打开文件播放模式HRESULTOpenFile(long*phHandle,BSTRstrFileName,longlPos,longhWnd)功能描述打开文件播放模式参数说明phHandle用于接收返回播放句柄的地址。strFileName要播放的文件名（绝对路径）。文件大小不能超过4G或小于4KlPos4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册播放位置（百分数），为0~100之间的整数hWnd窗口句柄，不允许为空返回说明执行成功返回0，*phHandle保存解码资源的句柄；错误时返回错误码。9.3.3.2.4关闭文件播放模式HRESULTCloseFile(longhHandle)功能描述关闭文件播放模式参数说明hHandle要关闭的播放句柄返回说明执行成功返回0，错误时返回错误码9.3.3.2.5打开URL播放模式HRESULTOpenUrl(long*phHandle,BSTRstrUrl,longlPos,longhWnd,BSTRstrFileName)功能描述打开URL播放模式参数说明phHandle用于接收返回播放句柄的地址。strUrl要播放的URL。lPos播放位置（百分数），为0~100之间的整数hWnd窗口句柄，为空表示直接下载strFileName保存文件的绝对路径（带.asf扩展名），文件格式：ASF格式返回说明执行成功返回0，*phHandle保存解码资源的句柄；错误时返回错误码。4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册9.3.3.2.6关闭URL播放模式HRESULTCloseUrl(longhHandle)功能描述关闭URL播放模式参数说明hHandle要关闭的播放句柄返回说明执行成功返回0，错误时返回错误码9.3.3.2.7打开流播放模式HRESULTOpenStream(long*phHandle,BSTRstrRemoteIP,longlRemotePort,longlNetType,longlPacketType,longhWnd,BSTRstrFileName)功能描述打开流播放模式参数说明phHandle要打开的播放句柄strRemoteIP远端IP地址lRemotePort远端IP端口lNetType0:UDP1:TCP2:MulticastlPacketType0:RTP1:TShWnd窗口句柄，为空表示直接下载strFileName保存文件的绝对路径（带.asf扩展名），文件格式：ASF格式返回说明执行成功返回0，*phHandle保存解码资源的句柄；错误时返回错误码。播放视频画面大小将根据hWnd窗口调整，要全屏显示，只要把hWnd窗口放大到全屏。4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册9.3.3.2.8关闭流播放模式HRESULTCloseStream(longhHandle)功能描述关闭流播放模式参数说明hHandle要关闭的播放句柄返回说明执行成功返回0，错误时返回错误码9.3.3.2.9开始音频发送HRESULTStartAudio(long*phHandle,BSTRstrRemoteIP,longlRemotePort,longlNetType,longlPacketType)功能描述开始音频编码，并发送给对方参数说明phHandle要打开的音频发送句柄strRemoteIP远端IP地址lRemotePort远端IP端口lNetType0:UDP1:TCP2:MulticastlPacketType0:RTP1:TS返回说明执行成功返回0，错误时返回错误码与OpenStream配合，可实现双向语音对讲9.3.3.2.10停止音频发送HRESULTStopAudio(longhHandle)功能描述4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册停止发送声音，停止音频编码，参数说明hHandle播放句柄返回说明执行成功返回0，错误时返回错误码9.3.3.2.11设置音量大小HRESULTSetVolume(longhHandle,longlVolume,boolbCapture)功能描述设置音量大小参数说明hHandle播放句柄lVolume音量的值，范围0-0XFFFFbCapture播放音量或采集音量返回说明执行成功返回0，错误时返回错误码9.3.3.2.12开始播放实时视频HRESULTPlay(longhHandle)功能描述开始播放实时视频参数说明hHandle播放句柄hWnd播放视频的窗口句柄返回说明执行成功返回0，错误时返回错误码如果已经播放，只是改变当前播放速度为正常速度。4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册9.3.3.2.13停止播放HRESULTStop(longhHandle)功能描述停止播放参数说明hHandle播放句柄返回说明执行成功返回0，错误时返回错误码9.3.3.2.14暂停播放HRESULTPause(longhHandle,longlPause)功能描述暂停播放参数说明hHandle播放句柄lPauselPause=TRUE暂停；否则恢复播放返回说明执行成功返回0，错误时返回错误码9.3.3.2.15刷新显示区域HRESULTRefreshSurface(longhHandle)(可删除)功能描述刷新显示区域参数说明hHandle播放句柄返回说明4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册执行成功返回0，错误时返回错误码9.3.3.2.16读取播放位置HRESULTGetPlayPos(longhHandle,long*pPos)功能描述读取播放位置参数说明hHandle播放句柄pPos播放位置(百分数)，为0~100之间的整数返回说明执行成功返回0，错误时返回错误码9.3.3.2.17设置播放位置HRESULTSetPlayPos(longhHandle,longlPos)功能描述设置播放位置参数说明hHandle播放句柄lPos播放位置（百分数），为0~100之间的整数返回说明执行成功返回0，错误时返回错误码9.3.3.2.18设置回放方向HRESULTSetPlayDirection(longlDirection)功能描述设置回放方向参数说明lDirection4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册回放方向，1表示向前，0表示向后返回说明执行成功返回0，错误时返回错误码9.3.3.2.19快速播放HRESULTFast(longhHandle,longlSpeed)功能描述快速播放速度调节参数说明hHandle播放句柄lSpeed加快倍速：1=1x/2=2x/4=4x/8=8x/16=16x返回说明执行成功返回0，错误时返回错误码9.3.3.2.20慢速播放HRESULTSlow(longhHandle,longlSpeed)功能描述慢速播放速度调节参数说明hHandle播放句柄lSpeed减慢倍速：1=1x/2=2x/4=4x/8=8x/16=16x，0为单帧播放返回说明执行成功返回0，错误时返回错误码9.3.3.2.21文字合成HRESULTOverlayText(longhHandle,longlPointX,longlPointY,longlColor,longlAlpha,BSTRstrText)功能描述4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册将文字合成到视频上参数说明hHandle播放句柄lPointXX轴坐标，单位：象素lPointYY轴坐标，单位：象素lColor文本颜色，RGBlAlpha透明度：0－100strText需要参与合成的文字返回说明执行成功返回0，错误时返回错误码9.3.3.2.22清除文字合成HRESULTClearOverlayText(longhHandle,BSTRstrText)功能描述清除显示的文字参数说明hHandle播放句柄strText被清除的文字，空字符串表示清除所有返回说明执行成功返回0，错误时返回错误码9.3.3.2.23开始录像HRESULTStartRecord(longhHandle,BSTRstrFileName)功能描述本地录像开始参数说明hHandle播放句柄strFileName4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册录像文件的绝对路径（带.asf扩展名），文件格式：ASF格式返回说明执行成功返回0，错误时返回错误码9.3.3.2.24停止录像HRESULTStopRecord(longhHandle)功能描述本地录像停止参数说明hHandle播放句柄返回说明执行成功返回0，错误时返回错误码9.3.3.2.25抓屏HRESULTCapPic(longhHandle,BSTRstrFileName,longlPicType)功能描述抓取当前帧存储为BMP/JPEG图片参数说明hHandle播放句柄strFileName图像文件的绝对路径（BMP带.bmp扩展名，JPEG带.jpg扩展名）lPicType0:BMP1:JPEG返回说明执行成功返回0，错误时返回错误码4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册9.3.3.2.26读取流信息HRESULTGetStreamInfo(longhHandle,long*lBitRate,long*lLostRate,long*lFrameRate,BSTR*strVideo,BSTR*strAudio,long*lWidth,long*lHeight)功能描述读取流信息参数说明hHandle播放句柄lBitRate当前流码率，单位：bpslLostRate当前丢包率，为实际丢包率×10000返回lFrameRate当前视频帧率strVideo视频编码格式，如：MPEG4/H.264strAudio音频编码格式，如：G.711.A/G.722lWidth视频帧宽度，CIF为352lHeight视频帧高度，CIF为288返回说明执行成功返回0，错误时返回错误码9.3.3.2.27读取版本信息HRESULTGetVersion(BSTR*strVersion)功能描述读取版本信息参数说明strVersion格式：W.X.Y.ZYYYY-MM-DD[版本文字描述可选]返回说明执行成功返回0，错误时返回错误码4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册9.3.3.2.28读取参数HRESULTGetParameter(longhHandle,longlType,long*pPara1,long*pPara2)功能描述读取参数参数说明hHandle播放句柄lType参数类型：网络缓冲时间（0－60）秒、是否将播放窗口置于最上层……lPara1参数1lPara2参数2返回说明执行成功返回0，错误时返回错误码9.3.3.2.29设置参数HRESULTSetParameter(longhHandle,longlType,longlPara1,longlPara2)功能描述设置参数参数说明hHandle播放句柄lType参数类型：网络缓冲时间（0－60）秒、是否将播放窗口置于最上层……lPara1参数1lPara2参数2返回说明执行成功返回0，错误时返回错误码4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册9.3.3.2.30设置消息接收窗口HRESULTSetMsgWnd(longhHandle,longhWnd)功能描述设置消息接收窗口参数说明hHandle播放句柄hWnd窗口句柄返回说明执行成功返回0，错误时返回错误码消息定义：0x0801回放结束通知消息0x0802实时流中断消息0x0803下载进度通知消息，每下载1%通知一次9.3.3.2.31设置显示回调函数HRESULTSetDisplayCallBack(longhHandle,long(__stdcall*pDisplayCallBack)(long*pBuffer,longlLength,longlWidth,longlHeight,longnTimeStamp,longlColorSpace))功能描述设置显示回调函数参数说明hHandle播放句柄pDisplayCallBack显示回调函数pBuffer视频数据缓冲参数lLength视频数据缓冲参数长度lWidth显示宽度lHeight显示高度4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册lTimeStamp视频数据时间戳lColorSpace颜色空间类型：0:I4201:RGB242:RGB323:YV124:YUY25:UYVY6:YVYU7:RGB5558:RGB565返回说明执行成功返回0，错误时返回错误码9.3.3.3业务操作插件接口定义9.3.3.3.1连接服务器HRESULTConnectServer(BSTRstrIP,longlPort,BSTRstrName,BSTRstrPwd)功能描述连接到服务器参数说明strIP服务器IP地址lPort服务器端口strName用户登录名strPwd用户登录密码，接口上传递明文密码，由插件内部对其进行加密传输返回说明执行成功返回0，错误时返回错误码9.3.3.3.2断开服务器连接HRESULTDisconnectServer()功能描述断开服务器连接参数说明无返回说明执行成功返回0，错误时返回错误码4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册9.3.3.3.3获取设备列表（列表传递格式需讨论）HRESULTGetDeviceList(BSTRstrGroup,BSTR*strList)功能描述获取设备列表参数说明strGroup组标识，当该参数为空字符串时，strList返回根机构的设备列表strList获得设备列表信息，包括设备的状态信息，设备的是否可控信息等Schema定义如下：4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册返回说明执行成功返回0，错误时返回错误码9.3.3.3.4开始实时监控HRESULTStartMonitor(long*phHandle,BSTRstrFDID,BSTRstrFDChannel)功能描述对某一设备发起实时监控请求。参数说明phHandle监控句柄strFDID前端设备的代码编号，形如“200000000100011802”的字符串strFDChannel4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册前端设备通道的代码编号，形如“0001”的字符串返回说明执行成功返回0，错误时返回错误码9.3.3.3.5停止实时监控HRESULTStopMonitor(longhHandle)功能描述停止实时监控。参数说明hHandle监控句柄返回说明执行成功返回0，错误时返回错误码9.3.3.3.6开始双向语音对讲HRESULTStartCall(long*phHandle,BSTRstrFDID,BSTRstrFDChannel)功能描述对某一设备发起双向语音对讲请求。参数说明phHandle监控句柄strFDID前端设备的代码编号，形如“200000000100011802”的字符串strFDChannel前端设备通道的代码编号，形如“0001”的字符串返回说明执行成功返回0，错误时返回错误码9.3.3.3.7停止双向语音对讲HRESULTStopCall(longhHandle)功能描述4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册停止双向语音对讲。参数说明hHandle监控句柄返回说明执行成功返回0，错误时返回错误码9.3.3.3.8查询录像文件HRESULTQueryRecordFile(BSTRstrFDID,BSTRstrFDChannel,BSTRstrBeginTime,BSTRstrEndTime)功能描述查询录像文件。参数说明strFDID前端设备的代码编号，形如“200000000100011802”的字符串strFDChannel前端设备通道的代码编号，形如“0001”的字符串strBeginTime开始时间格式：YYYY-MM-DDhh-mm-ss如：2007-01-0101:01:01strEndTime结束时间格式：YYYY-MM-DDhh-mm-ss如：2007-01-0201:01:01返回说明执行成功返回0，错误时返回错误码9.3.3.3.9云台是否可控HRESULTHasPTZ(longhHandle,long*lPTZ)功能描述云台是否可控参数说明hHandle要控制的播放窗口的句柄lPTZ4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册是否可控，1表示可以控制，0或－1表示不可以控制返回说明执行成功返回0，错误时返回错误码9.3.3.3.10发送云台控制命令HRESULTPTZControl(longhHandle,longlCommand,longlParam)功能描述发送云台控制命令参数说明hHandle要控制的播放窗口的句柄lDirection云台控制命令：LENS_UP0x01向上转LENS_LEFT0x02向左转LENS_ROTATE0x03旋转LENS_RIGHT0x04向右转LENS_DOWN0x05向下转LENS_FAR0x06镜头拉远LENS_FOCUSNEAR0x07聚焦LENS_AUTO0x08自动LENS_FOCUSFAR0x09散焦LENS_NEAR0x0A镜头拉近LENS_DIAPHRAGM_LARGE0x0B光圈增大（变亮）LENS_DIAPHRAGM_SMALL0x0C光圈减小（变暗）LENS_STOP0x0D停止动作LENS_SPEAKER_ON0x0E打开喇叭LENS_LIGHT_ON0x0F打开灯光LENS_HOTDOG0x10热狗扫描4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册LENS_SPEAKER_OFF0x11关闭喇叭LENS_LIGHT_OFF0x12关闭灯光LENS_PRESET_GOTO0x13切换到预置点LENS_PRESET_SET0x14设置预置点LENS_PRESET_DEL0x15删除预置点LENS_PRESET_CLEAR0x1E清除所有预置点LENS_CAMERA_RESET0x16摄像机复位LENS_AUTOCRUISE0x1D自动巡航LENS_STARTTRACKING0x1F启动跟踪LENS_STOPTRACKING0x20停止跟踪LENS_CAMERAACTIVE0x28摄像机激活LENS_SETPANSPEED0x29设置左右转动速度LENS_SETTILTSPEED0x30设置上下转动速度LENS_SETZOOMSPEED0x31设置光圈速度LENS_SETFOCUSSPEED0x32设置聚焦/散焦速度LENS_SPEEDSETTINGGET0x33获取摄像机速度LENS_MATRIXSWITCH0x40矩阵切换lParam为一些需要参数配合命令提供参数，输入参数。对于上下左右转动等命令来说，本参数提供速度数值。速度的值变化范围在1－7之间返回说明执行成功返回0，错误时返回错误码9.3.3.3.11获取录像计划HRESULTGetRecordPlan(BSTRstrFDID,BSTRstrFDChannel,boolbCenter,BSTR*strPlan)功能描述查询录像计划。参数说明strFDID4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册前端设备的代码编号，形如“200000000100011802”的字符串strFDChannel前端设备通道的代码编号，形如“0001”的字符串bCenter0(false)表示前端存储，1(true)表示中心存储strPlan录像计划表Schema定义如下：4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册返回说明执行成功返回0，错误时返回错误码4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册9.3.3.3.12设置录像计划HRESULTSetRecordPlan(BSTRstrFDID,BSTRstrFDChannel,boolbCenter,BSTRstrPlan)功能描述设置录像计划。参数说明strFDID前端设备的代码编号，形如“200000000100011802”的字符串strFDChannel前端设备通道的代码编号，形如“0001”的字符串bCenter0(false)表示前端存储，1(true)表示中心存储strPlan录像计划表返回说明执行成功返回0，错误时返回错误码9.3.3.3.13读取版本信息HRESULTGetVersion(BSTR*strVersion)功能描述读取版本信息参数说明strVersion格式：W.X.Y.ZYYYY-MM-DD[版本文字描述可选]返回说明执行成功返回0，错误时返回错误码9.3.3.3.14获取最后一个错误HRESULTGetLastError(BSTR*strError)功能描述获取最后一个错误4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册参数说明strError错误的消息内容返回说明执行成功返回0，错误时返回错误码事件定义9.3.3.3.15连接服务器通知voidOnConnectServer(BSTRstrNewVersion,BSTRstrUpdateUrl)功能描述本接口接收连接服务器的成功信息。参数说明strNewVersion新版本信息：W.X.Y.ZYYYY-MM-DD[版本文字描述可选]strUpdateUrl升级URL地址9.3.3.3.16设备上线、下线通知voidOnFDStateChange(BSTRstrFDID,BSTRstrFDChannel,boolbState)功能描述本接口用于自动下传设备状态情况。参数说明strFDID前端设备的代码编号，形如“200000000100011802”的字符串strFDChannel前端设备通道的代码编号，形如“0001”的字符串bState0(false)表示设备下线，1(true)表示设备上线9.3.3.3.17开始监控响应消息VoidOnStarMonitor(BSTRstrRemoteIP,longlRemotePort,longlNetType,longlPacketType)功能描述4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册本接口用于返回开始监控的响应参数说明strRemoteIP远端IP地址lRemotePort远端IP端口lNetType0:UDP1:TCP2:MulticastlPacketType0:RTP1:TS9.3.3.3.18开始双向语音对讲响应消息VoidOnStarCall(BSTRstrRemoteIP,longlRemotePort,longlNetType,longlPacketType)功能描述本接口用于返回开始双向语音对讲的响应参数说明strRemoteIP远端IP地址lRemotePort远端IP端口lNetType0:UDP1:TCP2:MulticastlPacketType0:RTP1:TS9.3.3.3.19查询录像文件响应消息VoidOnQueryRecordFile(BSTRstrFile)功能描述本接口用于返回录像文件列表参数说明strFile查询到的文件注意：（返回结果应根据CU与平台的定义进行规范）4242中国电信集团公司 中国电信网络视频监控业务技术规范（V3.0）－客户端(CU)分册9.3.3.3.20告警消息VoidOnAlarmMessage(BSTRstrFDID,BSTRstrFDChannel,BSTRstrMessage,longlType,longlLevel)功能描述本接口用于接收设备发送的告警信息.参数说明strFDID前端设备的代码编号，形如“200000000100011802”的字符串strFDChannel前端设备通道的代码编号，形如“0001”的字符串strMessage告警内容lType告警类别lLevel告警级别4242中国电信集团公司'