中国电信网络视频监控业务技术规范V2-CU分册

1、中国电信网络视频监控业务技术规范 V2.0CU分册（送审稿）中国电信集团公司中国电信股份有限公司上海研究院2006年2月28日 中国电信网络视频监控业务技术规范CU分册内部资料，注意保密，未经同意，请勿翻印 文档信息文档名称文件编号编 制 人保密级别修改过程版 本 号日期作者概述评审过程版本号日期评审者概述分发范围CU分册（送审稿）I1.适用范围32.引用标准33.定义和缩略语34.系统结构35.CU客户端系统35.1 CU 概述35.2 CU 应用架构35.3 CU 应用分类45.4 CU 实现方式要求46.CU功能要求56.1电信客户端56.2企业客户端67.软件的要求107.1基本要求1

2、07.2软件设计要求118.接口协议118.1 接口通信协议结构118.1.1 Message Header:128.1.2Message:128.1.3Information Element(IE):138.1.4 IE结构的基本数据类型定义138.2 CU与 VTDU的通信协议148.3 集成应用二次开发接口规范248.3.1 接口规范目标248.3.2 接口原则248.3.3 接口规范251. 适用范围本规范主要适用于客户端子系统的规划设计以及功能定义。 2. 引用标准见中国电信网络视频监控业务技术规范-总体技术要求3. 定义和缩略语见中国电信网络视频监控业务技术规范-总体技术要求4.

3、系统结构见中国电信网络视频监控业务技术规范-总体技术要求5. CU客户端系统5.1 CU 概述CU是全球眼业务客户端监控应用系统的总称，是远程图像集中监控和维护管理的应用平台，实现客户向中心服务的认证、多画面监控、报警监控以及客户监控设备以及权限的远程维护等功能。5.2 CU 应用架构CU对前端设备的访问和控制都需要通过中心服务系统交互实现。CU和中心服务系统构成完整的服务器/客户应用架构，CU作为客户端应用。 5.3 CU 应用分类CU实现需提供两种客户端管理应用系统：1) 电信客户端 针对电信运维部门使用，提供设备维护（添加、删除、划归）、用户维护、权限分配、系统维护等功能。2) 企业客户

4、端针对电信全球眼业务客户使用，提供远程图象监控系统应用，包括提供电视墙应用解决方案。5.4 CU 实现方式要求1）跨操作系统平台的支持要求应用系统必须支持WINDOWS平台用户，建议支持LINUX平台用户。2）模块化设计 系统采用模块化的结构设计思想，将数据业务（视频数据、控制命令、报警数据）和应用逻辑（监控应用）分开。提供视频解码插件和报警采集模块以方便二次开发应用CU客户端系统解码插件报警模块VTDUCMSPUn 音视频控件音视频软解压控件是整个软件设计的核心，它嵌入在客户端应用软件中，应具备与中心服务（CMS/VTDU）或直接与PU的图像监控数据接收，图像显示、录像及云台控制，I/O监控

5、等基本功能，并须向用户提供统一编程接口。n 报警模块 开关量报警、移动侦测报警信号等的采集。3）支持C/S 、B/S两种电信/企业客户端应用系统电信CU客户端和企业CU客户端系统可以考虑提供C/S结构的胖客户端系统，也可以考虑基于WEB方式的客户端系统，基于WEB方式的客户端系统需要在中心服务端提供相应的WEB服务应用。6. CU功能要求用于浏览和控制远端视频及系统的设备。包括实时、历史音视频的解码播放、用户管理界面、业务开通和管理界面、系统维护界面、报警显示以及矩阵显示墙等。6.1电信客户端电信客户端是电信运维部门实施业务开通,设备管理以及权限管理的系统，为业务开展提供支持平台。1）设备管理

6、：n 监控设备的系统添加维护管理操作界面n 支持设备状态的查询，并提供系统设备（如前端）状态浏览、参数设置、初始化等操作界面n 支持平台间设备划归2）用户管理：n 用户组的维护，可以实现一个企业的多个用户为一个组n 负责客户用户的受理，使用情况的统计n 提供用户帐号、口令等控制界面n 提供多级区域、机构的设置界面3）权限设置：n 用户/用户组可访问的设备的列表信息维护n 用户/用户组相应的控制操作权限设置界面4）业务开通：n 提供开户、禁用/启用、注销等业务开通管理5）系统维护：n 系统日志管理n 对中心各功能服务运行状态的监控6）巡检与校时：n 定时对前端设备进行巡检，当设备有故障时（断线、

7、无视频），产生告警信息n 可以统一对系统中的设备进行校时7）平台注册：n 对有跨平台访问的平台的信息注册6.2企业客户端企业CU客户端是面向业务客户的集中监控应用系统。主要功能应：1）登录认证：提供登录验证界面，实现与CMS管理中心认证服务器的交互后进入系统。2）远程浏览：n 界面友好操作简单，经过管理中心服务器认证后，能自动以树形结构将浏览的前端设备和摄影头编排列出来，可以根据职能或业务或区域进行分组。同时结合手工自由点播，可以非常直观、方便的查看权限许可的实时或非实时画面n 支持1、4、6、9、16画面切换监控n 支持对音频的实时接收，可选择静音/打开音频n 支持多画面轮巡，即系统应具备视

8、频自动巡视功能，在可设定的间隔时间内对所有的监控点进行图像巡检，参与轮巡的对象可以任意设定，包括不同监控点的图像、同一监控点内不同摄像机、同一摄像机的不同预置位等，轮巡间隔时间可设置n 支持图象实时抓拍功能n 支持本地实时录象功能n 抓拍和录象路径可设置n 提供实时码率显示功能，显示与关闭提供开关操作2）提供电子地图功能n 支持多级电子地图（可选择矢量图、三维立体图或图片格式的地图）n 图片格式的地图的方式支持客户自动上载更新图片n 报警发生时，报警地点以醒目的标记闪烁在电子地图上，准确判断报警类型和地点2）远程控制n 云台控制（上、下、左、右），包括自动巡航，预制位、灯光/雨刷功能的支持n

9、三可变镜头远近、大小、聚焦调节n 摄象机色度、亮度、饱和度、对比度的实时控制3）报警信息的接收以及报警联动：n 支持报警信息的接收。报警信息经管理中心服务器转发，能够精确的将报警信息传送到客户机，同时具备语音、图像（画面弹出）的提示，并在本机生成报警日志，报警提示可根据设备一直发生作用，终止条件是操作人员人工进行干预n 报警类别，可能包括消防报警、防盗报警、防火报警、门禁报警、非法闯入及画面异动报警、图像设备故障报警以及通过温度、湿度探测器发出报警信息等n 支持红外、光敏报警，当发生报警时，监控中心能自动进行存盘录像，并自动在地理图上提示报警位置及类型n 当发生报警时，能联动相关设备，如启动现

10、场照明、警笛等，相关设备启动后，应在设定的时间内自动关闭，且现场照明在白天（时间段可设）可不打开n 报警信息应该和录像数据相结合，可由报警信息检索回放相应的图像录像n 支持报警信息的查询，并提供报警信息查询和浏览窗口n 支持开关量/移动侦测的布防、撤防的设置n 画面移动侦测报警的参数可设置n 支持联动策略的配置 （支持联动输出报警设备/灯光打开/录象开启）n 对移动目标具有自动跟踪功能，该功能应能随时启动关闭（可选）4）支持录象控制n 支持实时本地录象n 可设置录象存储方式（前端录象、中心录象、本地录象），并配置其IP地址n 录象的远程检索回放、下载本地回放5）远程操作：n 对指定的远端PU进

11、行远程操作，如PU的参数设置、通道参数的设置、串口参数的配置及报警参数的设置、查询n 视频画面要求可叠加反映该段视频时间、地点等信息的字幕，选择实现字母位置可调6）系统功能n 支持键盘快快捷键云台控制(建议)快捷键功能TAB焦点视频窗口切换空格焦点视频窗口最大化/回复切换方向键焦点摄像头云台转动Home/End焦点摄像头镜头放大/缩小F11全屏n 锁定系统功能“锁定系统”，就是将系统控制权限降为最低，使当前系统处于锁定状态，只提供最基本的监视功能，包括禁用关闭系统。“解除锁定”选项是指，在锁定系统后，要重新恢复对系统的控制权，必须首先解除锁定。n 系统日志支持系统日志的查询，并提供当前系统日志

12、的查询和浏览窗口。7）辅助功能(可选)n 操作杆功能n 辅助键盘控制8）电视墙的控制（可选）电视墙是由多个监视器组成的，每个监视器对应一路视频输出（比如对应一个解码器的视频输出），这些关系是固定的。可以从PU列表中把某个PU拖到电视墙上，并能对这个PU的图像控制，如开始播放和停止播放；还可以控制该PU的云镜。支持手动调看、序列切换、群组序列调看、群组序列切换功能：n 通过中文名称列表方式或电子地图图标方式手动在任意监视器上切换系统中任一个摄像机图像n 在任一个监视器上调用任一个序列进行自动切换显示n 在多个监视器一次性同时调看任一个编组序列的所有摄像机图像n 将多个编组序列同时在多个监视器上进

13、行群组的自动切换显示n 切换间隔时间可调（8-99秒）9）与PU双向语音交流能与自己权限许可的前端设备之间进行双向的实时语音对讲，同时具有对前端设备分组进行语音广播。10）多画面合成的控制（可选）支持对用户选择的多个PU视频流合成包括多个画面的一路视频流。11）解码器/解码矩阵的管理功能（可选）n 对中心一个或多个解码器/解码矩阵的配置管理；其IP地址、通道数、每个通道对应的默认的显示图象的IP地址、通道号配置信息的存储n 每个解码器通道对应的电视墙信息的存储n 每个监视器可显示多个通道的信息（IP）配置管理n 是否轮跳配置管理。轮跳策略n 可设定每个解码器/解码矩阵报警时输出图象的通道；当收

14、到报警联动输出信息时将指定图象在设定的通道输出n 可设定每个解码器/解码矩阵音频的通道选择和控制 n 将网络中任意若干个摄像机编组成若干个切换序列12）客户自助管理可由客户管理员自助进行相应的管理如，配置管理、权限管理、操作员管理、告警管理、日志管理等。13）图像辨识功能通过图像辨识处理实现行业的智能辨识需要，如交通系统和交警系统需要的车牌辨识功能。7. 软件的要求7.1基本要求1)要求软件采用分层的模块化结构，模块之间的通信应按规定接口进行。任何一层的任何一个模块的维护和更新以及新模块的追加都不影响其它模块。2)系统参数、用户资料与处理程序应有相对的独立性。用户资料的任何变更都不应引起运行版

15、本程序的变更。处理程序应与系统参数、用户资料相适应。3)软件应有容错能力，一般的软件故障不应引起各类严重的系统再激活。4)软件设计应有防护性能，某一软件模块内的软件错误应限制在本模块内，而不应造成其它软件模块的错误。5)应具有软件运行故障的监视功能。一旦软件出现死循环等重大故障，应能自动再激活，并能出实时故障报告信息。6)系统中所有涉及到时间的信息和资料其年份部分采用带纪元表示法。7)软件具有详细、完善、灵活的业务、用户等资料的统计、分析、预测能力。8)系统中使用的协议不出现在互联网中目前不支持的协议现象。7.2软件设计要求 1) 应用软件应采用分层次的体系结构，以便于系统的维护和扩展；2)

16、应用软件应能根据用户规模的不同支持集中处理模式和分布式处理；3) 应用软件应具有很好的开放性，以便于与其它应用系统的连接；系统应提供完整的二次开发工具及使用说明，便于进行客户化工作；4) 应用软件应具有很好的可移植性，支持多种操作系统，并能移植到不同厂家的硬件平台上运行；5) 应用软件应能适应多种大型数据库系统，例如 MS SQL, Oracle、Sybase 等；6) 系统的运行应是安全、可靠的，具备完善的、分级的操作/访问权限控制；7) 系统应具有资料备份及灾难恢复功能。8. 接口协议8.1 接口通信协议结构8.1.1 Message Header:字段名长度(BYTE)描述0xFFFF2

17、消息包标志位Version 2协议版本号：前为大版本、后为小版本Message Type 2消息类型ENUM_MSG_TYPEMessage Length 2整个消息包长度，不包含MessageType和MessageLength域Sequence Number 2包序号（从启动开始依次递增，请求与响应保持一致；到达极限后归零重新开始）Session_ID4会话ID（通过PuId、UserId应该能够查询到会话Session ID）Source_ID 15通讯源设备/用户ID，编号规则见系统编码部分。Destination_ID 15通讯目的设备/用户ID，编号规则见系统编码部分。Reserv

18、ed 4保留字段Authenticator4对整个数据包的完整性校验值，采用crc32的算法来计算校验值.（Message Type + Message Length+ Version + Sequence NumberSession ID Source CMSIDSource IDDestination ID + Reserved + IE信息+）8.1.2Message:Message HeaderIEIE.消息格式：1. 每个消息由一个消息头与0个（允许为空）或多个IE组成。IE，即Information Element 信息单元。2. 以上提到的多字节数据均以小边模式存放(先低字节后高

19、字节)。字段名长度(BYTE)描述Message Header 56消息包头，见下面Message Header定义Information Element*信息单元Information Element*信息单元信息单元8.1.3Information Element(IE):字段名长度(BYTE)描述IE Type2IE类型ENUM_IE_TYPEIE Length2IE长度，包含IE Type和IE Length域IE Content*根据具体IE Type不同8.1.4 IE结构的基本数据类型定义ie结构由基本的数据类型定义，描述如下：字段类型长度(byte)描述BYTE1单字节WORD

20、2双字节DWORD4四字节char协议具体指定定长字符串，0不表示结束符nchar协议具体指定带长度的不定长字符串, 0表示结束nchar表示如下：如果字符串长度小于255，起始第一个字节为字符串长度；如果字符串长度大于等于255，起始第一个字节为特殊标记0xff，后续三个字节为实际长度；字符串最大长度为65535字节。实际有效字符串可能是以下两种情况1最后一个字节是0，则以第一个出现的0表示结束符，尾部必须全填0;2最后一个字节非0，则以前导长度为准;不做要求8.2 CU与 VTDU的通信协议8.2.1接口定义对象CU 与VTDU接口规范的对象主要：n 音视频数据流格式n 音视频数据请求/响

21、应消息格式8.2.2音视频数据流格式媒体封装格式 报头标志2bytes13bytesVariableFLAGMediaStreamHeaderMediaBuf说明：（1）FLAG=0xfffe 代表媒体音视频数据包；FLAG=0xfffd 代表媒体信令包；媒体头字节总数：15字节。（2）在传输实时视频流时，需要在每一帧的多媒体数据前加一个视频流头，格式如下：MediaStreamHeader（13字节）1bytes2bytes2bytes4bytes4bytes （Flag1）（Flag2）PacketLengthPacketSequenceSessionID PacketLength：整个包

22、的大小（包括头部）。PacketLength14净荷长度；Flag1: MediaType:b7b6表示该包内的媒体类型。00：视频 01：音频 10：音视频；I/B/P: b1b0表示当前数据包所在的帧类型。I: 01, B:10, P:11。对于没有区分的填0。其余各位保留位；Flag2:保留字节(2)；高字节：厂家代号，低字节：该厂家的播放器版本号；这2个字节必须是中国电信统一派发并登记才能识别和实现互相访问；PacketSequence：包的序列号。2个字节，每经网络发送一次加1，达到最大值65535后重新从0开始计数；SessionID: SessionID获取连接的相关信息，由前端

23、设备连接CMS时分派。（3）MediaBuf：音视频数据包的净荷数据，其中的格式由不同按照优化能在中国电信宽带网的网络中进行高效传输。在传输实时视频流时，需要在每一帧的多媒体数据前加这里统一定义的视频流头格式。其中的净荷数据是各个厂家具体的视音频传输协议。8.2.3 视频数据流传输方式8.2.3.1 UDP单播传输方式当采用UDP 单播方式传输时，VTDU/CU直接发送UDP单播通信端口查询消息，PU将UDP单播地址和端口发给VTDU/CU（客户端），或者由CMS将查询的端口直接返回给VTDU/CU。收到该消息后，向该端口发送单播请求消息。该方式数据实时性强，但数据传输的可靠性没有保证，存在网

24、络丢包的可能，适合在局域网环境下使用。客户端（VTDU）服务器端（PU）1 单播视频请求2 请求回应ACK2 音视频数据8.2.3.2 UDP组播传输方式： 当采用UDP 组播方式传输时，PU将数据向一个组播地址传送。VTDU组播端口请求时，返回信息中包含组播地址和端口，当收到这个组播地址和端口号后，VTDU发送组播请求，加入组播地址收取视频数据。组播地址和端口在PU上可配置或按照最后两位地址默认为设备IP地址的最后两位。组播方式在多个相同视频通道的请求时可以有效节约带宽，它是基于UDP，存在网络丢包问题。客户端（VTDU）服务器端（PU）1 组拨视频请求2 请求回应ACK（包含组播地址和端口

25、）组播组发送音视频数据收音视频数据3 加入组播组8.2.3.3 TCP传输方式TCP传输方式是一种可靠的传输方式，采用这种方式主要使用长连接模式。这种传输方式不存在网络丢包的可能。客户端（VTDU）服务器端（PU）1 TCP视频请求2 请求回应ACK2 音视频数据8.2.3.4 RTP/RTCP传输方式实时传输协议（Real-time Transport Protocol，PRT）是在Internet上处理多媒体数据流的一种网络协议，利用它能够在一对一（unicast，单播）或者一对多（multicast，多播）的网络环境中实现传流媒体数据的实时传输，RTP和RTCP结合使用，为按序传输数据包

26、提供可靠的保证以及提供流量控制和拥塞控制。客户端（VTDU）服务器端（PU）1 RTP视频请求建立RTP会话2 请求回应ACK2 音视频数据8.2.4 通信方式客户与服务器对应关系 ：客户端服务器端VTDVPUCUPUCUVTDU服务器端各项服务默认消息端口定义（待讨论）端口号应用7000UDP（单播）数据请求服务端口7001UDP（组播）数据请求服务端口8000TCP 数据请求服务端口9000RTP 数据请求服务端口8.2.5视频请求消息接口8.2.5.1消息流 主要消息流：客户端服务器端1 视频请求2 请求回应ACK3 握手请求4 握手回应5 关闭连接2 音视频数据8.2.5.2视频数据请

27、求消息Message Type: MSG_START_VIDEO_REQDirection: CU à VTDUIEM/O描述IE_OPEN_VIDEOMIE_NETLINKO简要描述：客户端向服务器（PU/VTDU）发送的请求音视频数据的请求，服务器接受到该请求后，维护用户表信息，并发送目前编码设备的一些关键编解码配置给客户端，然后发送音视频数据流到客户端。打开视频IE_OPEN_VIDEO 字段名类型长度描述TypeWORD2BIE_OPEN_VIDEOLengthWORD2B该IE类型的结构长度PUIDChar15设备IDChannelNoWORD2音视频数据源所在的通道号Me

28、idaTypeBYTE1媒体数据类型0：音频数据1：视频数据2：音频视频数据TransModeBYTE1请求PU对音视频数据的传输方式0： TCP1： UDP 单播2： 组播3:： RTP.ReqReasonBYTE1请求音视频数据的原因0：一般的请求1：因报警请求.网络连接 IE_NETLINK字段名类型长度（B）描述TypeWORD2= IE_NETLINK（301）LengthWORD2该IE类型的结构长度AddTypeBYTE1IPV4=1; IPV6=2;DN=3AddRESPsnChar地址可为IP或DNPortWORD2端口ConnectTypeBYTE1网络接入连接方式：1公网

29、/0私网TransTypeBYTE1视频数据传输方式 1：TCP 2：UDP 3：RTP 4：Multicast（多播地址和端口在视频通道参数IE里头指定）8.2.5.3视频请求回应消息Message Type: MSG_START_VIDEO_ACKDirection：PUà VTDU，PUà CU， VTDU àCUIEM/O描述IE_OPEN_ VIDEO _ ACKM音视频请求回应简要描述：对MSG_START_VIDEO_REQ 的回应，主要是发送音视频流头信息到客户端解码插件；打开视频响应IE_OPEN_VIDEO_ACK 字段名类型长度（B）描述Ty

30、peWORD2= IE_OPEN_VIDEO_ACKLengthWORD2该IE类型的结构长度MeidiaTypeBYTE1媒体数据类型0：音频数据1：视频数据2：音频视频数据VidEncodeBYTE1视频编码算法0：MPEG-41：MPEG-22：MPEG-13：H.2634：MPEG-43：H.264.VidWidthWORD2视频数据象素宽度VidHightWORD2视频数据象素高度VidFormatBYTE1视频制式0：PAL1：NTSCVidFrameRateBYTE1视频输出具体帧数（PAL制式0-25，NTSC制式0-30）AudEncodeBYTE音频编码算法0：MPEG1

31、L21：u-Law PCM2：ADPCM音频编码算法0：MPEG1 L21：u-Law PCM2：ADPCMAudSampingBYTE1音频采样频率（采样频率根据音频编码算法的不同，其值的含义也有不同解释）。u-Law PCM与ADPCM编码算法：0：8KHZ1：48KHZAudBitRateBYTE1s音频输出Bit率（根据不同的音频编码算法，取值的含义不同）。u-Law PCM 编码算法：0：64KbpsADPCM编码算法：0：32KbpsAudTrackBYTE1音频声道模式0：立体声1：单声道DeviceTypeIndexWORD2唯一设备类型索引码，用于解码器调用，索引码需向中国电

32、信申请。8.2.5.4 音视频数据传输Message Type: MSG_OPEN_DATADirection：PUà VTDU，PUà CU， VTDU àCUIEM/O描述IE_OPEN_DATAM视频数据流简要描述：传输媒体数据到到客户端的消息。8.2.5.5关闭连接消息Message Type: MSG_STOP_VIDEO_REQIEM/O描述IE_STOP_VIDEOM音视频数据关闭简要描述：客户端CLIENT向服务端发出的关闭音视频的请求，服务端收到该请求后，会修改相应的用户表信息；传输方向：VTDU à PU， CU à PU，

33、 CU à VTDU关闭视频IE_STOP_VIDEO字段名类型长度描述TypeWORD2BIE_STOP_VIDEOLengthWORD2B该IE类型的结构长度ChannelNoWORD1音视频数据源所在的通道号MeidaTypeBYTE1媒体数据类型0：音频数据1：视频数据2：音频视频数据8.2.5.6客户端向服务端的握手消息Message Type: MSG_CLINET_SERVER_ HANDSHKDirection：CU à VTDUIEM/O描述无M简要描述：CLIENT端应用或控件发给服务器的握手消息。主要用于维持CLIENT与服务器之间的UDP链路。CLI

34、ENT每隔N秒向服务器的服务程序发送该消息。RTMS在 >= M秒后没有受到该消息的时候，就认为CLIENT已经down掉，将其从用户表中删除，再不向其发送图像数据。一般地N10，M30。8.2.5.7服务端向客户端握手消息Message Type: MSG_ SERVER _ CLINET _ HANDSHKDirection：VTDUà CUIEM/O描述IE_OPEN_ VIDEO _ ACKM简要描述：服务端发回给客户端(控件)的握手消息。当服务端接收到MSG_CLINET_SERVER_ HANDSHK之后，回应给对应CLIENT的握手消息。CLIENT收到该消息后表

35、示网络和服务端程序都正常，如果没有受到该消息，则表示网络不通或服务端程序出错。消息格式：消息格式与MSG_START_VIDEO_ACK消息的消息体相同8.3 集成应用二次开发接口规范8.3.1 接口规范目标 通过视频解码模块接口标准化，可以提供二次开发接口外，可以使得应用开发接口标准化，最终可以达到插件的标准化统一化。8.3.2 接口原则 插件封装CU与VTDU音视频数据请求和回应接口；同时可以封装CU预CMS的控制命令接口。 接口使对外提供调用的方法，使用的属性以及事件。8.3.3 接口规范1）方法接口CreateInstance描 述：本方法初始化控件。语 法：Object. Creat

36、eInstance ()返 回 值：数据类型BOOL值描述TRUE表示初始化成功FALSE表示初始化失败说 明：本方法应该在所有的方法调用之前被调用。如果本方法没有调用，那么其他方法调用都会失败。Login描 述：本方法用于用户登录CMS中心服务器。只有成功登录后，系统的其他功能才能使用。本方法会激活OnLogin事件通知。语 法：Object. Login(String ipaddress, String port, String email, String password)返 回 值：数据类型BOOL值描述TRUE连接成功FALSE连接失败说 明：ipaddress：为CMS中心服务器I

37、P地址，输入参数，为形如“60.191.58.158”的字符串port: 为CMS中心服务器端口，输入参数，为形如“80”的字符串email: 为用户登录系统的帐号，输入参数，是一个email形式的字符串password：为用户登录系统的密码，输入参数，是一个形如“123456”形式的字符串StartLiveVideo描 述：本方法用于用户实时监控请求的发送。本方法请求成功后，会在目的窗口播放实时视频。语 法：Object. StartLiveVideo(String FDID,long hWnd) 返 回 值：数据类型BOOL值描述TRUE请求成功FALSE请求失败说 明：FDID：为摄像机

38、代码编号，输入参数，为形如“2000001000118020001”的字符串hWnd：为图像播放的目的窗口句柄，输入参数StopLiveVideo描 述：本接口用于停止某摄像机的实时监控语 法：Object. StopLiveVideo( String FDID) 参数说明：FDID：String摄像机的代码编号，输入参数，为形如“2000000001000118020001”的字符串返 回 值：数据类型BOOL值描述TRUE关闭成功FALSE参数错误或者请求发送失败SendPtzCommand描 述：本接口用于云台控制命令下发语 法：Object. SendPtzCommand(String

39、 FDID ， long commandCode, long param ) 参数说明：FDID：String摄像机的代码编号，输入参数，为形如“2000000001000118020001”的字符串commandCode：命令参数字，输入参数，主要有以下的几个：LENS_UP=0x01,/向上转LENS_LEFT=0x02,/向左转LENS_ROTATE=0x03,/旋转LENS_RIGHT=0x04,/向右转LENS_DOWN=0x05,/向下转LENS_FAR=0x06,/镜头拉远LENS_FOCUSNEAR=0x07,/聚焦LENS_AUTO=0x08,/自动LENS_FOCUSFAR

40、=0x09,/散焦LENS_NEAR=0x0A,/镜头拉近LENS_DIAPHRAGM_LARGE=0x0B,/光圈增大（变亮）LENS_DIAPHRAGM_SMALL=0x0C,/光圈减小（变暗）LENS_STOP=0x0D,/停止动作LENS_SPEAKER_ON=0x0E,/打开喇叭LENS_LIGHT_ON=0x0F,/打开灯光LENS_HOTDOG=0x10,/热狗扫描LENS_SPEAKER_OFF=0x11,/关闭喇叭LENS_LIGHT_OFF=0x12,/关闭灯光LENS_PRESET_GOTO=0x13,/切换到预置点LENS_PRESET_SET=0x14,/设置预置点L

41、ENS_PRESET_DEL=0x15,/删除预置点LENS_PRESET_CLEAR=0x1E,/清除所有预置点LENS_CAMERA_RESET=0x16,/摄像机复位LENS_AUTOCRUISE=0x1D,/自动巡航LENS_STARTTRACKING=0x1F,/启动跟踪LENS_STOPTRACKING=0x20,/停止跟踪LENS_CAMERAACTIVE=0x28,/摄像机激活LENS_SETPANSPEED=0x29,/设置左右转动速度LENS_SETTILTSPEED=0x30,/设置上下转动速度LENS_SETZOOMSPEED=0x31,/设置光圈速度 .LENS_SE

42、TFOCUSSPEED=0x32,/设置聚焦/散焦速度LENS_SPEEDSETTINGGET=0x33,/获取摄像机速度LENS_MATRIXSWITCH=0x40,/矩阵切换param：为一些需要参数配合命令提供参数，输入参数。对于上下左右转动等命令来说，本参数提供速度数值。速度的值变化范围在17之间。返 回 值：数据类型BOOL值描述TRUE请求成功FALSE请求发送失败ReqVideoURL描 述：本接口用于用户回放录像前进行的录像索引的查询。如果查询结果没有录像索引，那么就不能进行图像的回放。该接口会激活OnVideoURL事件，通过这个事件来告知最后服务器动作成功与否语 法：Obj

43、ect. ReqVideoURL (String FDID, String StartTime, String EndTime ) 参数说明：FDID：String摄像机的代码编号，输入参数，为形如“2000000001000118020001”的字符串StartTime：查询录像的开始时间字符串，输入参数，为形如“2005-01-01 01:01:01”的字符串EndTime：查询录像的结束时间字符串，输入参数，为形如“2005-01-01 01:01:01”的字符串返 回 值：数据类型BOOL值描述TRUE请求成功FALSE请求发送失败GetFDList描 述：本接口返回摄像机代码列表。本

44、接口只有在OnLogin事件返回响应成功后，调用得到的结果才是有效的语 法：Object. GetFDList () 参数说明：无输入输出参数返 回 值：返回的是摄像机代码字符串列表，只有事件激活告知成功后，本接口的获取数据列表才是有意义的。 CaptureAsBmp描 述：对当前连接的前端设备进行抓拍语 法：Object.CaptureAsBmp (String savePath) 参数说明：savePath：String抓拍文件的存放路径返 回 值：数据类型String，抓拍的文件名 IsActive描 述：查询当前是否连接语 法：Object.IsActive ()返 回 值：数据类型B

45、OOL值描述TRUE已连接FALSE没有连接IsRecording描 述：查询当前是否正在录像语 法：Object.IsRecording (String FDID) 返 回 值：数据类型BOOL值描述TRUE正在录像FALSE没有录像OverlayText描 述：在图像监视窗口中指定位置显示文本语 法：Object.OverlayText (id, pointX, ointy, colorRGB, text) 参数说明：id:Short该组文本的组号，范围（0-3）共4组pointX:Long 在窗口中的位置的X坐标（以像素为单位）ointy:Long 在窗口中的位置的Y坐标（以像素为单位）colorRGB:OLE_COLOR显示文本的颜色属性（B/G/R分量）text:string指向文本内容的指针,最长不能超过100字返 回 值：数据类型BOOL值描述TRUE设置成功FALSE设置失败说 明：