中国电信网络视频监控业务技术规范分册样本.doc

中国电信网络视频监控业务
技术规范 V2.0
CU分册（送审稿）

中国电信集团企业
中国电信股份上海研究院
2月28日
内部资料，注意保密，未经同意，请勿翻印
文档信息
文档名称

文件编号

编 制 人

保密等级

修改过程
版 本 号
日期
作者
概述

评审过程
版本号
日期
评审者
概述

分发范围

CU分册（送审稿） I
1. 适用范围 3
2. 引用标准 3
3. 定义和缩略语 3
4. 系统结构 3
5. CU用户端系统 3
5.1 CU 概述 3
5.2 CU 应用架构 3
5.3 CU 应用分类 4
5.4 CU 实现方法要求 4
6. CU功效要求 5
6.1电信用户端 5
6.2企业用户端 6
7. 软件要求 10
7.1基础要求 10
7.2软件设计要求 11
8. 接口协议 11
8.1 接口通信协议结构 11
8.1.1 Message Header: 12
8.1.2Message: 12
8.1.3Information Element(IE): 13
8.1.4 IE结构基础数据类型定义 13
8.2 CU和 VTDU通信协议 14
8.3 集成应用二次开发接口规范 24
8.3.1 接口规范目标 24
8.3.2 接口标准 24
8.3.3 接口规范 25

1. 适用范围
本规范关键适适用于用户端子系统计划设计和功效定义。
2. 引用标准
见《中国电信网络视频监控业务技术规范-总体技术要求》
3. 定义和缩略语
见《中国电信网络视频监控业务技术规范-总体技术要求》
4. 系统结构
见《中国电信网络视频监控业务技术规范-总体技术要求》
5. CU用户端系统
5.1 CU 概述
CU是全球眼业务用户端监控应用系统总称，是远程图像集中监控和维护管理应用平台，实现用户向中心服务认证、多画面监控、报警监控和用户监控设备和权限远程维护等功效。
5.2 CU 应用架构
CU对前端设备访问和控制全部需要经过中心服务系统交互实现。CU和中心服务系统组成完整服务器/用户应用架构，CU作为用户端应用。

5.3 CU 应用分类
CU实现需提供两种用户端管理应用系统：
1) 电信用户端
针对电信运维部门使用，提供设备维护（添加、删除、划归）、用户维护、权限分配、系统维护等功效。
2) 企业用户端
针对电信全球眼业务用户使用，提供远程图象监控系统应用，包含提供电视墙应用处理方案。
5.4 CU 实现方法要求
1）跨操作系统平台支持
要求应用系统必需支持WINDOWS平台用户，提议支持LINUX平台用户。
2）模块化设计
系统采取模块化结构设计思想，将数据业务（视频数据、控制命令、报警数据）和应用逻辑（监控应用）分开。提供视频解码插件和报警采集模块以方便二次开发应用CU用户端系统
解码插件
报警模块
VTDU
CMS
PU

n 音视频控件
音视频软解压控件是整个软件设计关键，它嵌入在用户端应用软件中，应含有和中心服务（CMS/VTDU）或直接和PU图像监控数据接收，图像显示、录像及云台控制，I/O监控等基础功效，并须向用户提供统一编程接口。
n 报警模块
开关量报警、移动侦测报警信号等采集。
3）支持C/S 、B/S两种电信/企业用户端应用系统
电信CU用户端和企业CU用户端系统能够考虑提供C/S结构胖用户端系统，也能够考虑基于WEB方法用户端系统，基于WEB方法用户端系统需要在中心服务端提供对应WEB服务应用。
6. CU功效要求
用于浏览和控制远端视频及系统设备。包含实时、历史音视频解码播放、用户管理界面、业务开通和管理界面、系统维护界面、报警显示和矩阵显示墙等。
6.1电信用户端
电信用户端是电信运维部门实施业务开通,设备管理和权限管理系统，为业务开展提供支持平台。
1）设备管理：
n 监控设备系统添加维护管理操作界面
n 支持设备状态查询，并提供系统设备（如前端）状态浏览、参数设置、初始化等操作界面
n 支持平台间设备划归
2）用户管理：
n 用户组维护，能够实现一个企业多个用户为一个组
n 负责用户用户受理，使用情况统计
n 提供用户帐号、口令等控制界面
n 提供多级区域、机构设置界面
3）权限设置：
n 用户/用户组可访问设备列表信息维护
n 用户/用户组对应控制操作权限设置界面
4）业务开通：
n 提供开户、禁用/启用、注销等业务开通管理
5）系统维护：
n 系统日志管理
n 对中心各功效服务运行状态监控
6）巡检和校时：
n 定时对前端设备进行巡检，当设备有故障时（断线、无视频），产生告警信息
n 能够统一对系统中设备进行校时
7）平台注册：
n 对有跨平台访问平台信息注册
6.2企业用户端
企业CU用户端是面向业务用户集中监控应用系统。关键功效应：
1）登录认证：
提供登录验证界面，实现和CMS管理中心认证服务器交互后进入系统。
2）远程浏览：
n 界面友好操作简单，经过管理中心服务器认证后，能自动以树形结构将浏览前端设备和摄影头编排列出来，能够依据职能或业务或区域进行分组。同时结合手工自由点播，能够很直观、方便查看权限许可实时或非实时画面
n 支持1、4、6、9、16画面切换监控
n 支持对音频实时接收，可选择静音/打开音频
n 支持多画面轮巡，即系统应含有视频自动巡视功效，在可设定间隔时间内对全部监控点进行图像巡检，参与轮巡对象能够任意设定，包含不一样监控点图像、同一监控点内不一样摄像机、同一摄像机不一样预置位等，轮巡间隔时间可设置
n 支持图象实时抓拍功效
n 支持当地实时录象功效
n 抓拍和录象路径可设置
n 提供实时码率显示功效，显示和关闭提供开关操作
2）提供电子地图功效
n 支持多级电子地图（可选择矢量图、三维立体图或图片格式地图）
n 图片格式地图方法支持用户自动上载更新图片
n 报警发生时，报警地点以醒目标标识闪烁在电子地图上，正确判定报警类型和地点
2）远程控制
n 云台控制（上、下、左、右），包含自动巡航，预制位、灯光/雨刷功效支持
n 三可变镜头远近、大小、聚焦调整
n 摄象机色度、亮度、饱和度、对比度实时控制
3）报警信息接收和报警联动：
n 支持报警信息接收。报警信息经管理中心服务器转发，能够正确将报警信息传送到用户机，同时含有语音、图像（画面弹出）提醒，并在本机生成报警日志，报警提醒可依据设备一直发生作用，终止条件是操作人员人工进行干预
n 报警类别，可能包含消防报警、防盗报警、防火报警、门禁报警、非法闯进及画面异动报警、图像设备故障报警和经过温度、湿度探测器发出报警信息等
n 支持红外、光敏报警，当发生报警时，监控中心能自动进行存盘录像，并自动在地理图上提醒报警位置及类型
n 当发生报警时，能联动相关设备，如开启现场照明、警笛等，相关设备开启后，应在设定时间内自动关闭，且现场照明在白天（时间段可设）可不打开
n 报警信息应该和录像数据相结合，可由报警信息检索回放对应图像录像
n 支持报警信息查询，并提供报警信息查询和浏览窗口
n 支持开关量/移动侦测布防、撤防设置
n 画面移动侦测报警参数可设置
n 支持联动策略配置 （支持联动输出报警设备/灯光打开/录象开启）
n 对移动目标含有自动跟踪功效，该功效应能随时开启关闭（可选）
4）支持录象控制
n 支持实时当地录象
n 可设置录象存放方法（前端录象、中心录象、当地录象），并配置其IP地址
n 录象远程检索回放、下载当地回放
5）远程操作：
n 对指定远端PU进行远程操作，如PU参数设置、通道参数设置、串口参数配置及报警参数设置、查询
n 视频画面要求可叠加反应该段视频时间、地点等信息字幕，选择实现字母位置可调
6）系统功效
n 支持键盘快快捷键云台控制(提议)
快捷键
功效
TAB
焦点视频窗口切换
空格
焦点视频窗口最大化/回复切换
方向键
焦点摄像头云台转动
Home/End
焦点摄像头镜头放大/缩小
F11
全屏
n 锁定系统功效
“锁定系统”，就是将系统控制权限降为最低，使目前系统处于锁定状态，只提供最基础监视功效，包含禁用关闭系统。
“解除锁定”选项是指，在锁定系统后，要重新恢复对系统控制权，必需首先解除锁定。
n 系统日志
支持系统日志查询，并提供目前系统日志查询和浏览窗口。
7）辅助功效(可选)
n 操作杆功效
n 辅助键盘控制
8）电视墙控制（可选）
电视墙是由多个监视器组成，每个监视器对应一路视频输出（比如对应一个解码器视频输出），这些关系是固定。能够从PU列表中把某个PU拖到电视墙上，并能对这个PU图像控制，如开始播放和停止播放；还能够控制该PU云镜。
支持手动调看、序列切换、群组序列调看、群组序列切换功效：
n 经过汉字名称列表方法或电子地图图标方法手动在任意监视器上切换系统中任一个摄像机图像
n 在任一个监视器上调用任一个序列进行自动切换显示
n 在多个监视器一次性同时调看任一个编组序列全部摄像机图像
n 将多个编组序列同时在多个监视器上进行群组自动切换显示
n 切换间隔时间可调（8-99秒）
9）和PU双向语音交流
能和自己权限许可前端设备之间进行双向实时语音对讲，同时含有对前端设备分组进行语音广播。
10）多画面合成控制（可选）
支持对用户选择多个PU视频流合成包含多个画面一路视频流。
11）解码器/解码矩阵管理功效（可选）
n 对中心一个或多个解码器/解码矩阵配置管理；其IP地址、通道数、每个通道对应默认显示图象IP地址、通道号配置信息存放
n 每个解码器通道对应电视墙信息存放
n 每个监视器可显示多个通道信息（IP）配置管理
n 是否轮跳配置管理。轮跳策略
n 可设定每个解码器/解码矩阵报警时输出图象通道；当收到报警联动输出信息时将指定图象在设定通道输出
n 可设定每个解码器/解码矩阵音频通道选择和控制
n 将网络中任意若干个摄像机编组成若干个切换序列
12）用户自助管理
可由用户管理员自助进行对应管理如，配置管理、权限管理、操作员管理、告警管理、日志管理等。
13）图像辨识功效
经过图像辨识处理实现行业智能辨识需要，如交通系统和交警系统需要车牌辨识功效。
7. 软件要求
7.1基础要求
1) 要求软件采取分层模块化结构，模块之间通信应按要求接口进行。任何一层任何一个模块维护和更新和新模块追加全部不影响其它模块。
2) 系统参数、用户资料和处理程序应有相正确独立性。用户资料任何变更全部不应引发运行版本程序变更。处理程序应和系统参数、用户资料相适应。
3) 软件应有容错能力，通常软件故障不应引发各类严重系统再激活。
4) 软件设计应有防护性能，某一软件模块内软件错误应限制在本模块内，而不应造成其它软件模块错误。
5) 应含有软件运行故障监视功效。一旦软件出现死循环等重大故障，应能自动再激活，并能出实时故障汇报信息。
6) 系统中全部包含到时间信息和资料其年份部分采取带纪元表示法。
7) 软件含有具体、完善、灵活业务、用户等资料统计、分析、估计能力。
8) 系统中使用协议不出现在互联网中现在不支持协议现象。
7.2软件设计要求
1) 应用软件应采取分层次体系结构，方便于系统维护和扩展；
2) 应用软件应能依据用户规模不一样支持集中处理模式和分布式处理；
3) 应用软件应含有很好开放性，方便于和其它应用系统连接；系统应提供完整二次开发工具及使用说明，便于进行用户化工作；
4) 应用软件应含有很好可移植性，支持多个操作系统，并能移植到不一样厂家硬件平台上运行；
5) 应用软件应能适应多个大型数据库系统，比如 MS SQL, Oracle、Sybase 等；
6) 系统运行应是安全、可靠，含有完善、分级操作/访问权限控制；
7) 系统应含有资料备份及灾难恢复功效。
8. 接口协议
8.1 接口通信协议结构
8.1.1 Message Header:
字段名
长度(BYTE)
描述
0xFFFF
2
消息包标志位
Version
2
协议版本号：前为大版本、后为小版本
Message Type
2
消息类型ENUM_MSG_TYPE
Message Length
2
整个消息包长度，不包含MessageType和MessageLength域
Sequence Number
2
包序号（从开启开始依次递增，请求和响应保持一致；抵达极限后归零重新开始）
Session_ID
4
会话ID（经过PuId、UserId应该能够查询到会话Session ID）
Source_ID
15
通讯源设备/用户ID，编号规则见《系统编码部分》。
Destination_ID
15
通讯目标设备/用户ID，编号规则见《系统编码部分》。
Reserved
4
保留字段
Authenticator
4
对整个数据包完整性校验值，采取crc32算法来计算校验值.
（Message Type + Message Length+ Version + Sequence Number＋Session ID ＋Source CMSID＋Source ID＋Destination ID + Reserved + IE信息+……）

8.1.2Message:
Message Header
IE
IE
.
消息格式：

1. 每个消息由一个消息头和0个（许可为空）或多个IE组成。IE，即Information Element 信息单元。
2. 以上提到多字节数据均以小边模式存放(先低字节后高字节)。

字段名
长度(BYTE)
描述
Message Header
56
消息包头，见下面Message Header定义
Information Element
*
信息单元
Information Element
*
信息单元
……

信息单元
8.1.3Information Element(IE):
字段名
长度(BYTE)
描述
IE Type
2
IE类型ENUM_IE_TYPE
IE Length
2
IE长度，包含IE Type和IE Length域
IE Content
*
依据具体IE Type不一样

8.1.4 IE结构基础数据类型定义
ie结构由基础数据类型定义，描述以下：

字段类型
长度(byte)
描述
BYTE
1
单字节
WORD
2
双字节
DWORD
4
四字节
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 音视频数据请求/响应消息格式
8.2.2音视频数据流格式
媒体封装格式

报头标志2bytes
13bytes
Variable
FLAG
MediaStreamHeader
MediaBuf

说明：
（1）FLAG=0xfffe 代表媒体音视频数据包；
FLAG=0xfffd 代表媒体信令包；
媒体头字节总数：15字节。
（2）在传输实时视频流时，需要在每一帧多媒体数据前加一个视频流头，格式以下：MediaStreamHeader（13字节）
1bytes
2bytes
2bytes
4bytes
4bytes
（Flag1）
（Flag2）
PacketLength
PacketSequence
SessionID
PacketLength：整个包大小（包含头部）。PacketLength＝14＋净荷长度；
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获取连接相关信息，由前端设备连接CMS时分配。
（3）MediaBuf：音视频数据包净荷数据，其中格式由不一样根据优化能在中国电信宽带网网络中进行高效传输。在传输实时视频流时，需要在每一帧多媒体数据前加这里统一定义视频流头格式。其中净荷数据是各个厂家俱体视音频传输协议。
8.2.3 视频数据流传输方法
8.2.3.1 UDP单播传输方法
当采取UDP 单播方法传输时，VTDU/CU直接发送UDP单播通信端口查询消息，PU将UDP单播地址和端口发给VTDU/CU（用户端），或由CMS将查询端口直接返回给VTDU/CU。收到该消息后，向该端口发送单播请求消息。该方法数据实时性强，但数据传输可靠性没有确保，存在网络丢包可能，适合在局域网环境下使用。
用户端（VTDU）
服务器端（PU）
1 单播视频请求

2 请求回应ACK
2’ 音视频数据

8.2.3.2 UDP组播传输方法：
当采取UDP 组播方法传输时，PU将数据向一个组播地址传送。VTDU组播端口请求时，返回信息中包含组播地址和端口，当收到这个组播地址和端口号后，VTDU发送组播请求，加入组播地址收取视频数据。组播地址和端口在PU上可配置或根据最终两位地址默认为设备IP地址最终两位。组播方法在多个相同视频通道请求时能够有效节省带宽，它是基于UDP，存在网络丢包问题。
用户端（VTDU）
服务器端（PU）
1 组拨视频请求

2 请求回应ACK
（包含组播地址和端口）
组播组
发送音视频数据
收音视频数据
3 加入组播组

8.2.3.3 TCP传输方法
TCP传输方法是一个可靠传输方法，采取这种方法关键使用长连接模式。这种传输方法不存在网络丢包可能。
用户端（VTDU）
服务器端（PU）
1 TCP视频请求

2 请求回应ACK
2’ 音视频数据

8.2.3.4 RTP/RTCP传输方法
实时传输协议（Real-time Transport Protocol，PRT）是在Internet上处理多媒体数据流一个网络协议，利用它能够在一对一（unicast，单播）或一对多（multicast，多播）网络环境中实现传流媒体数据实时传输，RTP和RTCP结合使用，为按序传输数据包提供可靠确保和提供流量控制和拥塞控制。
用户端（VTDU）
服务器端（PU）
1 RTP视频请求
建立RTP会话

2 请求回应ACK
2’ 音视频数据

8.2.4 通信方法
用户和服务器对应关系 ：
用户端
服务器端
VTDV
PU
CU
PU
CU
VTDU
服务器端各项服务默认消息端口定义（待讨论）
端口号
应用
7000
UDP（单播）数据请求服务端口
7001
UDP（组播）数据请求服务端口
8000
TCP 数据请求服务端口
9000
RTP 数据请求服务端口
8.2.5视频请求消息接口
8.2.5.1消息流
关键消息流：
用户端
服务器端
1 视频请求
2 请求回应ACK
3 握手请求
4 握手回应
5 关闭连接
2’ 音视频数据

8.2.5.2视频数据请求消息
Message Type: MSG_START_VIDEO_REQ
Direction: CU à VTDU
IE
M/O
描述
IE_OPEN_VIDEO
M

IE_NETLINK
O

简明描述：用户端向服务器（PU/VTDU）发送请求音视频数据请求，服务器接收到该请求后，维护用户表信息，并发送现在编码设备部分关键编解码配置给用户端，然后发送音视频数据流到用户端。
打开视频IE_OPEN_VIDEO
字段名
类型
长度
描述
Type
WORD
2B
IE_OPEN_VIDEO
Length
WORD
2B
该IE类型结构长度
PUID
Char
15
设备ID
ChannelNo
WORD
2
音视频数据源所在通道号
MeidaType
BYTE
1
媒体数据类型
0：音频数据
1：视频数据
2：音频＋视频数据
TransMode
BYTE
1
请求PU对音视频数据传输方法
0： TCP
1： UDP 单播
2： 组播
3:： RTP….
ReqReason
BYTE
1
请求音视频数据原因
0：通常请求
1：因报警请求
….
网络连接 IE_NETLINK

字段名
类型
长度（B）
描述
Type
WORD
2
= IE_NETLINK（301）
Length
WORD
2
该IE类型结构长度
AddType
BYTE
1
IPV4=1; IPV6=2;DN=3
AddRESPs
nChar

地址可为IP或DN
Port
WORD
2
端口
ConnectType
BYTE
1
网络接入连接方法：1公网/0私网
TransType
BYTE
1
视频数据传输方法
＝ 1：TCP
＝ 2：UDP
＝ 3：RTP
＝ 4：Multicast（多播地址和端口在视频通道参数IE里头指定）
8.2.5.3视频请求回应消息
Message Type: MSG_START_VIDEO_ACK
Direction：PUà VTDU，PUà CU， VTDU àCU
IE
M/O
描述
IE_OPEN_ VIDEO _ ACK
M
音视频请求回应

简明描述：对MSG_START_VIDEO_REQ 回应，关键是发送音视频流头信息到用户端解码插件；
打开视频响应IE_OPEN_VIDEO_ACK
字段名
类型
长度（B）
描述
Type
WORD
2
= IE_OPEN_VIDEO_ACK
Length
WORD
2
该IE类型结构长度
MeidiaType
BYTE
1
媒体数据类型
0：音频数据
1：视频数据
2：音频＋视频数据
VidEncode
BYTE
1

视频编码算法
0：MPEG-4
1：MPEG-2
2：MPEG-1
3：H.263
4：MPEG-4
3：H.264
….
VidWidth
WORD
2
视频数据象素宽度
VidHight
WORD
2
视频数据象素高度
VidFormat
BYTE
1
视频制式
0：PAL
1：NTSC
VidFrameRate
BYTE
1
视频输出具体帧数（PAL制式0-25，NTSC制式0-30）
AudEncode
BYTE
音频编码算法
0：MPEG1 L2
1：u-Law PCM
2：ADPCM
音频编码算法
0：MPEG1 L2
1：u-Law PCM
2：ADPCM
AudSamping
BYTE
1
音频采样频率（采样频率依据音频编码算法不一样，其值含义也有不一样解释）。
u-Law PCM和ADPCM编码算法：
0：8KHZ
1：48KHZ
AudBitRate
BYTE
1s
音频输出Bit率（依据不一样音频编码算法，取值含义不一样）。
u-Law PCM 编码算法：
0：64Kbps
ADPCM编码算法：
0：32Kbps
AudTrack
BYTE
1
音频声道模式
0：立体声
1：单声道
DeviceTypeIndex
WORD
2
唯一设备类型索引码，用于解码器调用，索引码需向中国电信申请。

8.2.5.4 音视频数据传输
Message Type: MSG_OPEN_DATA
Direction：PUà VTDU，PUà CU， VTDU àCU
IE
M/O
描述
IE_OPEN_DATA
M
视频数据流

简明描述：传输媒体数据到到用户端消息。
8.2.5.5关闭连接消息
Message Type: MSG_STOP_VIDEO_REQ
IE
M/O
描述
IE_STOP_VIDEO
M
音视频数据关闭

简明描述：用户端CLIENT向服务端发出关闭音视频请求，服务端收到该请求后，会修改对应用户表信息；
传输方向：VTDU à PU， CU à PU， CU à VTDU
关闭视频IE_STOP_VIDEO
字段名
类型
长度
描述
Type
WORD
2B
IE_STOP_VIDEO
Length
WORD
2B
该IE类型结构长度
ChannelNo
WORD
1
音视频数据源所在通道号
MeidaType
BYTE
1
媒体数据类型
0：音频数据
1：视频数据
2：音频＋视频数据

8.2.5.6用户端向服务端握手消息
Message Type: MSG_CLINET_SERVER_ HANDSHK
Direction：CU à VTDU
IE
M/O
描述
无
M

简明描述：CLIENT端应用或控件发给服务器握手消息。关键用于维持CLIENT和服务器之间UDP链路。CLIENT每隔N秒向服务器服务程序发送该消息。RTMS在 >= M秒后没有受到该消息时候，就认为CLIENT已经down掉，将其从用户表中删除，再不向其发送图像数据。通常地N＝10，M＝30。
8.2.5.7服务端向用户端握手消息
Message Type: MSG_ SERVER _ CLINET _ HANDSHK
Direction：VTDUà CU
IE
M/O
描述
IE_OPEN_ VIDEO _ ACK
M

简明描述：服务端发回给用户端(控件)握手消息。当服务端接收到MSG_CLINET_SERVER_ HANDSHK以后，回应给对应CLIENT握手消息。CLIENT收到该消息后表示网络和服务端程序全部正常，假如没有受到该消息，则表示网络不通或服务端程序犯错。
消息格式： 消息格式和MSG_START_VIDEO_ACK消息消息体相同
8.3 集成应用二次开发接口规范
8.3.1 接口规范目标
经过视频解码模块接口标准化，能够提供二次开发接口外，能够使得应用开发接口标准化，最终能够达成插件标准化统一化。
8.3.2 接口标准
插件封装CU和VTDU音视频数据请求和回应接口；同时能够封装CU预CMS控制命令接口。
接口使对外提供调用方法，使用属性和事件。
8.3.3 接口规范

1）方法接口
CreateInstance
描 述：本方法初始化控件。
语 法：Object. CreateInstance ()
返 回 值：数据类型BOOL
值
描述
TRUE
表示初始化成功
FALSE
表示初始化失败
说 明：本方法应该在全部方法调用之前被调用。假如本方法没有调用，那么其它方法调用全部会失败。
Login
描 述：本方法用于用户登录CMS中心服务器。只有成功登录后，系统其它功效才能使用。本方法会激活OnLogin事件通知。
语 法：Object. Login(String ipaddress, String port, String email, String password)
返 回 值：数据类型BOOL
值
描述
TRUE
连接成功
FALSE
连接失败
说 明：
ipaddress ：为CMS中心服务器IP地址，输入参数，为形如“60.191.58.158”字符串
port : 为CMS中心服务器端口，输入参数，为形如“80”字符串
email : 为用户登录系统帐号，输入参数，是一个email形式字符串
password：为用户登录系统密码，输入参数，是一个形如“123456”形式字符串
StartLiveVideo
描 述：本方法用于用户实时监控请求发送。本方法请求成功后，会在目标窗口播放实时视频。
语 法：Object. StartLiveVideo(String FDID,long hWnd)
返 回 值：数据类型BOOL
值
描述
TRUE
请求成功
FALSE
请求失败
说 明：
FDID：为摄像机代码编号，输入参数，为形如“”字符串
hWnd：为图像播放目标窗口句柄，输入参数
StopLiveVideo
描 述：本接口用于停止某摄像机实时监控
语 法：Object. StopLiveVideo( String FDID)
参数说明：FDID：String摄像机代码编号，输入参数，为形如“01”字符串
返 回 值：数据类型BOOL
值
描述
TRUE
关闭成功
FALSE
参数错误或请求发送失败
SendPtzCommand
描 述：本接口用于云台控制命令下发
语 法：Object. SendPtzCommand(String FDID ， long commandCode, long param )
参数说明：FDID：String摄像机代码编号，输入参数，为形如“01”字符串
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 = 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 ,//设置预置点
LENS_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_SETFOCUSSPEED = 0x32 ,//设置聚焦/散焦速度
LENS_SPEEDSETTINGGET= 0x33 ,//获取摄像机速度
LENS_MATRIXSWITCH = 0x40 ,//矩阵切换
param ：为部分需要参数配合命令提供参数，输入参数。对于上下左右转动等命令来说，本参数提供速度数值。速度值改变范围在1－7之间。

返 回 值：数据类型BOOL
值
描述
TRUE
请求成功
FALSE
请求发送失败

ReqVideoURL
描 述：本接口用于用户回放录像前进行录像索引查询。假如查询结果没有录像索引，那么就不能进行图像回放。该接口会激活OnVideoURL事件，经过这个事件来通知最终服务器动作成功是否
语 法：Object. ReqVideoURL (String FDID, String StartTime, String EndTime )
参数说明：FDID：String摄像机代码编号，输入参数，为形如“01”字符串
StartTime：查询录像开始时间字符串，输入参数，为形如“-01-01 01:01:01”字符串
EndTime：查询录像结束时间字符串，输入参数，为形如“-01-01 01:01:01”字符串
返 回 值：数据类型BOOL
值
描述
TRUE
请求成功
FALSE
请求发送失败

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