中国移动视频监控业务客户端规范V1.0.0(送审稿)

中国移动通信企业标准
QB-╳╳-╳╳╳-╳╳╳╳
中国移动视频监控业务 客 户 端 规 范 (送 审 稿 )
China Mobile Video Surveillance Client Specification
版 本 号 : 1.0.0

╳ ╳ ╳ ╳ -╳ ╳ -╳ ╳ 发 布

╳ ╳ ╳ ╳ -╳ ╳ -╳ ╳ 实 施

中国移动通信集团公司 发布

QB-╳╳-╳╳╳-╳╳╳╳
目录
前 言 ...................................................................... V 1.范围 ...................................................................... 1 2.规范性引用文件............................................................. 1 3.术语、定义和缩略语......................................................... 1 4. 客户端概述................................................................ 2
4.1 业务定义 ............................................................ 2 4.2 系统架构 ............................................................ 2 4.3 客户端分类及描述..................................................... 3 5. 基本功能.................................................................. 3 5.1 认证、登录、注销..................................................... 3 5.2 设备管理 ............................................................ 4
5.2.1设备列表展示和刷新............................................. 4 5.2.2修改监控点名称 ................................................ 4 5.2.3无线前端唤醒和重启功能......................................... 4 5.3 实时浏览 ............................................................ 4 5.3.1实时音视频浏览 ................................................ 4 5.3.2全屏浏览 ...................................................... 4 5.3.3断流重连 ...................................................... 4 5.4 快照 ................................................................ 5 5.4.1手动快照 ...................................................... 5 5.4.2快照查询和浏览 ................................................ 5 5.4.3快照删除 ...................................................... 5 5.5 云镜控制 ............................................................ 5 5.6 录像检索、回放、下载................................................. 5 5.7 设置报警电话......................................................... 5 5.8 参数查询和配置支持................................................... 6 5.8.1监控客户端参数配置............................................. 6 5.8.2监控客户端升级 ................................................ 6 5.9 客户端上载视频....................................................... 6 6.手机客户端................................................................. 6 6.1 扩展功能要求......................................................... 7 6.2 扩展性能要求 ........................................................ 7 6.2.1解码能力 ...................................................... 7 6.2.2稳定性要求 .................................................... 7 6.2.3网络传输延迟 .................................................. 7 6.3 UI 要求 ............................................................. 8 6.3.1界面设计要求 .................................................. 8 6.3.2业务登录界面设计要求........................................... 8 6.3.3主界面设计要求 ................................................ 9 6.3.4设置报警号码界面设计要求...................... 错误!未定义书签。 6.3.5设备管理界面设计要求........................................... 9 6.3.6播放界面设计要求 ............................................. 10
I

QB-╳╳-╳╳╳-╳╳╳╳
6.3.7按键使用设计规则 ............................................. 11 6.3.8参数配置界面设计要求.......................................... 11 6.3.9图片管理主界面设计要求........................................ 12 6.3.10图片操作界面设计要求......................................... 13 6.3.11录像管理主界面设计要求....................................... 14 6.3.12系统帮助界面设计要求......................................... 15 6.3.13关于界面设计要求 ............................................ 16 6.3 WAP 浏览模式要求.................................................... 16 7.PC 客户端 ................................................................. 16 7.1 扩展功能要求........................................................ 16 7.1.1认证 ......................................................... 16 7.1.2锁屏 ......................................................... 16 7.1.3设备管理 ..................................................... 16 7.1.4实时浏览 ..................................................... 17 7.1.5录像回放 ..................................................... 18 7.1.6快照 ......................................................... 18 7.1.7告警 ......................................................... 19 7.1.8语音对讲 ..................................................... 19 7.1.9语音广播 ..................................................... 19 7.1.10监控预案 .................................................... 20 7.1.11远程硬盘管理功能 ............................................ 20 7.1.12电子地图(可选) ............................................ 20 7.1.13监控客户端故障管理及升级..................................... 20 7.1.14参数查询和配置 .............................................. 21 7.2 扩展性能要求........................................................ 21 7.2.1解码能力 ..................................................... 21 7.2.2显示能力 ..................................................... 22 7.2.3网络传输延迟 ................................................. 22 7.3 UI 要求 ............................................................ 22 7.3.1登录界面 ..................................................... 22 7.3.2主界面 ....................................................... 23 7.3.3配置界面 ..................................................... 31 7.3.4报警联动 ..................................................... 32 7.3.5电视墙控制 ................................................... 32 7.3.6客户端上载视频 ............................................... 32 7.3.7日志功能 ..................................................... 32 7.3.8客户端同时登录多平台功能...................................... 33 8. PC 浏览器 ................................................................ 33 8.1 扩展功能要求........................................................ 33 8.2 扩展性能要求........................................................ 34 8.3 UI 要求 ............................................................ 34 8.3.1登录界面 ..................................................... 35 8.3.2主界面 ....................................................... 35 9 二次开发控件要求.......................................................... 38
II

QB-╳╳-╳╳╳-╳╳╳╳
9.1 控件开发要求........................................................ 39 9.1.1控件基本要求 ................................................. 39 9.1.2控件升级说明 ................................................. 39
9.2 控件基本接口........................................................ 39 9.2.1控件初始化Initial ............................................ 39 9.2.2控件释放Free ................................................. 39 9.2.3获取控件版本GetVersion........................................ 40 9.2.4控件版本升级通知UpdateInfoNotify.............................. 40
9.3 平台相关接口........................................................ 40 9.3.1登录平台Login ................................................ 40 9.3.2登录平台结果通知LoginResultNotify............................. 41 9.3.3从平台注销Logout ............................................. 41 9.3.4从平台注销结果通知LogoutResultNotify.......................... 41 9.3.5获取设备列表GetDeviceList..................................... 42 9.3.6设备列表结果返回通知DeviceListResultNotify.................... 42 9.3.7获取摄像头信息GetCameraInfo................................... 43 9.3.8获取摄像头信息结果通知CameraInfoResultNotify.................. 44 9.3.9摄像头在线状态变更通知CameraStatusNotify...................... 45
9.4 播放视频相关接口.................................................... 45 9.4.1开始播放实时视频PlayRealVideo................................. 45 9.4.2播放平台录像PlayRecord........................................ 45 9.4.3播放前端录像PlayRecordVCU..................................... 46 9.4.4播放本地录像PlayRecordLocal................................... 46 9.4.5关闭视频播放Close ............................................ 46 9.4.6关闭所有窗口的视频播放CloseAll................................ 47
9.5 播放控制相关接口.................................................... 47 9.5.1继续播放Play ................................................. 47 9.5.2暂停播放Pause ................................................ 47 9.5.3快进或快退播放SetPlayRate..................................... 47 9.5.4倍速播放SetPlaySpeed.......................................... 48 9.5.5获取录像总时长GetTotalTime.................................... 48 9.5.6获取录像当前播放位置GetPosition............................... 49 9.5.7设置录像播放位置SetPosition................................... 49 9.5.8设置音量SetVolume ............................................ 49 9.5.9获取音量GetVolume ............................................ 49 9.5.10本地叠加字幕OverlayText...................................... 50 9.5.11清除叠加字幕ClearOverlayText................................. 50
9.6 云镜控制相关接口.................................................... 51 9.6.1云镜控制PTZControl............................................ 51 9.6.2查询预置位信息QueryPresetInfo................................. 51 9.6.3查询预置位结果通知PresetInfoResultNotify...................... 51 9.6.4调用预置位LoadPreset.......................................... 52
9.7 录像相关接口........................................................ 52 9.7.1查询历史录像文件QueryRecord................................... 52
III

QB-╳╳-╳╳╳-╳╳╳╳
9.7.2查询历史录像文件结果通知RecordReturnNotify.................... 53 9.7.3开始手动录像StartLocalRecord.................................. 53 9.7.4停止手动录像StopLocalRecord................................... 53 9.8 图像抓拍相关接口.................................................... 54 9.8.1客户端抓拍Snap ............................................... 54 9.8.2前端抓拍和下载SnapVCU......................................... 54 9.8.3查询抓拍文件QuerySnap......................................... 54 9.8.4 查询抓拍文件结果通知SnapReturnNotify......................... 55 9.8.5平台抓拍文件下载SnapFileDownload.............................. 55 9.8.6平台抓拍文件下载结果通知SnapFileDownloadResultNotify .......... 55 9.9 语音对讲相关接口.................................................... 56 9.9.1开始双向语音StartVoiceTalk.................................... 56 9.9.2停止双向语音StopVoiceTalk..................................... 56 9.9.3开始单向语音广播StartVoiceBroadcast........................... 56 9.9.4停止单向语音广播StopVoiceBroadcast............................ 57 9.9.5开始语音对讲录音StartVoiceRecord.............................. 57 9.9.6停止语音对讲录音StopVoiceRecord............................... 57 9.10 告警相关接口....................................................... 57 9.10.1历史告警查询QueryAlarm....................................... 57 9.10.2历史告警查询结果通知AlarmResultNotify........................ 58 9.10.3布警和撤警SetGuard........................................... 59 9.10.4告警通知AlarmNofity.......................................... 59 9.11 其它接口 .......................................................... 60 9.11.1通用信息上报接口NotifyEvent.................................. 60 9.11.2自动调整视频大小AutoFitVideoSize............................. 60 9.11.3码率信息上报通知NotifyEvent.................................. 61 9.11.4设置是否接收码率信息SetBitrateInfoConfig..................... 61 9.11.5视频数据上报通知NotifyEvent.................................. 62 9.11.6设置是否启用视频数据上报SetFrameInfoConfig................... 63 9.12 错误/消息列表...................................................... 63 10.编制历史................................................................. 66 附录 A (解码器)............................................................ 66 附录 B (客户端关键性能指标)................................................ 66
IV

QB-╳╳-╳╳╳-╳╳╳╳ 前言

本标准的目的在于定义中国移动视频监控业务的客户端的特征及要求,用于中国移动公

司开展视频监控业务的规范性文件。

本标准是中国移动视频监控业务系列标准之一,该系列标准的结构、名称或预计的名称

如下: 序号

标准名称 中国移动视频监控业务规范 中国移动视频监控业务接口规范 中国移动视频监控总体技术要求 中国移动视频监控客户端规范 中国移动视频监控平台网管规范 中国移动视频监控前端规范 中国移动视频监控前端网管规范 中国移动视频监控中心平台设备规范

本标准涉及知识产权的情况说明。

本标准的附录A~附录B为资料性附录。

本标准由中移

号文件印发。

本标准由中国移动通信集团数据部提出,集团公司技术部归口。

本标准起草单位:中国移动通信研究院,中国移动北京公司

本标准主要起草人:刘聪、徐怡、

V

QB-╳╳-╳╳╳-╳╳╳╳

1.范围

本标准规定了中国移动视频监控业务的定义、特征及主要流程,供中国移动公司开展视 频监控业务遵照执行。

2.规范性引用文件

下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其

随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标

准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新

版本适用于本标准。

表2-1 引用规范列表

序号

标准编号

标准名称

[1]

RFC768

用户数据包协议(UDP)

[2]

RFC793

传输控制协议(TCP)

[3]

RFC959

文件传输协议(FTP)

[4]

RFC2326

实时流协议(RTSP)

[5]

RFC4566

会话描述协议(SDP)

[6]

RFC2616

超文本文传输协议(HTTP1.1)

[7]

RFC3261

会话初始协议(SIP)

[8]

RFC3550

实时传输协议(RTP)

[9]

RFC3551

实时控制协议(RTCP)

[10] RFC4145

基于TCP的媒体传输会话描述协议(SDP)

[11] RFC4571

基于连接的实时传输、控制协议

3.术语、定义和缩略语

下列术语、定义和缩略语适用于本标准: 表3-1 缩略语

词语

解释

业务控制中心 监控客户端 移动监控客户端 录像管理单元 网络录像单元 监控前端

Service Control Center Surveillance Client Mobile Surveillance Client Video Archive Manager Video Recorder Video Capturing Unit

缩略语 SCC SC M_SC VAM VR VCU
1

移动监控前端 业务管理平台 视频转码单元 录像回放控制 视频分发服务器 前端接入网关 客户端接入网关

QB-╳╳-╳╳╳-╳╳╳╳
Mobile Video Capturing Unit Service Management Platform Video Transcoder Video Streaming Server Video Distribution Server VCU Gateway SC Gateway

M_VCU SMP VT VSS VDS VCU_GW SC_GW

4. 客户端概述

4.1 业务定义
视频监控业务是中国移动全业务服务的典型应用,利用宽带专线和TD-SCDMA/EDGE/GSM 网络通过部署宽带有线和无线监控设备,实现在任意地点实时上传视频图像,在任意位置实 时观看远方视频,调用历史视频等功能,实现随时随地、无所不在的视频监控应用。
视频监控业务系统由前端、平台端、客户端三部分组成。前端由镜头、摄像机、云台、 报警开关、视频编解码设备、主机控制设备和监控软件组成;平台端是移动公司提供的中心 服务平台,具有业务平台的管理功能,并对传送过来的图像进行转发、分发或存储,对报警 进行联动处理;在客户端用户可在网络的任何一个接入点,无论是监控现场,监控中心,或 者是远端,只要通过IE 浏览器,客户端软件,或者手机终端,在通过认证后可查看视频, 可以云镜控制摄像机的转向、镜头的拉伸、并可接收报警信息。
使用这一业务,用户通过有线宽带网络和TD-SCDMA网络,可以从显示器或手机上看到 清晰、逼真、实时监控图像和调用历史视频。
非明确说明情况下,下文中的客户端是指PC客户端,手机客户端默认是指CS手机客户端。
4.2 系统架构
系统单域的总体框架如下图所示。主要包括业务管理平台、中心服务平台、监控前端 (VCU)以及监控客户端(SC),中心服务平台包括业务控制中心(SCC)、视频转分发服务 器(VDS)、网络录像单元(VR)、视频转码单元(VT)、前端接入网关(VCU_GW)、客户 端接入网关(SC_GW)。

2

QB-╳╳-╳╳╳-╳╳╳╳

SMP

中心服务平台

SCC

业务控制中心

VDS 视频分发服务器

VR
网络录像单元
SC_GW

VT 视频转码单元 VCU_GW

客户端接入网关

前端接入网关

SC /M_SC
监控客户端

图4-1 视频监控系统架构图

VCU /M_VCU
监控前端

4.3 客户端分类及描述

各省集团客户使用统一的客户端进行采集信息的查看,通过客户端可以选择登录到不同 省公司的业务平台。
按照有线网络和无线网络,客户端分为PC客户端和手机客户端。 其中,PC客户端分为专用客户端软件和基于浏览器的插件。 手机客户端支持TD-SCDMA、EDGE、GPRS等无线上网方式。手机操作系统平台是流行的操 作系统平台,包括Symbian、嵌入式Linux(包括android/OMS等)、Windows Mobile等。具 有足够的内存和运算速度,支持客户端软件的下载安装。 客户端需要支持接口规范中定义的各种协议,具体参见相应的接口规范要求。 要求客户端界面操作简单,方便使用。

5. 基本功能

5.1 认证、登录、注销
客户端在使用前首先需要向接入的SCC(监控平台)请求登录认证,SCC向客户端返回认 证结果,鉴权通过后才能使用视频监控平台提供的各项业务功能。
客户端支持通过用户名(用户名可以配置成手机号码)和密码的方式进行认证,用户名 和密码在业务办理或开通时获得。客户端支持选择保存用户名和密码。
用户如果登录失败,客户端能给出正确的提示,例如用户名或密码错误,如果连续超过 三次输入错误,则提示用户通过其他方式重新获得密码,对于采用暴力破解方式可以冻结该 账号,并提示用户。
3

QB-╳╳-╳╳╳-╳╳╳╳
客户端正常使用时可执行注销、退出程序等操作,此时客户端中断与平台之间的通讯链 路,并停止视频播放和本地录像。
客户端能够把用户输入的内容自动转换为小写。 5.2 设备管理 5.2.1 设备列表展示和刷新
客户端登录平台成功后自动获取设备列表信息,并分级显示,支持手动设备列表刷新。 5.2.2 修改监控点名称
支持修改指定的监控点名称,修改后能立即生效,并同步到平台,由平台将监控点名称 刷新至所有相关客户端。 5.2.3 无线前端唤醒和重启功能
针对无线前端,支持通过设备列表的菜单进行远程唤醒和远程重启功能,客户端向监控 平台发送消息,监控平台通过短信网关发送指定格式的短信内容给无线前端。 5.3 实时浏览 5.3.1 实时音视频浏览
客户端支持通过网络播放前端的实时音视频。 5.3.2 全屏浏览
客户端支持对播放窗口进行全屏显示播放,并能恢复到正常界面状态。 5.3.3 断流重连
客户端支持检测当前码流接收状态,一段时间内若未收到任何码流数据则认为当前码流 已经中断,客户端主动重新发起断流重连。
4

5.4 快照

QB-╳╳-╳╳╳-╳╳╳╳

5.4.1 手动快照
客户端支持对某指定监控点进行手动快照抓拍操作,并保存到客户端本地,图片格式支 持BMP和JPG格式。
5.4.2 快照查询和浏览
客户端支持查询客户端本地的快照文件并进行浏览。
5.4.3 快照删除
在快照查询结果中,支持选择指定的客户端快照文件进行删除。
5.5 云镜控制
客户端登录后,可以得到前端设备是否支持远程控制操作的信息,当前端支持远程控制 时,客户端需要根据前端云镜提供的控制信令接口,使用中心平台下发的缺省配置或手动配 置相应的操作参数(包括预置位、步长等),在客户端实时浏览视频的情况下,向云镜发送指 定的信令,达到对云镜的向上、向下、向左、向右、远焦、近焦、光圈调节等基本远程控制。
当前端满足以下情况时,客户端也需要具备相应的控制信令: ? 云镜支持自动巡航或巡航路线定制的功能; ? 前端设备为摄像机,且提供调节自身属性(比如色度、亮度、饱和度)的功能;
5.6 录像检索、回放、下载
? 客户端支持通过时间段、监控点等查询条件检索录像记录,并支持分页展示查询结 果;
? 客户端支持对平台或前端上的指定录像进行点播,包括快进、快退、单帧放、慢放、 暂停、定位、拖拽等操作,并可以选择是否同步下载到本地并保存;
? 客户端可以设置前端录像、平台录像和客户端录像的录像计划,并把相应的录像计 划保存到前端、平台和本地进行执行;
5.7 设置报警电话
客户端支持以下方式设置前端或平台发送报警信息。 短信:向设置的手机号码发送报警短信,可以同时向多个用户发送; 彩信:向设置的手机用户发送报警情况的彩信,可以同时向多个用户发送; 语音报警:主动呼叫用户指定的电话号码,用于用户监听现场的声音。 在用户设定报警电话时,可以支持限制用户仅设定中国移动用户号码。
5

QB-╳╳-╳╳╳-╳╳╳╳
5.8 参数查询和配置支持
5.8.1 监控客户端参数配置
监控客户端支持配置接入网关的地址,根据各地的客户端接入网关地址分别预先填入, 并允许用户修改。具备布防、撤防、灵敏度配置。
5.8.2 监控客户端升级
监控客户端登录成功后,支持从平台获取最新版本信息和本地的版本信息进行对比,支 持最新版本升级提示窗口。
版本标识:分两部分。第一部分为客户端的类型,包括PC客户端(SC)、手机客户端(MSC)、 基于PC浏览器的插件(BSC)、基于C/S架构的二次开发控件(CSC)。第二部分为版本号x.y.z。
举例: SC-3.3.1 MSC-1.0.0
5.9 客户端上载视频
客户端支持用户主动上载视频功能,并能把视频共享给其他用户,由其他用户进行浏览 或者下载。上载的视频默认只有上载的用户可以进行浏览和下载,但上载用户可决定是否共 享给同客户下用户进行浏览和下载。上载的视频必须经过客户管理员和移动管理员进行业务 审批后才可以发布。
客户端上支持查询其授权范围内的视频文件列表,并支持回放和下载。 客户端上载的视频必须为流化过的3GP、MP4文件,客户端支持对3GP、MP4和AVI文件的 流化处理。
6.手机客户端
由于手机屏幕比较小,且大部分手机的操作键盘简单, 所以手机终端只要求实现容易 显示和容易操作的功能,下面对两种手机操作方式的功能进行总结:
? CS手机客户端: CS手机客户端只实现下面这几个功能: 1. 使用用户名密码登陆认证; 2. 获取并显示摄像头设备列表; 3. 实时浏览功能; 4. 云镜控制操作(除预置位、巡航、辅助功能 之外的所有操作); 5. 查询平台/前端录像; 6. 录像回放 (不支持VCR操作); 7. 设置移动侦测告警; 8. 抓拍图片;
6

QB-╳╳-╳╳╳-╳╳╳╳
9. 刷新显示摄像头设备列表。 ? 手机WAP方式:
手机WAP方式只实现下面这几个功能: 1. 使用用户名密码登陆认证; 2. 获取并显示摄像头设备列表; 3. 实时浏览功能; 4. 刷新显示摄像头设备列表; 5. 录像查询; 6. 录像回放(不支持VCR操作)。
非明确指明情况下,文中的手机客户端统一是指CS手机客户端。
6.1 扩展功能要求
? 手机客户端支持设置本地快照和录像文件保存路径; ? 手机客户端正常播放情况下,如有来电,客户端先停止播放,当用户电话挂断后再
继续播放; ? 手机客户端运行过程中,出现电池电量低、存储满、无信号、新来电、新短信等现
象时,程序能正确处理; ? 手机客户端能支持当前时间显示;
6.2 扩展性能要求
6.2.1 解码能力
? 支持多种编码格式的码流,包括H.264、MPEG4、AVS(可选); ? 支持多种分辨率格式的图像播放,包括QCIF、QVGA; ? 图像帧率支持1-25帧/秒; ? 码率支持64-384Kbps; ? H.264遵循RFC3984打包规范,支持baseline profile。 ? MPEG-4遵循RFC3016打包规范; ? G.711,G.723.1遵循RFC3551打包规范; ? AMR-NB遵循RFC3267打包规范。
6.2.2 稳定性要求
手机客户端连续1小时正常播放不出现程序崩溃或者程序无响应。
6.2.3 网络传输延迟
在无线接入方式下,要求前端设备与客户端之间实时音视频传输延迟时间小于5秒。
7

6.3 UI 要求

QB-╳╳-╳╳╳-╳╳╳╳

6.3.1 界面设计要求

? 主菜单界面采用菜单方式,需要有中国移动Logo图标和企业标识,图案体现视频监控产 品的市场定位和移动风格。
? 可以通过手机方向键或触摸笔进行操作吗,被选中的按键或对象需要显示焦点。 ? 界面将主要分为标题区、信息区、按键区三部分。 ? 运行程序后,应该进入业务登录界面。

6.3.2 业务登录界面设计要求

? 业务登录界面有“用户名(User Name)”、“密码(Password,密码应为星号显示)”。 ? 业务登录界面有“登陆(Login)”、“网络设置(Set)”、“退出(Exit)”等按键。 ? 点击“登陆(Login)”按键后发送登陆验证。 ? 当成功完成上面操作后,会进入M_SC主界面。 ? 如果密码验证失败,则提示登录错误信息。 ? 示例如下:

LOGO

登录

用户名 密码

登录

网络设置

退出

图6-1 业务登录界面示意图 ? 点击“网络设置(Set)”按键后显示网络设置界面。 ? 网络设置界面有“网关地址”、“选择网络”、“选择连接方式(速度优先、质量优先)”。
其中“网关地址”即为用户欲登录的平台地址。 ? 网络设置界面有“保存(Save)”、“返回(Main Menu)”按键。 ? 点击“保存(Save)”按键,将把修改结果进行保存,并返回M_SC登录界面。 ? 点击“返回(Main Menu)”,将不保存修改结果,并返回M_SC登录界面。 ? 示例如下:

8

QB-╳╳-╳╳╳-╳╳╳╳

LOGO

网络设置

网关地址 选择网络 选择连接方式

保存

返回

图6-2 网络设置界面示意图

6.3.3 主界面设计要求

? 主界面上显示用户有权限浏览的监控点设备。
? 需要去平台获取企业或用户个性化Logo,显示在左上角“LOGO”区域;如果用户没有配 置或者获取失败,则显示默认的LOGO。
? “选项(Menu)”菜单的具体内容为:视频浏览(Videos)、设备管理(Devices)、 参数设置(Options)、图片管理(Snapshots)、录像管理(clips)、系统帮助(Help)、 关于(About)功能。
? 点击“退出(Exit)”按键后,退出M_SC程序。
? 选择一个监控点后,在“选项(Menu)”中选择“视频浏览(Videos)”,则切换到播 放界面。
? 示例如下:

自定义LOGO
监控点1 监控点2 监控点3
……

欢迎语

视频浏览 设备管理 参数设置 图片管理 录像管理 系统帮助
关于
选项

退出

图6-3 主界面示意图

6.3.4 设备管理界面设计要求

? 设备管理界面上显示用户有权限浏览的监控点设备。

9

QB-╳╳-╳╳╳-╳╳╳╳

? “选项(Menu)”菜单的具体内容为:“视频浏览(Videos)”。 ? 选择一个监控点后,在“选项(Menu)”中选择“视频浏览(Videos)” 菜单项之后,
则切换到播放界面。 ? 点击“返回(Main Menu)”按键,将不保存修改结果,并返回M_SC主界面。 ? 示例如下:

自定义LOGO
监控点1 监控点1 监控点1
……

设备管理

视频浏览
选项

返回

图6-5 设备管理界面示意图

? 点击“返回(Main Menu)”,将不保存修改结果,并返回设备管理界面。

6.3.5 播放界面设计要求

? 在按键区需要提供“播放/暂停”、“抓拍”、“录像开始/停止”、“PTZ控制”、“全 屏播放”和“返回”功能按键。
? 针对PTZ控制功能,需要在同一界面中提供“向左”、“向右”、“向上”、“向下”、 “图像放大”、“图像缩小”、“光圈放大”和“光圈缩小”功能键或快捷方式,用“PTZ 控制”键来控制这些按键的是否显示。
? 被选择的按键需要与其他按键有所区别。
? “播放/暂停”按钮可以在播放和暂停之间切换。
? 点击“抓拍”按键,可以对当前播放的视频图像进行抓拍,并转换成JPG格式的图片文 件,自动保存在指定目录中,同时需要给予声音提示。
? 如果被指定的图片存储目录无可用空间,则要给予无空间的提示,要弹出提示框提示用 户,图片将不再保存。
? 点击“录像开始/停止”按键,可以对当前播放的视频图像进行录像,录像保存的文件 格式为3GP,并自动保存在指定目录中。
? 如果被指定的录像存储目录无可用空间,则要给予无空间的提示,要弹出提示框提示用 户,录像将不再保存。
? 再次点击“录像开始/停止”按键,停止录像。
? 点击“全屏播放”按键,可以进行全屏和正常屏幕之间的切换。在全屏状态下,用户触 发任意按键即返回正常播放状态(挂机等系统高优先级按键除外)。
10

QB-╳╳-╳╳╳-╳╳╳╳

? 点击“返回”按键,会停止视频播放,并返回到设备管理界面。 ? 示例如下:

监监监 LOGO

监监监监监

监监监监监

6.3.6 按键使用设计规则

PTZ监 监 监 监监监监监
图6-7 播放界面样图

为了方便用户使用,在实时浏览过程中,云镜控制可以使用键盘的操作方式,并支持 步进值设置。
云镜控制使用如下的键盘的操作方式(对于触摸屏手机,实现功能即可): ? 数字键4——向左 ? 数字键6——向右 ? 数字键2——向上 ? 数字键8——向下 ? 数字键1——光圈放大 ? 数字键3——光圈缩小 ? 数字键7——镜头拉近 ? 数字键9——镜头拉远

6.3.7 参数配置界面设计要求
? 在选择“参数设置”菜单项之后,会进入到参数设置的操作界面。 ? 信息区将用于显示需要设置的各项参数信息,包括云台控制步长(tripod head move
speed)、镜头控制步长(Camera control speed)、抓图保存地址(Snapshots Path, 可选择目录)、录像保存地址(clips Path,可选择目录)。
11

QB-╳╳-╳╳╳-╳╳╳╳

? 在按键区需要提供有保存(Save,保存并返回)、返回(Main Menu)按键。 ? 保存路径建议采用下拉框的方式操作,可提供手机存储和存储卡存储两种方式选项。 ? 焦距单位、移动单位要限定只能输入2位数字。 ? 点击“保存(Save)”按键,将把修改结果进行保存,并返回M_SC主界面。 ? 点击“返回(Main Menu)”按键,将不保存修改结果,并返回M_SC主界面。 ? 示例如下:

监监监 LOGO

监监监监

监监监监监监 监监监监监监 监监监监监监 监监监监监监

监监

监监

图6-8 参数设置界面示意图

6.3.8 图片管理主界面设计要求

? 在选择“图片管理”菜单项后,会进入到图片管理主界面中。 ? 标题区将显示图片所在页数和图片总页数。 ? 信息区将显示被抓拍保存的图片,并按拍摄时间先后进行排序。 ? “选项(Menu)”菜单的具体内容为:“确认(OK)”、“上页(Forward)”、“下
页(Next)”、“删除(Delete)”和“返回(Main Menu)”功能键。
? 对于被选中的图片,在选择“确认(OK)”菜单项之后,可以进入到图片操作界面中。 ? 在选择“上页(Forward)”菜单项之后,信息区将显示前一页的图片信息,并且操作
焦点将落到第一张图片上。
? 在选择“下页(Next)”菜单项之后,信息区将显示后一页的图片信息,并且操作焦点 将落到第一张图片上,建议默认每页显示2行3列。
? 在选择“删除(Delete)”菜单项之后,将弹出一个提示框,提醒用户将删除该图片, 并且提供“确定(OK)”和“取消(Cancel)”操作选项。确定删除后,操作焦点将落 在后一张图片上。
? 点击“返回(Main Menu)”按键,将返回到M_SC主界面中。 ? 示例如下:

12

QB-╳╳-╳╳╳-╳╳╳╳

监监监 LOGO

监 监 监 监 监 5/10

监监 监监 监监 监监

监监

监监

图6-9 图片管理界面示意图

6.3.9 图片操作界面设计要求

? 标题区显示当前图片所在页数和图片总页面数。
? 信息区将显示被选中的图片和图片的名字,初始时将按正常大小显示。
? “选项(Menu)”菜单的具体内容依次为:“放大(Zoom In)”、“缩小(Zoom Out)”、 “删除(Delete)”功能。
? 在选择“放大(Zoom In)”菜单项之后,逐级放大当前图片(保持图像纵横比例,不 变形),按任意键返回。
? 在选择“缩小(Zoom Out)”菜单项之后,逐级缩小当前图片(保持图像纵横比例,不 变形),按任意键返回。
? 在选择“删除(Delete)”菜单项之后,将弹出一个提示框,提醒用户将删除该图片, 并且提供“确定(OK)”和“取消(Cancel)”操作选项。确定删除后,将返回到图片 管理主界面中,操作焦点将落在后一张图片上。
? 点击“返回(Back)”按键,将返回图片管理界面,并且操作焦点还是为该图片。
? 示例如下:

13

QB-╳╳-╳╳╳-╳╳╳╳

LOGO

图片:5/10

放大 缩小 删除
选项

图片名称
返回

图6-10 图片操作界面示意图

6.3.10 录像管理主界面设计要求

? 在选择“录像管理”菜单项后,会进入到录像文件管理主界面中。 ? 标题区将显示录像文件所在页数和录像文件总页数。 ? 信息区将显示录制保存的录像文件,并按录制时间先后进行排序。 ? “选项(Menu)”菜单的具体内容为:“确认(OK)”、“上页(Forward)”、“下
页(Next)”、“删除(Delete)”和“返回(Main Menu)”功能键。
? 对于被选中的录像文件,在选择“确认(OK)”菜单项之后,可以进入到播放界面。 ? 在选择“上页(Forward)”菜单项之后,信息区将显示前一页的录像文件信息,并且
操作焦点将落到第一个录像文件上。
? 在选择“下页(Next)”菜单项之后,信息区将显示后一页的录像文件信息,并且操作 焦点将落到第一个录像文件上。
? 在选择“删除(Delete)”菜单项之后,将弹出一个提示框,提醒用户将删除该录像文 件,并且提供“确定(OK)”和“取消(Cancel)”操作选项。确定删除后,操作焦点 将落在后一个录像文件上。
? 点击“返回(Main Menu)”按键,将返回到M_SC主界面中。 ? 示例如下:

14

QB-╳╳-╳╳╳-╳╳╳╳

监监监 LOGO

监 监 监 监 监 1/2

监监 监监 监监 监监

监监

监监

图6-11 录像管理界面示意图

6.3.11 系统帮助界面设计要求

? 在选择“系统帮助(Help)”菜单项后,会进入到系统帮助信息界面中,将介绍M_SC 的基本操作方法。
? 在按键区提供“确认(OK)”、“返回(Main Menu)”按键。 ? 点击“确认(OK)”按键,将返回到M_SC主界面中。 ? 点击“返回(Main Menu)”按键,将返回到M_SC主界面中。 ? 示例如下:

监监监 LOGO

监监监监

监监监监

监监

监监

图6-12 系统帮助界面示意图

15

QB-╳╳-╳╳╳-╳╳╳╳
6.3.12 关于界面设计要求
? 在选择“关于(About)”菜单项后,会进入到关于界面中,将显示与M_SC版权相关的 信息。界面要采用提示框的方式。
? 提供“确认(OK)”按键,将返回到M_SC主界面中。
6.3 WAP 浏览模式要求
? 手机支持通过WAP方式接入网络并通过手机浏览器访问WAP门户,支持采用HTTP方式 通过WAP网关访问视频监控门户,并能对其返回的WAP页面进行显示。其中包括在页面中 进行登录认证、监控点列表展示等功能。 ? 浏览器能正常解析WAP门户页面中的链接,对于监控点播放,门户中返回RTSP URL 链接,当浏览器访问RTSP链接时,能自动调用起手机自带的播放器进行视频播放。
7.PC 客户端
7.1 扩展功能要求
7.1.1 认证
客户端登录成功后,定期按指定的时间间隔向平台发送保活消息。客户端能够检测与平 台之间的连接状态,当连接发生中断时,客户端能主动尝试重新连接,如果连续3次收不到 保活响应,客户端自动重新登录。当自动重新登录尝试3次失败以后提示用户连接失败。
客户端可选支持通过USBKey方式进行认证,用户插入USBKey后输入密码进行登录。
7.1.2 锁屏
客户端支持锁屏功能,锁定后只能浏览当前已经播放的视频,不允许用户进行其他操作, 用户必须输入密码解锁后才能继续正常使用。
7.1.3 设备管理
7.1.3.1 设备列表显示和刷新
在设备列表中支持监控点图标显示,能直观的显示监控点的在线状态(上线、下线)、 云台类型(枪机、球机)、摄像头状态(正常、已暂停)、语音对讲状态、操作权限等。
客户端支持两种方式的设备列表的刷新:
16

QB-╳╳-╳╳╳-╳╳╳╳
(1)自动刷新:当管理员修改设备列表(如增加设备、删除设备、修改相关信息等)时, 监控平台向客户端主动发送设备列表变更通知,客户端收到通知后自动进行列表刷新。
(2)用户手动刷新:用户可通过设备列表菜单进行手动刷新。 支持将设备列表信息保存在客户端本地,当设备列表未发生变更的情况下直接从本地读 取,以提高加载速度和节省网络资源。
7.1.3.2 实时状态通知
对于监控点的一些可能会经常发生变化的信息,客户端支持显示和及时更新这些实时状 态,包括监控点在线状态等。当前端的在线状态发生变化,监控平台支持发送这些通知消息 给客户端,客户端能直接更新设备列表中的相关信息,无需重新刷新整个列表。可选支持监 控点码流信息、码流状态、分辨率等状态通知。
7.1.3.3 分组设置
支持用户自定义分组,用户可以将监控点加入或移除自定义分组中,并能创建自定义监 控点组,支持上移、下移、左移、右移、拖拽等方式设置监控点所在位置以自定义树形目录 结构。自定义分组信息保存在客户端本地。
7.1.3.4 设备列表模糊查询
支持在设备列表中通过输入关键字、汉语拼音首字母查询通道,此时设备列表中进行过 滤显示,只显示符合查询条件的监控点。
支持使用“*”通配符进行查找。
7.1.3.5 监控点数目统计
设备列表中支持按组统计监控点的数目,并支持按监控点的在线状态分别展示,例如: “中国移动-01 (在线:12;离线9;总数:21)”。
支持在客户端进行设置仅展示当前在线的监控点。
7.1.4 实时浏览
7.1.4.1 实时音视频浏览
客户端支持通过网络播放前端的实时音视频。 对于包含双码流或者多码流的监控点,客户端支持选择指定一路码流进行播放,例如某 监控点第一路流为D1分辨率、第二路流为CIF分辨率,客户端能支持让用户选择播放指定分 辨率格式的码流。 支持实时视频信息显示,如当前图像分辨率、编码格式、码率等信息显示。 客户端支持设置浏览图像时画面为等比例缩放或者平铺拉伸显示。 当监控点存在音频时,支持手动关闭或打开指定监控点的音频,并支持调节音量。
17

QB-╳╳-╳╳╳-╳╳╳╳
7.1.4.2 媒体直连和中转
用户使用客户端进行实时监控时,可以选择客户端与前端直连或者通过平台中转方式进 行媒体传输。
7.1.5 录像回放
能够在播放过程中调高或调低图像亮度. 在播放过程中,支持多个视频同时播放,可以切换不同的信源,也可以对不同的信源进 行比对.
7.1.6 快照
7.1.6.1 手动快照
客户端支持指定对某指定监控点进行手动快照抓拍操作,并可指定是在前端、平台上进 行快照,图片格式支持BMP和JPG格式。
7.1.6.2 快照查询
客户端支持对前端、平台本地的快照文件进行查询,可指定监控点和时间段等查询条件, 支持选择多个监控点同时查询。
查询结果支持分页展示、按列排序,并支持将查询结果导出到Excel文件中。
7.1.6.3 快照删除
在快照查询结果中,支持选择指定的前端、平台的快照文件并删除,删除成功后打印日 志提示信息。
7.1.6.4 快照预览和下载
支持在快照查询结果中,对指定的前端、平台的快照文件进行快照预览,预览完成后删 除临时文件。
支持在快照查询结果中,选择指定的前端、平台的快照文件进行快照下载,下载后自动 保存到客户端本地预设的快照图片保存目录中,下载完成后可通过客户端快照查询功能检索 到该图片。
7.1.6.5 关联录像查询和播放
在快照查询结果中,用户选择一个快照文件可查询此快照文件的关联录像文件,此时查 询快照文件的抓拍时间附近的时间段范围的录像文件。
18

QB-╳╳-╳╳╳-╳╳╳╳
在快照查询结果中,用户可选择一个快照文件并直接进行关联录像播放,此时客户端自 动的首先进行关联录像查询并对查询结果中的录像文件进行播放。
7.1.7 告警
7.1.7.1 实时告警通知
客户端支持接收所有前端定义的告警, 并以列表方式显示告警提示信息。支持针对不同 类别的告警信息进行分类展示。
客户端支持对接收到的实时告警进行确认操作。
7.1.7.2 历史告警查询
客户端支持按监控点、时间段等查询条件检索历史告警信息,查询结果支持分页展示、 按列排序,并能够将查询结果导出到Excel文件中。
7.1.7.3 告警联动
? 客户端支持设置平台、前端的告警联动策略,可设置联动预置位、联动抓拍和联动 录像等策略;
? 客户端支持设置本地告警联动策略:支持配置告警音频播放,当接收到实时告警信 息时播放预设的语音提示文件;支持配置告警本地联动播放,接收到告警时,若当 前监控点不处在播放状态,则自动进行播放并提示用户;支持配置告警本地联动录 像,可设置当接收到告警时对指定通道进行本地联动录像;
7.1.8 语音对讲
监控客户端需要支持与权限许可的单个监控前端之间进行双向的实时语音对讲。 ? 语音对讲成功后客户端支持显示语音对讲状态,并且支持调节音量。 ? 支持语音对讲录音功能,支持设置保存路径;
7.1.9 语音广播
监控客户端需要支持与权限许可的多个同类型的监控前端进行单向的实时语音广播。 ? 可以将多个同类型的监控前端保存为语音广播列表,可以打开语音广播列表,与列
表中的监控前端进行广播。 ? 在进行语音广播的同时,支持显示每一个监控前端的对讲状态。 ? 语音文件的格式参照《中国移动视频监控业务前端设备规范》。
19

QB-╳╳-╳╳╳-╳╳╳╳
7.1.10 监控预案
监控客户端支持多画面监控预案,即监控客户端具备视频的自动巡检功能。 ? 监控预案包括:监控对象、视频播放窗口、监控对象切换间隔时间。 ? 支持在指定的一个和多个画面中,在设定的间隔时间内,依次对选定的监控对象进
行视频巡检。 ? 支持设定巡检的监控对象,包括不同监控前端的摄像机、同一监控前端下不同的摄
像机、同一摄像机的不同预置位等,巡检间隔时间可以设置。 ? 支持保存、修改、删除监控预案。
7.1.11 远程硬盘管理功能
客户端上支持对设备内存储设备容量信息进行显示。
7.1.12 电子地图(可选)
监控客户端支持电子地图功能(可选择矢量图或图片格式的地图)。 ? 支持在电子地图上增加、删除监控点,修改监控点位置; ? 在电子地图上点击摄像头,可以弹出框显示对应摄像头的实时视频; ? 报警发生时,报警地点以醒目的标记闪烁在电子地图上,准确判断报警类型和地点。
7.1.13 监控客户端故障管理及升级
7.1.13.1 故障管理
监控客户端支持将监控客户端产生的异常和故障上报到业务控制中心。支持查询和显示 监控客户端的故障,包括故障产生的时间,故障名称,故障类型,故障说明。
7.1.13.2 客户端升级
监控客户端登陆成功后,支持从平台获取最新版本信息和本地的版本信息进行对比,支 持最新版本升级提示窗口。
? 升级方式需要支持强制升级和非强制升级两种方式。 ? 当平台提示用户强制升级时,用户必须选择升级,否则监控客户端将自动退出。 ? 需要支持监控客户端自动在线升级,根据业务控制中心返回的升级路径自动使用
FTP或者HTTP方式进行升级。
7.1.13.3 操作日志
监控客户端支持操作日志查询,提供操作日志的查询和浏览窗口。
20

QB-╳╳-╳╳╳-╳╳╳╳
? 支持查询用户相关的操作日志,包括用户登录登出、视频文件管理、告警管理、云 台管理的操作日志。
? 查询支持按用户进行查询,最大支持查询一个月的操作日志。
7.1.14 参数查询和配置
7.1.14.1 监控客户端参数配置
监控客户端需要支持以下的参数配置功能: ? 支持配置抓图/录像保存地址,默认为安装目录下。 ? 支持监控客户端的参数导入和导出。
7.1.14.3 监控前端参数配置
监控客户端能够支持以下的前端参数配置功能: ? 支持设置监控前端的码流参数。 ? 支持设置监控前端的OSD参数。 ? 支持设置监控前端的移动侦测参数。 ? 支持设置监控前端的遮挡告警参数。 ? 支持设置监控前端的遮挡参数。 ? 支持设置监控前端的录像参数。 前端相关参数参见《视频监控设备规范》。
7.2 扩展性能要求
7.2.1 解码能力
? 支持多种编码格式的码流,包括H.264、MPEG4,AVS(可选); ? 支持多种分辨率格式的图像播放,包括QCIF、QVGA、CIF、VGA、HalfD1、D1、720P、
1080P; ? 图像帧率支持1-30帧/秒; ? 码率支持64Kbps、128kbps、384kbps、512kbps、768kbps、1M、1.5M、2M、4M、8M; ? 最大能够支持16路视频同时解码。 ? H.264遵循RFC3984打包规范; ? MPEG-4遵循RFC3016打包规范; ? G.711,G.723.1遵循RFC3551打包规范; ? AMR-NB遵循RFC3267打包规范。 ? 支持H.264 main profile。
21

QB-╳╳-╳╳╳-╳╳╳╳
7.2.2 显示能力
监控客户端支持1、4、6、8、9、16画面播放实时视频,并支持宽屏显示,能够在多画 面之间的进行自动切换,即如果在4画面播放第5路视频时,自动切换到6画面播放。
监控客户端支持多画面全屏,可实现对整个播放区域进行全屏展示,在多画面全屏模式 下,可切换分屏显示模式。
7.2.3 网络传输延迟
在有线接入方式下,要求前端设备与客户端之间实时音视频传输延迟时间小于0.6秒。
7.3 UI 要求

7.3.1 登录界面

7.3.1.1 界面功能

登录界面为中国移动视频监控客户端的首页面,主要用于用户权限认证,用户帐户信息 (包括用户名、密码、平台信息等)的设置/保存,单击设置弹出服务器地址和代理服务器 设置版面。设置后客户端自动保存该类信息。代理服务器类型默认为“不使用代理”。后台 认证结果反馈。合法用户通过登录界面能够登录客户端主界面。用户帐号密码可选择保存, 在下次登录时不必重复输入。
客户端支持同时登录多个平台,支持在客户端登录时自动通过全网统一的客户端软件版 本服务器获取各省平台登录地址的配置文件,并支持在登录界面中选择欲登录的平台。支持 在客户端上进行配置是否自动更新此配置文件。

7.3.1.2 界面显示模式

登录界面全屏显示中国移动千里眼背景图片,并弹出登录对话框。界面能在各种分辨率 模式下均能正常进行显示。显示效果如图所示。
中国移动千里眼客户端

普通登录方式

?USBkey登录方式

?手机号码登录方式

账号: 密码:

记住密码

服务器地址:

端口:

类型: 地址: 用户名:

代理服务器设置

不使用代理服务器

1

端口: 密码:

22

QB-╳╳-╳╳╳-╳╳╳╳
图7-1 PC客户端登陆界面图
7.3.1.3 键盘快捷键定义
“Enter” :用户登录 “Esc” :退出登录界面 “Tab” :光标移动到下一输入框
7.3.2 主界面
7.3.2.1 界面功能
用户登录系统后,进入“千里眼”客户端主界面,主界面主要实现以下功能: ? 设备列表显示 设备列表区初始显示原始分组,“我的分组”栏中显示用户自定义分组。 设备列表顶级列表组中显示设备总数和在线设备数。 ? 视频浏览和控制 在主界面中,能通过设备列表或电子地图方式实现视频播放。能够进行前端云镜控制, 视频画面的区域分隔。对画面进行抓拍、本地录像等。 ? 录像回放 展开录像回放面板,可进行本地录像文件和中心录像、前端录像文件的回放。 ? 报警信息显示与接收 当有报警产生时,报警面板进行闪动,直到用户打开报警接收面板,点击接警动作为止。 当有报警信息产生时,界面自动弹出电子地图覆盖视频区域。报警点闪动。此项功能可 通过报警配置界面开关。 当有报警产生时,视频区域自动弹出报警联动的视频画面,有新报警产生时,弹出的视 频窗口显示新的联动视频画面。若报警同时须弹出电子地图,弹出的报警联动视频窗口需在 电子地图窗口之上。此项功能可通过报警配置界面开关。 当有报警信息产生时,客户端有报警声音产生,此项功能可通过报警配置界面开关。
7.3.2.2 显示模式
界面在1024*768、1280*1024等各种分辨率模式下能进行正常显示,客户端能够根据屏 幕分辨率自动匹配显示模式。在显示屏幕分辨率与界面分辨率不符合时,能够根据屏幕分辨 满屏显示界面。
主界面主要包含如下区域:标题栏、菜单栏、标签栏、工具栏、设备列表和控制面板侧 边栏、视频显示区、底部操作区、状态栏。其中设备列表和控制面板侧边栏支持配置在左侧 或右侧显示,默认为左侧。侧边栏支持展开和折叠,以扩大视频显示区,默认情况下为展开。
支持各区域灵活拖动布局界面,可将各区域拖动成浮动窗口。 主界面的整体布局如下图所示:
23

QB-╳╳-╳╳╳-╳╳╳╳

移动千里眼Logo

标题栏 主菜单栏 视图切换标签区
工具栏

企业自定义Logo

设备列表显示区

显示画面

显示画面

云镜控制区折叠条







云镜控制区







录像回放区折叠条 钮

录像回放区

显示画面

显示画面

报警接收区折叠条

报警显示区

录像回放VCR控制区 录像时间轴显示区
状态栏
图7-2 主界面布局图

监控预案操作区

7.3.2.2.1 各区域功能说明

界面中各区域的功能简要说明如图所示:

标题栏

(菜单项…)

主菜单栏

视图切换标签区 (视图标签:如视频浏览、录像管理、电子地图、电视墙等…)

移动千里眼Logo (工具栏按钮…)

工具栏

企业自定义Logo

设备列表显示区

(显示默认设备分组、 我的分组、属性分组)

云镜控制区折叠条







云镜控制区



(上下左右、拉近拉远、 叠 光圈、预置位等按钮) 按

录像回放区折叠条 钮

录像回放区 (按天查询录像) 报警接收区折叠条

显示画面

显示画面

(支持多种分屏模式显示)

显示画面

显示画面

报警显示区 (分类显示实时告警信息)

录像回放VCR控制区 (控制按钮、进度条...)

监控预案操作区

录像时间轴显示区 (显示时间轴、定位播放控制等...)

状态栏(显示与服务器之间的连接状态,操作权限等…)

图7-3 界面区域功能图

区域功能说明如下: (1) 标题栏:显示程序标题以及当前所在的视图页,例如“中国移动千里眼客户端 - [视 频浏览]”。 (2) 主菜单栏:显示系统的主菜单。 (3) 视频切换标签区:显示程序所包含的所有视图,用户点击标签实现各视图之间的切 换显示,当前所在的视图以按下状态区别显示。视图主要包含:视频浏览、录像管理、快照 管理、告警管理、电子地图、电视墙、帮助等。显示效果如图:

图7-4 视频切换标签图 (4) 工具栏:分为三部分,最左侧显示中国移动千里眼Logo;最右侧显示企业自定义的 Logo,可由用户在平台提供的自服务门户中进行配置,客户端登录成功后会从服务器下载该
24

QB-╳╳-╳╳╳-╳╳╳╳
企业的Logo图片并显示;中间部分为工具栏按钮区,放置常用的功能按钮,例如:重登录、 本地录像、本地快照、全屏显示、分屏控制、监控预案、锁屏、音量调节等功能按钮。
(5) 设备列表和控制面板侧边栏:包括: a) 设备列表显示区:固定显示,不可隐藏,支持按默认设备分组、我的分组(用
户自定义分组)两种方式显示,通过标签实现切换。详见“设备列表显示”小节。 b) 云镜控制操作区:支持上下左右、拉近拉远、光圈、预置位、巡航路线、辅助
开关(灯光、雨刷、风扇)等控制操作。详见“云镜控制面板”小节。 c) 录像回放操作区:在设备列表区选择需要回放的监控点,支持选择按天和录像
类型等条件进行查询并显示查询到的录像文件列表,点击文件可进行录像回放。可选择 回放前端录像、平台录像、客户端录像。详见“录像回放面板”小节。
d) 报警显示区:支持分类显示实时告警信息。详见“报警接收面板”小节。 (6) 视频显示区域:支持以多种分屏模式显示视频播放窗口。 (7) 底部操作区:分为几部分,包括:
a) 录像回放控制区:当选中窗口正在进行录像回放时,底部的录像回放控制区按 钮变为可操作状态,支持进行暂停、继续、快进、快退、快放、慢放、单帧放、定位播 放等VCR控制操作。并支持显示播放进度条。
b) 录像时间轴显示区:按天查询录像文件后,时间轴显示全天的录像分布,并支 持按不同颜色显示不同类型的路线,如告警录像、定时录像、手动录像。支持在时间轴 上点击某个时间并进行录像回放。
图7-5 录像控制区图 c) 监控预案操作区:支持快捷调用已定义的监控预案,点击右键支持配置监控预 案信息。界面如图:
图7-6 预案操作图
(8) 状态栏:支持显示当前登录用户名、与服务器之间的连接状态(正常、 断开)、对当前选中监控点的操作权限。
7.3.2.2.2 设备列表显示
支持按默认设备分组、我的分组(用户自定义分组)两种方式显示,可通过标签实现切换。 默认设备列表显示效果如图7-7; 我的分组(自定义分组)效果如图7-8;
25

QB-╳╳-╳╳╳-╳╳╳╳

图7-7 设备列表图

图7-8 用户分组图

缺省显示一级列表,当设备名称,列表区无法全部显示时,当鼠标移动至该设备,则显

示全部设备名。

支持输入关键字对监控点名称进行模糊查询,此时设备列表中过滤显示符合条件的监控

点名称。

设备列表中均支持按组统计在线摄像头数目、离线摄像头数目和总摄像头数。

在我的分组中,支持由用户自定义完整的树形结构,支持创建和删除自定义组名称,并

通过上移、下移、左移、右移、拖拽等操作由用户配置自定义的树形显示结构,自定义分组

信息保存在客户端本地。其中:上移、下移是指可以对监控点(或监控点组)在当前组内调

整上下顺序;左移、右移是指可以将监控点(或监控点组)移动到其父亲组或者孩子组中;

拖拽是指可以直接鼠标拖拽监控点(或监控点组)到指定的组中。

7.3.2.2.3 云镜控制面板

默认情况下云镜控制基本显示为如下界面,主要包含云台方向控制、镜头拉近拉远、自 动扫描、聚焦增减、自动聚焦、光圈增减、自动光圈、步长设置、快捷预置位调用等按钮。

云镜控制区折叠条





锁 定





聚焦增 聚焦减 自动聚焦

光圈增 光圈减 自动光圈

拉近 拉远 扫描开 扫描关

步长

1

2

3

4

扩展区

图7-10 云镜控制区图 点击扩展区按钮可以展开云镜控制详细面板,如下图所示,支持预置位调用、删除、编 辑,支持巡航路线开始、停止、配置,支持辅助开关(灯光、雨刷、风扇)的开启、关闭功 能。

26

QB-╳╳-╳╳╳-╳╳╳╳

云镜控制区折叠条





锁 定





聚焦增 聚焦减 自动聚焦

光圈增 光圈减 自动光圈

拉近 1

拉远 扫描开 扫描关

2

3

4

步长 扩展区

预置位: 预置位01 辅助开关: 灯光 巡航路线: 路线01

调用 删除 编辑 打开 关闭 编辑 开始 停止 编辑

图7-11 云镜详细面板图 当用户无云镜控制权限时,控制面板的按钮须灰掉。

7.3.2.2.4 录像回放面板

录像回放面板按时间、存储位置(包括客户端、平台录像、前端录像)、录像类型(例 如全部、定时录像、手动录像、告警录像等)进行录像文件查询,查询文件列表弹出浮动在 界面上,在弹出界面操作进行录像回放。

图7-12 录像回放面板图

7.3.2.2.5 录像管理界面

录像管理界面按时间段(开始时间、结束时间)、录像类型(定时录像、手动录像、报 警录像等)、录像存储位置(客户端本地、平台录像、前端录像)进行录像文件查询。查询 结果采用列表方式展示,并支持分页和按列排序等操作。支持对查询到的录像文件结果进行 录像播放和录像下载。

移动千里眼Logo

标题栏 主菜单栏 视图切换标签区(“录像管理”视图)
工具栏

企业自定义Logo

设备列表显示区
侧 边 栏 折 叠 按 钮 查询条件输入区
录像开始时间: 录像结束时间:
录像类型: 录像位置:
查询

录像查询结果显示区
录像下载任务区 状态栏

27

QB-╳╳-╳╳╳-╳╳╳╳
图7-13 录像管理界面图
7.3.2.2.6 报警接收面板
当有报警信息时,报警接收面板标题栏及改变的告警数目进行闪烁显示,面板中分类显 示每种报警种类的未确认条目和已确认条目,点击后可弹出详细报警信息列表界面,可进行 告警确认、设备报警录像即时回放、设备实时视频播放等操作。

7.3.2.3 主界面操作规范

图7-14 报警接收面板图

7.3.2.3.1 设备列表操作
(1)监控点选取 支持在设备列表中通过不同的图标显示监控点的云台类型(枪机、球机)、在线状态(在
线、离线)等。 在录像查询、快照查询、告警查询等界面中,设备列表中监控点前显示复选框,支持多
选监控点进行批量查询。
(2)设备列表模糊查询 支持在设备列表搜索框中输入关键字进行查询,具体规则如下: 1、字母(数字或汉字),则查询以字母(数字或汉字)开始的监控点;如输入z,则显
示监控点名称以z开头或名称的拼音首字母为z的监控点,例如:钟楼、中国移动; 2、字母(数字或汉字)+*,结果与1相同; 3、*+字母(数字或汉字),则查询以字母(数字或汉字)为结尾的监控的;如输入*yd,
则显示监控点名称以yd结尾或名称结尾的汉字拼音首字母为yd的监控点,例如:上海移动、 浙江移动;
4、字母(数字或汉字)+*+字母(数字或汉字),则查询以字母(数字或汉字)为开始 和结尾的监控的;如输入 h*d,则显示监控点名称以h开始并且以d结尾,或名称的一个汉字 的拼音首字母为h并且结尾的汉字拼音首字母为d的监控点,例如:湖南移动、湖北移动、河 南移动、河北移动;
5、*+字母(数字或汉字)+*,则查询监控点名称中包含该字母(数字或汉字),如输入 *j*,则显示监控点名称中含 j 或名称中含拼音首字母为 j 的监控点,例如:浙江移动、福 建移动。

28

QB-╳╳-╳╳╳-╳╳╳╳
7.3.2.3.2 视频播放操作
(1)选择指定监控点播放 ? 设备列表选点 选中左侧设备列表,双击某前端设备,该前端图像自动显示在视频显示区域内。 可通过使用鼠标左键通过拖曳的方式,将该路视频拖到指定的视频区域内。 ? 电子地图选点 点击设备列表区“电子地图”按钮,弹出电子地图,在地图界面上,点击前端设备点 进行播放。 ? 视频请求过程信息反馈 在视频请求过程中,要求在画面中间依次给出视频请求过程中文字反馈包括“正在请 求视频”、“连接成功”、“连接失败”等即时信息反馈。 ? 多平台操作支持 支持在同一视频浏览区域播放来自多个平台的监控点视频。
(2)视频窗口显示顺序 实时视频浏览、录像回放、报警录像回放需在视频窗口中显示,视频显示使用的窗口需
按以下原则确定: 有空闲视频窗口时,遵循从左往右、自上而下的排列顺序显示视频。 视频窗口全满时,按左往右、自上而下的排列顺序覆盖显示,客户端需记忆显示队列,
依次覆盖。
(3)视频控制 可通过左下侧视频控制面板进行镜头转动、焦距/亮度调节、预置位设置/删除/转到等。 鼠标左键单击某视频区域,进行拖曳时,画面显示方向箭头,进行镜头方向调节。 选中某视频区域时,滚动鼠标滑轮,图像进行拉近、拉远调节。 点击工具栏中停止图像按钮或右键菜单选项停止视频播放。
(4)录像回放 ? 录像回放 打开录像回放面板,在设备列表中选中需要播放的设备,按时间段检索录像文件,检索 录像类型、文件存储位置,弹出录像文件列表,点击录像文件,在视频框中回放历史图 像。视频区域占用遵循从左往右、自上而下的顺序。 注:年/月/日输入以时间插件方式实现。 ? 多画面回放 多画面同时回放时,可通过ctrl或shift键多选视频区域,进行同步回放控制。 可在24小时内,选取指定时间点进行播放。
(5)轮巡播放 支持配置轮巡播放,支持配置轮巡列表中包含的监控点顺序、轮巡时间间隔,并支持在
指定的播放窗口中启动和停止轮巡播放。 支持将多路图像画面按住ctrl键然后拖入同一视频显示框内,实现多路图像的轮流显
示。在拖入多路图像时,弹出对话框,由用户选择轮巡时间间隔。多画面显示时,多个视频 框能同时进行轮巡。
29

QB-╳╳-╳╳╳-╳╳╳╳
(6)监控预案 画面布局保存按钮在视频界面下方,初始打开页面布局栏显示为“默认”界面,用户不
进行保存操作时,该页面布局不保存。 右键单击布局 Tab按钮,展开右键菜单栏。通过右键菜单栏可进行画面布局保存、重命
名、删除等操作。 布局按钮栏可显示4个布局按钮,按照布局建立时间顺序倒序排列。更多布局通过点击
“〉〉”按钮展开。左键点击布局 Tab按钮,展开该布局页面。
7.3.2.3.3 视频区界面显示和操作
(1)视频窗口显示 视频区域上方可显示视频信息,包括监控点全称,通过右键菜单选项选择是否显示该信
息。码流信息可在配置管理中进行配置。 正常显示状态时,线条显色为白色;选取该视频框后时,线条显示颜色为黄色;该视频
区域有报警信号时,线条显示为红色。
(2)分屏模式控制 点击工具栏或者主菜单中的“分屏模式选择”,弹出分屏模式方案选择面板,可选择指
定的分屏模式对画面进行分割显示。 默认分屏模式支持1分屏、4分屏、6分屏、8分屏、9分屏、16分屏等。
(3)全屏播放 支持正常模式播放、单画面全屏、多画面全屏等多种显示方式: ? 单画面全屏 选中视频区域,左键双击该画面或在视频分割选项中选择单屏显示,实现视频单屏显示。 ? 多画面全屏 点击视频区域全屏按钮(或快捷键F3),视频区域可实现多画面全屏显示,按“Esc” 键返回正常显示界面。 视频区域多画面全屏显示时,双击某视频画面,该视频全屏显示,再次双击回到多画面 全屏显示状态。按“Esc”键返回正常显示界面。
(4)视频窗口焦点选择 视频参数操作、云台操作、回放VCR操作须针对选中的焦点视频窗口进行: ? 单击视频窗口,可实现焦点选择; ? 按 Ctrl 并使用鼠标左键单击视频窗口,可点中的各视频窗口实现焦点多选; ? 按 Shift 并使用鼠标左键单击视频窗口,可选中区域视频窗口实现焦点连选; ? 鼠标左键点击界面空白区域,则焦点消失。
(5)视频区右键菜单定义 视频区右键菜单包括如下内容,其中单画面全屏、视频停止、前端信息显示、快照、开
始本地录像、停止本地录像、前端参数配置等选项。
30

QB-╳╳-╳╳╳-╳╳╳╳

7.3.2.3.4 语音对讲

选中一路正在播放的视频画面,单击语音呼叫按钮实现与前端设备进行语音通讯。语音 连接成功或失败后,弹出结果确认框。通讯过程中,拖动按钮右侧拖动条,改变音量大小。 通讯链路连接成功后,按钮显示为高亮色。通讯过程中,再次点击此按钮,则此次通讯断开。
语音通信链路自动断开时,弹出提示框。语音按钮恢复到初始状态。

7.3.2.3.5 报警界面展示

? 报警接收面板闪动 有报警信息时,报警面板闪动,并不断更新分类告警数目显示。点击报警面板,弹出报 警信息详细列表对话框,在报警列表中支持对报警信息按时间倒序或顺序排列。并支持 对报警信息进行确认和清除等操作。 ? 电子地图打开状态下,弹出报警电子地图,报警设备点标记闪动。若同时需弹出报 警视频窗口,需将报警视频窗口叠加于顶层。 ? 客户端支持报警声音设置,当报警发生时客户端播放预设的音频,支持播放WAV和 MP3格式的音频。

7.3.2.3.6 快捷键定义

表7-1 操作快捷键列表

帮助

F1

重登录

F2

多画面全屏

F3

单画面全屏

F4,SPACE,鼠标双击

显示/隐藏播放窗口前端信息 F10

锁屏/解锁

F12

全屏状态返回

ESC

画面焦点选择

Tab

调节音量

Home增大音量,End减小音量

调节焦距

Pageup聚焦增,Pagedown聚焦减

云镜方向控制

方向键上下左右

云镜控制光圈增减

Ctrl+方向键上,下

云镜控制拉远拉近

Ctrl+方向键左,右

分屏显示按钮

键盘数字键,连续变化时,最小操作

间隔为3S。两位数界面显示时,两按

钮操作间隔小于 3S。

7.3.3 配置界面 配置界面包括中心录像设置、报警联动设置、用户配置信息设置、设备信息配置等子页
31

QB-╳╳-╳╳╳-╳╳╳╳
面。页面之间以标签形式切换。 支持配置摄像头的音视频参数配置,包括: ? 图像多种分辨率控制设置,支持PAL/NTSC制式选择; ? 视频帧率、比特率、关键帧间隔设置; ? 视频图像参数(色度、饱和度、对比度、亮度)设置; ? 图像质量(差、普通、较好、好、最好)选择设置; ? 码流控制(VBR、CBR)选择设置; ? 视频图像字符叠加; ? 视频图像屏蔽设置; ? 帧类型设置; ? 音频通道使能。 支持对设备内存储设备容量信息进行上报,并支持客户端对硬盘进行格式化操作。
7.3.4 报警联动
在该界面中实现设置平台、前端、客户端的报警联动功能,支持设置报警联动预置位、 联动快照、联动录像等功能。
支持配置告警联动短信通知,可设置接收短信通知的手机号码,支持配置多个。 支持配置告警联动彩信通知,可设置接受彩信的手机号码,支持配置多个。 支持配置告警联动Email通知,可设置告警接受的Email地址。 支持配置告警联动语音通知,可配置接收告警信息的电话号码。
7.3.5 电视墙控制
在该界面中实现客户端对大屏电视墙的控制功能,包括设置电视墙播放指定监控点、多 画面巡视等。
7.3.6 客户端上载视频
在该界面中实现用户主动上载视频功能,并能把视频共享给其他用户,由其他用户进行 浏览或者下载。上载的视频默认只有上载的用户可以进行浏览和下载,但上载用户可决定是 否共享给同客户下用户进行浏览和下载。上载的视频必须经过客户管理员和移动管理员进行 业务审批后才可以发布。
客户端上支持查询其授权范围内的视频文件列表,并支持回放和下载。 客户端上载的视频必须为流化过的3GP、MP4文件,客户端支持对3GP、MP4和AVI文件的 流化处理。
7.3.7 日志功能
在该界面中能够实现各种日志的分别显示,包括用户操作日志、报警联动日志、系统日 志等,实现日志的定时更新显示。可根据设备名、用户名、时间段等对日志进行模糊查询。
32

QB-╳╳-╳╳╳-╳╳╳╳
7.3.8 客户端同时登录多平台功能 当客户端同时登录到多个平台时,整体界面布局不变,设备列表显示区域中采用多个Tab
页分别显示不同平台的设备列表。未登录成功的平台不能点击和操作。界面示意图如下:
图7-15 多平台管理界面图 在主菜单栏中增加平台登录管理界面,其中能展示当前管理的各平台的列表,并分别显 示连接状态,并能进行手动连接和断开操作。界面如下图所示:
图7-16 平台登陆管理界面图
支持在实时浏览界面中同时播放不同平台的监控点视频。对于轮巡播放、监 控预案以及录像查询、录像计划设置、抓拍图片查询、告警查询等功能中的批量 查询或批量操作时,仅支持同时对单个平台的多个监控点进行批量操作。
8. PC 浏览器
8.1 扩展功能要求 支持通过IE浏览器+Web插件的方式实现B/S模式的视频监控业务功能,重点面向中小企
业、家庭个人提供视频监控业务,主要功能描述如下: (A) 总体要求: 1. 支持Windows XP、2003、7等操作系统和IE 6.0、7.0、8.0浏览器; 2. Web页面中支持插件安装检测,当插件未安装时提示用户首先下载并安装插件后再 进行使用; 3. Web插件支持自动升级功能; (B) 登录和设备列表相关: 4. 支持在Web页面中进行登录认证控制;
33

QB-╳╳-╳╳╳-╳╳╳╳
5. Web页面中支持展示设备列表,并展示在线状态; 6. 支持修改监控点的名称; 7. 支持修改用户的登录密码; (C) 实时浏览相关: 8. 支持远程实时视频浏览,用户通过点击列表中的监控点可实现视频浏览; 9. 支持码流选择和直连或中转方式选择; 10. 支持多分屏模式进行视频浏览,可选择1、4、9等分屏模式; 11. 支持用户操作单画面全屏、多画面全屏显示; 12. 支持视频上叠加时间、名称等信息; (D) 云镜控制相关: 13. 支持用户对指定监控点进行云镜控制,可向上、下、左、右方向转动云台和拉近拉
远等操作,并支持设置步长; 14. 支持用户调节光圈、对比度、亮度; (E) 快照相关: 15. 支持设置本地快照的默认保存路径; 16. 支持对当前播放视频进行本地快照抓拍,图片保存格式为JPEG或BMP; 17. 支持查询本地的快照图片并在Web页中展示; (F) 录像相关: 18. 支持设置本地录像默认保存路径; 19. 支持用户自行操作客户端手动录像,用户可手动控制开始和停止本地录像; 20. 支持展示客户端本地录像状态,在视频上叠加录像图标和已录制时间; 21. 支持控制平台、前端的手动录像开始和停止,开始录像接口中可设置录制时长; 22. 支持查询本地、网络、前端的录像文件并在Web页面中展示,支持分页展示查询结
果; 23. 支持播放本地、网络、前端的录像文件; 24. 支持在本地、平台、前端的录像播放过程中进行VCR控制操作,包括开始、停止、
暂停、快放、慢放、快进、快退、定位播放等操作; 25. 支持平台、前端的录像下载,并支持通用播放软件播放(暴风影音、Media Player、
RealPlayer或VLC Player); (G) 告警相关: 26. 支持用户自行选择启用或关闭报警功能;缺省关闭; 27. 支持在Web页上进行实时报警信息显示; 28. 支持查询历史告警信息;
8.2 扩展性能要求
参见PC客户端性能要求。
8.3 UI 要求
由Web插件提供播放窗口界面,Web门户提供其他界面如设备列表展示、云台控制区域、 告警展示、查询界面等;
34

8.3.1 登录界面

QB-╳╳-╳╳╳-╳╳╳╳

8.3.1.1 界面显示功能
登录界面为中国移动千里眼Web客户端的首页面,主要用于用户权限认证,用户正确输 入账号、密码、验证码后点击登录按钮,即可正常进入主界面。
点击验证码图片时可刷新验证码图片显示。
8.3.1.2 界面显示模式
登录界面显示中国移动千里眼背景图片,并显示标题、LOGO、业务介绍等信息。显示效 果如图所示。
中国移动千里眼Web客户端

账号: 密码: 验证码:

登录

验证码图片

图8-1 浏览器登陆界面图
8.3.2 主界面
8.3.2.1 界面功能
主界面主要分为以下几个页面,功能描述如下: (1) 实时浏览页面:用户浏览摄像头的实时视频,可选择分屏查看,并能执行云台 控制、手动录像、手动抓拍等操作; (2) 记录查看页面:用户可查询摄像头的历史录像、快照文件、告警信息,并能录 像回看、VCR控制、浏览快照文件等; (3) 系统设置页面:支持设置摄像头的录像计划、修改摄像头名称;支持设置本地 录像和本地抓拍文件的保存路径;

35

8.3.2.1 显示模式

QB-╳╳-╳╳╳-╳╳╳╳

8.3.2.1.1 实时浏览界面
进入主界面默认进入实时浏览界面:
移动千里眼Logo

页面切换标签 工具栏

设备列表显示区









云镜控制区折叠条

叠 按



云镜控制区

报警接收区折叠条 实时告警列表显示区

显示画面 显示画面

显示画面 显示画面

图8-2 浏览器实时浏览界面图 其中: (1) 页面切换标签中包含“实时浏览”、“记录查看”、“系统设置”页面标签; (2) 工具栏中包括分屏控制按钮(1分屏、4分屏、9分屏)、全屏显示按钮、手动 录像、手动抓拍等; (3) 若当前操作系统中未安装千里眼Web客户端插件,则页面中提示用户首先下载 和安装。

8.3.2.1.2 记录查看界面
记录查看界面整体示意图:
移动千里眼Logo 查询录像

页面切换标签

录像查询区









查询抓拍图片折叠条

叠 按



抓拍图片查询区

查询历史告警折叠条 历史告警查询区

图8-3 视频查看界面图 查询历史录像时,选择待查询监控点、录像类型(平台、前端、本地)、起始时间段进 行查询后,下方显示录像查询结果列表,支持滚动条显示。并支持选择指定录像进行回放,

36

QB-╳╳-╳╳╳-╳╳╳╳

录像在右方的画面区域进行显示,并支持进行VCR控制。界面如下图所示:

移动千里眼Logo
查询录像
监控点: 类型:(录像查询条件区)
时间段: 查询

页面切换标签

(录像查询结果区) 侧







查询抓拍图片折叠条

叠 按



抓拍图片查询区

录像回放画面

查询历史告警折叠条 历史告警查询区

VCR控制区

图8-4 录像回放界面图 查询本地保存的抓拍图片时,选择监控点、起始时间段进行查询,查询结果显示在右方。 界面如下图所示:

移动千里眼Logo 查询录像

页面切换标签 (抓拍图片查询结果显示区)

抓拍图片









查询抓拍图片折叠条

叠 按

监控点: (抓拍图片查 钮 时间段: 询条件区)

查询

查询历史告警折叠条

历史告警查询区

翻页控制

图8-6 图片查询界面图 查询历史告警时,选择待查询监控点、起始时间段进行查询,查询结果以列表形式显示 在右方。界面如下图所示:

37

QB-╳╳-╳╳╳-╳╳╳╳

移动千里眼Logo 查询录像

页面切换标签 (历史告警查询结果显示区)









查询抓拍图片折叠条

叠 按



历史告警列表显示

查询历史告警折叠条
监控点:(历史告警查询区) 时间段:
查询

翻页控制

图8-7 历史告警信息列表图

8.3.2.1.3 系统设置界面

系统设置界面中支持显示和修改录像文件和抓拍文件的本地保存路径名,并支持对前端 进行一些参数配置,包括修改监控点名称、设置前端的录像计划等。界面如下图所示:

移动千里眼Logo

页面切换标签

(参数设置项)

设备列表显示区

修改监控点名称

设置录像文件保存路径

前端录像计划设置

设置抓拍文件保存路径
图8-8 界面设置修改图

9 二次开发控件要求
系统设置界面中支持显示和修改录像文件和抓拍文件的本地保存路径名,并支持对前端 进行一些参数配置,包括修改监控点名称、设置前端的录像计划等。界面如下图所示:

38

9.1 控件开发要求

QB-╳╳-╳╳╳-╳╳╳╳

9.1.1 控件基本要求
1. 支持Windows XP、2003、7等操作系统和IE 6.0、7.0、8.0浏览器。 2. 控件为标准的ActiveX控件。 3. 可在同一进程中生成多个独立的实例。 4. 使用客户端指定的外部窗口播放视频,不使用或隐藏控件内部窗口,不影响外部窗
口获得鼠标和键盘消息。 5. 播放视频过程中,视频画面填满外部窗口,画面大小随外部窗口大小变化。 6. 一个控件实例在登录平台以后,可以同时播放多个设备实时视频。
9.1.2 控件升级说明

控件登录时主动向平台查询控件升级信息,当需要更新版本时,控件通过事件通知方式 主动进行通知,并返回升级包的URL地址,由使用客户端进行HTTP文件下载并替换文件。

9.2 控件基本接口

9.2.1 控件初始化 Initial

接口编号 功能描述 函数原型 参数说明 返回值

表9-1 控件初始化参数表

9-2-1

接口类型

方法

执行控件初始化操作。本方法应该在其他方法调用前被调用。

HRESULT Initial()



执行成功返回 0,错误时返回错误码

9.2.2 控件释放 Free

接口编号
功能描述
函数原型 参数说明 返回值

表9-2 控件释放参数表

9-2-2

接口类型

方法

执行控件内部资源释放操作。调用本方法后,所有正在进行的实时视频播

放、录像回放、录像下载、语音对讲等操作均被停止。

HRESULT Free()



执行成功返回 0,错误时返回错误码

39

QB-╳╳-╳╳╳-╳╳╳╳

9.2.3 获取控件版本 GetVersion

接口编号 功能描述 函数原型 参数说明
返回值

表9-3 控件版本获取参数表

9-2-3

接口类型

方法

获取控件的当前版本号。

BSTR GetVersion()



以字符串形式返回控件的软件版本,命名规则符合《中国移动千里眼客户

端规范》中的要求,例如:“3.03.01”

9.2.4 控件版本升级通知 UpdateInfoNotify

接口编号 功能描述 函数原型

表9-4 控件版本升级通知参数表

9-2-4

接口类型

事件

控件主动向平台查询控件的升级版本信息,当存在更新版本时,通过该事

件进行升级通知,使用客户端收到该事件后,应该按指定URL下载升级包文

件并解压和替换文件。

void UpdateInfoNotify(long nForceUpdate, BSTR sUpdateInfo)

nForceUpdate: 强制升级为1,提示升级为0。 sUpdateInfo:返回XML消息表示升级版本信息和升级包URL地址

参数说明

XML消息格式如下: <Update>
<CurVersion>%s</CurVersion> <LatestVersion>%s</LatestVersion> <UpdateURL>%s</UpdateURL> </Update>

//控件当前版本 //控件的最新版本 //升级包的URL地址

返 回 值 无返回值

9.3 平台相关接口

9.3.1 登录平台 Login

接口编号 功能描述 函数原型

表9-5 平台登陆参数表

9-3-1

接口类型

方法

本方法用于登录SCC中心服务器平台。必须在成功登录到平台后,控件的其

他功能才能正常使用。

此接口为异步方式,调用后函数立即返回。当与平台交互完成后,通过

LoginResultNotify事件通知客户端是否登录成功。

HRESULT Login(BSTR sIP, long nPort, BSTR sDomain, BSTR sName, BSTR

40

参数说明 返回值

QB-╳╳-╳╳╳-╳╳╳╳
sPassword,long lType) sIP: 平台IP地址 sPort: 平台端口 sDomain: 平台域名(可以为空) sName: 用户名称 sPassward: 用户密码 lType:登录方式,0:账号登录方式;1:手机号码登录方式(留作扩展, 目前该参数只支持账号登录方式) 执行成功返回 0,错误时返回错误码

9.3.2 登录平台结果通知 LoginResultNotify

接口编号 功能描述 函数原型 参数说明 返回值

表9-6 平台登陆结果通知参数表

9-3-2

接口类型

事件

返回登录平台操作结果的事件通知。由控件主动触发,客户端需响应该事

件并判断登录结果为成功后再进行其他操作,如获取设备列表。

void LoginResultNotify(long nStatusCode)

nStatusCode:操作结果状态码 200:成功,401:失败

无返回值

9.3.3 从平台注销 Logout

接口编号
功能描述
函数原型 参数说明 返回值

表9-7 从平台注销参数表

9-3-3

接口类型

方法

中断与平台服务器之间的连接。此接口为异步方式,调用后立即返回。使

用LogoutResultNotify事件通知用户是否退出成功。

HRESULT Logout()

无参数

执行成功返回 0,错误时返回错误码

9.3.4 从平台注销结果通知 LogoutResultNotify

接口编号 功能描述 函数原型
参数说明
返回值

表9-8 从平台注销结果通知表

9-3-4

接口类型

事件

返回从平台注销操作结果的事件通知。

void LogoutResultNotify(long nStatusCode)

nStatusCode:操作结果状态码 200:成功,401:失败

无返回值

41

QB-╳╳-╳╳╳-╳╳╳╳
9.3.5 获取设备列表 GetDeviceList

接口编号 功能描述 函数原型
参数说明
返回值

表9-9 获取设备列表参数表

9-3-5

接口类型

方法

获取设备列表。此方法为异步接口,调用此接口后立即返回,设备列表信

息通过异步事件DeviceListResultNotify中进行传送。

HRESULT GetDeviceList(BSTR sGroupID)

sGroupID:组标识:传入参数为空字符串时,返回根组下第一层的设备列

表;若传入参数为某组的标识,则返回该组下的第一层的列表。

注:获取设备列表每次只返回树形结构的第一层次的设备列表,客户端需

要递归进行调用以获取完整的设备列表。

执行成功返回 0,错误时返回错误码

9.3.6 设备列表结果返回通知 DeviceListResultNotify

接口编号 功能描述 函数原型
参数说明

表9-10 从设备列表返回结果通知参数表

9-3-6

接口类型

事件

设备列表结果返回通知。控件保证设备列表数据必须是以组为单位完整的

数据。

void DeviceListResultNotify(long nStatusCode, BSTR sDeviceList)

nStatusCode:操作结果状态码 200:成功,401:失败

sDeviceList:设备列表详细信息,包括子组信息、摄像头列表信息等。以

XML格式返回数据。

XML格式如下:

<group id=“” name=“中国移动设备组”>

<group id=“101” name =”子组-01”/> //表示一个子组的信息

<group id=“102” name =”子组-02”/>

……

<camera id=“<摄像头编号>”

vcuid=“<VCU编号>”

//摄像头所对应的VCU编号

name=“”

//摄像头名称

PTZType=“”

//云台类型

detailname=“”

//详细名称

status=“online/offline”

//摄像头在线状态

property1=“[name]:[type]”

//属性信息

property2=“[name]:[type]”

property3=“[name]:[type]”

property4=“[name]:[type]”

property5=“[name]:[type]”

remark=””

//备注信息

>

<rights

//用户对此摄像头的操作权限

DeviceManage=“0”

//设备管理权限

42

QB-╳╳-╳╳╳-╳╳╳╳

AlarmManage=“1”

//告警管理权限

RecordView=“1”

//录像浏览权限(查询录像和播放)

RecordManage=“0” //录像管理权限(录像计划、配置)

Talk=“1”

//语音对讲权限

PTZ=“9”

//云台控制权限

/>

<videolist>

//摄像头的码流信息列表

<video streamid=“<码流编号>”

Format=“H264”

//编码格式

Resolution=“CIF”

//分辨率

BitRate=“512”

//码率

IFrame=“2”

//I帧周期

/>

//第一路码流信息

<video … />

//第二路码流信息

</videolist>



</camera>

<camera … />

……

</group>

XML元素说明:

(1) group id 组唯一标识。如果是根组,则为空字符串。注:返回的子组

中只返回子组的id和name,不返回下层组的详细列表。

(2) PTZType 云台类型:2:球机;1:有云台枪机;0:固定枪机

(3) status 摄像头状态信息:online=在线;offline=离线;

(4) property1-5 属性信息:[name]=属性名;[type]=类型名

(5) rights 用户对摄像头的操作权限,其中PTZ属性为云台控制权限,分

为0-9个等级,0表示无权限,1-9表示云台控制的优先级;其他的权限

如Admin、Alarm…均为:0表示无权限,1表示有权限。

(6) videolist 摄像头的码流信息,可包含多个子video标签。

返 回 值 无返回值

9.3.7 获取摄像头信息 GetCameraInfo

接口编号
功能描述
函数原型 参数说明 返回值

表9-11 获取摄像头信息参数表

9-3-7

接口类型

方法

获取指定单个摄像头信息。通过摄像头的唯一编号获取摄像头的详细信息。

此接口为异步接口,调用此方法后立即返回,摄像头详细信息在控件异步

消息CameraInfoResultNotify中传送。

HRESULT GetCameraInfo(BSTR sCameraID)

sCameraID:摄像头唯一标识

执行成功返回 0,错误时返回错误码

43

QB-╳╳-╳╳╳-╳╳╳╳

9.3.8 获取摄像头信息结果通知 CameraInfoResultNotify

接口编号 功能描述 函数原型
参数说明

表9-12 获取摄像头信息结果通知参数表

9-3-8

接口类型

事件

返回摄像头详细信息的事件通知。

void CameraInfoResultNotify(long nStatusCode , BSTR sCameraInfo)

nStatusCode:操作结果状态码 200:成功,401:失败

sCameraInfo:摄像头的详细信息,XML形式,格式如下:

<group id=“” name=“中国移动设备组”>

<camera id=“<摄像头编号>”

vcuid=“<VCU编号>”

//摄像头所对应的VCU编号

name=“”

//摄像头名称

PTZType=“”

//云台类型

detailname=“”

//详细名称

status=“online/offline”

//摄像头在线状态

property1=“[name]:[type]”

//属性信息

property2=“[name]:[type]”

property3=“[name]:[type]”

property4=“[name]:[type]”

property5=“[name]:[type]”

remark=””

//备注信息

>

<rights

//用户对此摄像头的操作权限

Admin=“0”

//设备管理权限

Alarm=“1”

//告警权限

RecordView=“1”

//录像浏览权限(查询录像和播放)

RecordAdmin=“0” //录像管理权限(录像计划、配置)

Talk=“1”

//语音对讲权限

PTZ=“9”

//云台控制权限

PTZAdmin=“0” /> //云台管理权限

<videolist>

//摄像头的码流信息列表

<video streamid=“<码流编号>”

Format=“H264”

//编码格式

Resolution=“CIF”

//分辨率

BitRate=“512”

//码率

IFrame=“2”

//I帧周期

/>

//第一路码流信息

<video … />

//第二路码流信息

</videolist>



</camera>

</group>

XML格式解释同“设备列表结果返回通知”接口。

44

返回值

QB-╳╳-╳╳╳-╳╳╳╳
无返回值

9.3.9 摄像头在线状态变更通知 CameraStatusNotify

接口编号 功能描述 函数原型
参数说明
返回值

表9-13 摄像头在线状态变更参数表

9-3-9

接口类型

事件

当摄像头在线状态发生变更时,控件自动触发此事件。

HRESULT CameraSatusNotify(BSTR sCameraID, long nStatus)

sCameraID:状态发生变更的摄像头编号

nStatus: 状态值 0:下线;1:上线。

无返回值

9.4 播放视频相关接口

9.4.1 开始播放实时视频 PlayRealVideo

接口编号 功能描述 函数原型
参数说明

表9-14 视频播放参数表

9-4-1

接口类型

方法

开始播放指定摄像头的实时视频。

成功后,会在目的窗口播放实时视频。支持在调用时选择通道的码流编号,

比如主码流或者辅码流。支持选择网络连接方式例如直连或者中转。停止

播放时可调用Close接口。

HRESULT PlayRealVideo(long hWnd, BSTR sCameraID, long nStreamID,

long nLinkType)

hWnd:播放视频的窗口句柄

sCameraID:摄像头唯一标识

nStreamID:码流编号(码流编号从1开始,如果填0表示自动选择默认码流)

nLinkType:连接模式,分别为0:自动选择连接模式;1:网络直连模式;

2:网络中转模式

返回值

注:控件需支持同时播放多路视频,若传入一个新的窗口句柄hWnd值时, 表示在新的窗口中进行播放,原有其他已经在播放的视频不受影响;若传 入原窗口句柄值,则表示覆盖原有播放。下同。 执行成功返回 0,错误时返回错误码

9.4.2 播放平台录像 PlayRecord

接口编号 功能描述

表9-15 播放平台录像文件参数表

9-4-2

接口类型

方法

播放平台录像文件。

停止播放时可调用Close接口。

45

函数原型 参数说明 返回值

QB-╳╳-╳╳╳-╳╳╳╳
HRESULT PlayRecord(long hWnd, BSTR sContentID, BSTR sStartTime, BSTR sEndTime) hWnd:窗口句柄。 sContentID:平台录像文件的ID sStartTime:录像起始时间 sEndTime:录像结束时间 其中时间格式为“YYYY-MM-DD HH:MM:SS” 执行成功返回 0,错误时返回错误码

9.4.3 播放前端录像 PlayRecordVCU

接口编号 功能描述 函数原型
参数说明
返回值

表9-16 平台登陆参数表播放前端录像

9-4-3

接口类型

方法

播放前端录像文件。

停止播放时可调用Close接口。

HRESULT PlayRecordVCU(long hWnd, BSTR sVCUID, BSTR sFileID,BSTR

sStartTime, BSTR sEndTime ,long nLinkType)

hWnd:窗口句柄。

sVCUID: 前端设备编号

sFileID:前端录像文件的ID

sStartTime:录像起始时间,

sEndTime:录像结束时间

nLinkType:连接模式,分别为0:自动选择连接模式;1:网络直连模式;

2:网络中转模式

其中时间格式为“YYYY-MM-DD HH:MM:SS”

执行成功返回 0,错误时返回错误码

9.4.4 播放本地录像 PlayRecordLocal

接口编号 功能描述 函数原型 参数说明 返回值

表9-17 播放本地录像参数表

9-4-4

接口类型

方法

播放客户端本地录像文件。

停止播放时可调用Close接口。

HRESULT PlayRecordLocal(long hWnd, BSTR sFileName)

hWnd:窗口句柄。

sFileName:要播放的本地录像文件完整路径名。

执行成功返回 0,错误时返回错误码

9.4.5 关闭视频播放 Close

接口编号 9-4-5

表9-18 关闭视频播放参数表

接口类型

方法

46

功能描述 函数原型 参数说明 返回值

QB-╳╳-╳╳╳-╳╳╳╳
关闭指定窗口的视频播放。可以停止实时视频播放,也可以停止录像回放。 HRESULT Close(long hWnd) hWnd:播放视频的窗口句柄 执行成功返回 0,错误时返回错误码

9.4.6 关闭所有窗口的视频播放 CloseAll

接口编号 功能描述 函数原型 参数说明 返回值

表9-19 关闭所有窗口视频播放参数表

9-4-6

接口类型

方法

关闭所有窗口的视频播放。将控件当前所有正在进行的播放全部停止。

HRESULT CloseAll()



执行成功返回 0,错误时返回错误码

9.5 播放控制相关接口

9.5.1 继续播放 Play

接口编号 功能描述 函数原型 参数说明 返回值

表9-20 继续播放参数表

9-5-1

接口类型

方法

继续播放,录像回放的VCR操作,可将视频从暂停播放状态转为播放状态。

HRESULT Play(long hWnd)

hWnd:窗口句柄

执行成功返回 0,错误时返回错误码

9.5.2 暂停播放 Pause

接口编号 功能描述 函数原型 参数说明 返回值

表9-21 暂停播放参数表

9-5-2

接口类型

方法

暂停播放,录像回放时的VCR操作,将视频从播放状态进入暂停状态。

HRESULT Pause(long hWnd)

hWnd:窗口句柄

执行成功返回 0,错误时返回错误码

9.5.3 快进或快退播放 SetPlayRate

接口编号 功能描述 函数原型 参数说明

表9-22 快进或快退播放参数表

9-5-3

接口类型

方法

快进或者快退操作,录像回放时的VCR操作。

HRESULT SetPlayRate(long hWnd,long lRateValue)

hWnd:窗口句柄

47

QB-╳╳-╳╳╳-╳╳╳╳
lRateValue:快进或快退速率,定义如下: 32: 32倍速快进 16: 16倍速快进 8: 8倍速快进 4: 4倍速快进 2: 2倍速快进 1: 正常速率播放 -1: 1倍速快退 -2: 2倍速快退 -4: 4倍速快退 -8: 8倍速快退 -16:16倍速快退 -32: 32倍速快退

返回值

注:本地录像回放时不支持快退操作。 执行成功返回 0,错误时返回错误码

9.5.4 倍速播放 SetPlaySpeed

接口编号 功能描述 函数原型
参数说明
返回值

表9-23 倍速播放参数表

9-5-4

接口类型

方法

倍速播放,VCR操作,实现快放或者慢放。

HRESULT SetPlaySpeed (long hWnd,long lSpeedValue)

hWnd:窗口句柄

lSpeedValue:播放速度,定义如下:

16:16 倍速

8: 8 倍速

4: 4 倍速

2: 2 倍速

1: 常速

-2: 1/2 慢速

-4: 1/4 慢速

-8: 1/8 慢速

-16:1/16 慢速

执行成功返回 0,错误时返回错误码

9.5.5 获取录像总时长 GetTotalTime

接口编号 功能描述 函数原型 参数说明

表9-24 获取录像时长参数表

9-5-5

接口类型

获取录像总时长。

long GetTotalTime(long hWnd)

hWnd:窗口句柄

方法

48

返回值

QB-╳╳-╳╳╳-╳╳╳╳
返回指定窗口中当前正在播放的录像文件的总时长(单位为秒)。

9.5.6 获取录像当前播放位置 GetPosition

接口编号 功能描述 函数原型 参数说明 返回值

表9-25 获取录像当前播放位置参数表

9-5-6

接口类型

方法

读取录像文件当前的播放的相对位置

long GetPosition(long hWnd)

hWnd:窗口句柄

返回指定窗口中当前正在播放的录像的当前播放位置(单位为秒)。

9.5.7 设置录像播放位置 SetPosition

接口编号 功能描述 函数原型
参数说明
返回值

表9-26 获取录像时长参数表

9-5-7

接口类型

方法

设置录像的播放位置,用于在录像播放过程中进行定位操作。

HRESULT SetPosition(long hWnd, long time)

hWnd:窗口句柄

time:指定新的播放位置,即偏移量(单位:秒)

执行成功返回 0,错误时返回错误码

9.5.8 设置音量 SetVolume

接口编号 功能描述 函数原型

表9-27 设置音量参数表

9-5-8

接口类型

方法

设置指定播放窗口的音频音量。

HRESULT SetVolume(long hWnd, BSTR sCmd, long nParam)

hWnd:窗口句柄

sCmd:操作命令,共支持4中命令:“Open”, “Mute”, “Set”

nParam:参数,当sCmd为Open和Set时有效

参数说明 返回值

命令使用说明: “Open”:表示打开音频,此时nParam为0,表示打开音频,但不修改音量 大小;nParam为1时,将打开音频,并设置为最大音量。 “Mute”:表示关闭音频,此时忽略nParam参数。 “Set” : 表 示 设 置 音 频 大 小 , 此 时 nParam 为 要 设 置 的 音 量 , 范 围 为 [0-10000] (0 为静音,10000为最大声音)。 执行成功返回 0,错误时返回错误码

9.5.9 获取音量 GetVolume

表9-28 获取音量参数表

49

接口编号 功能描述 函数原型 参数说明
返回值

QB-╳╳-╳╳╳-╳╳╳╳

9-5-9

接口类型

方法

获取指定播放窗口的音频音量。

HRESULT GetVolume(long hWnd)

hWnd:窗口句柄

返回指定播放窗口的音量大小,范围为[0-10000] (0 为静音,10000为最

大声音)

9.5.10 本地叠加字幕 OverlayText

接口编号 功能描述 函数原型
参数说明
返回值

表9-29 本地叠加字幕参数表

9-5-10

接口类型

方法

控件在客户端本地进行图像上的文本字幕叠加。

支持设置文本显示的位置,并支持多行文本。

HRESULT OverlayText(long hWnd, long nID, BSTR sText)

hWnd:播放视频的窗口句柄;

nID:该组文本的组号,范围(0-3),最大共支持设置4组字幕。

sText:XML格式的文本内容,格式如下:

<OverlayText>

<XPOS>0</XPOS>

//字幕的X坐标(即left)

<YPOS>10</YPOS>

//字幕的Y坐标(即top)”

<TEXT FColor=“0xFFFFFF” FSize=“14” LineIndex=“0” SpaceSpan=

“4”>叠加文字内容</TEXT>

//显示的字幕内容(属性包括:FColor字体颜色;FSize 字体大小;

LineIndex行号;SpaceSpan列间距。标签值为字幕内容)



<BKGColor>255</BKGColor> //字幕的背景颜色

<Clarity>0%</Clarity>

//字幕的背景透明度

</OverlayText>

执行成功返回 0,错误时返回错误码

9.5.11 清除叠加字幕 ClearOverlayText

接口编号 功能描述 函数原型
参数说明
返回值

表9-30 清除叠加字幕参数表

5-11

接口类型

方法

清除叠加文字

HRESULT ClearOverlayText(long hWnd, long nId)

hWnd:播放视频的窗口句柄;

nID:要清除的文本组号,范围(0-3)共4组。

执行成功返回 0,错误时返回错误码

50

QB-╳╳-╳╳╳-╳╳╳╳
9.6 云镜控制相关接口

9.6.1 云镜控制 PTZControl

接口编号 功能描述 函数原型
参数说明

表9-31 云镜控制参数表

9-6-1

接口类型

方法

发送云镜控制相关命令,包含一些附属设备控制命令。

HRESULT PTZControl(BSTR sCameraID, long nCommand,

long nValue)

sCameraID:摄像头唯一标识

nCommand:云镜控制命令码,定义如下:

0 停止

1 云台上

2 云台下

3 云台左

4 云台右

5 光圈增

6 光圈减

7 镜头拉近

8 镜头拉远

9 聚焦增

10 聚焦减

11 云台自动扫描开 12 云台自动扫描关

13 灯光开

14 灯光关

15 雨刷开

16 雨刷关

17 风扇开

18 风扇关

返回值

nValue:命令数值(0~10),表示操作的速度(操作码1-12,其他无效)。 执行成功返回 0,错误时返回错误码

9.6.2 查询预置位信息 QueryPresetInfo

接口编号
功能描述
函数原型 参数说明 返回值

表9-32 查询预置位信息参数表

9-6-2

接口类型

方法

查询指定摄像头的预置位信息。该接口为异步接口,调用后立即返回,具

体的预置位信息结果在PresetInfoResultNotify事件中进行通知。

HRESULT QueryPresetInfo(BSTR sCameraID)

sCameraID:摄像头唯一编号

执行成功返回 0,错误时返回错误码

9.6.3 查询预置位结果通知 PresetInfoResultNotify

接口编号 功能描述
函数原型

表9-33 查询预置位结果通知参数表

9-6-3

接口类型

事件

返回预置位查询结果的事件通知。

void PresetInfoResultNotify(BSTR sCameraID, long

BSTR sPresets)

nStatusCode,

51

参数说明

QB-╳╳-╳╳╳-╳╳╳╳
sCameraID:摄像头唯一编号 nStatusCode:操作结果状态码 200:成功,401:失败 sPresets:预设位详细列表,包括预设位名称和编号。 XML格式如下: <presets>
<preset id=“预置位编号” name=“预置位名称” /> <preset id=“预置位编号” name=“预置位名称” /> </presets>

返回值

注:预置位编号从1开始。 无返回值

9.6.4 调用预置位 LoadPreset

接口编号 功能描述 函数原型
参数说明
返回值

表9-34 调用预置位参数表

9-6-4

接口类型

方法

将某摄像头转至指定的预置位。

HRESULT LoadPreset(BSTR sCameraID, long nPresetID)

sCameraID:摄像头唯一编号

nPresetID:预置位编号。

执行成功返回 0,错误时返回错误码

9.7 录像相关接口

9.7.1 查询历史录像文件 QueryRecord

接口编号 功能描述 函数原型
参数说明
返回值

表9-35 查询历史录像参数表

9-7-1

接口类型

方法

查询历史录像文件。查询结构通过异步消息RecordReturnNotify返回。

HRESULT QueryRecord(BSTR sCameraID , long nQueryType , long

sEventType, BSTR sStartTime, BSTR sEndTime)

sCameraID:摄像头唯一标识

nQueryType:查询类型, 0-前端查询、1-平台查询

sEventType: 录像类型,0-全部、1-告警录像、2-手动录像、3-定时录像

sStartTime:开始时间

sEndTime:结束时间

其中时间格式为“YYYYmmDDHHMMSS”

执行成功返回 0,错误时返回错误码

52

QB-╳╳-╳╳╳-╳╳╳╳

9.7.2 查询历史录像文件结果通知 RecordReturnNotify

接口编号 功能描述 函数原型
参数说明
返回值

表9-37 获查询历史录像文件结果通知参数表

9-7-2

接口类型

事件

返回历史录像文件查询结果的事件通知。

void RecordReturnNotify(long nQueryType , BSTR sCameraID, long

nStatusCode, BSTR sQueryResult)

nQueryType:查询类型, 0-前端查询、1-平台查询、2-本地查询

sCameraID:摄像头唯一标识

nStatusCode:操作结果状态码 200:成功,401:失败

sList:查询结果。以XML形式返回。

Xml格式如下:

<list>

<file name=“” event=“ALARM” starttime=”YYYYmmDDHHMMSS”

endtime=”YYYYmmDDHHMMSS”/>

</list>

其中name用于表示平台、前端、本地录像文件唯一标识或文件名。

无返回值

9.7.3 开始手动录像 StartLocalRecord

接口编号 功能描述 函数原型
参数说明

表9-38 开始手动录像参数表

9-7-3

接口类型

方法

开始客户端本地的手动录像。指本地录像,不在控件中开放平台录像和前

端录像的控制。

HRESULT StartLocalRecord(BSTR sCameraID, BSTR sFileName)

sCameraID:摄像头唯一标识

sFileName:表示录像的全路径文件名。

返 回 值 执行成功返回 0,错误时返回错误码

9.7.4 停止手动录像 StopLocalRecord

接口编号 功能描述 函数原型 参数说明 返回值

表9-39 停止手动录像参数表

9-7-4

接口类型

方法

停止客户端本地的手动录像。

HRESULT StopLocalRecord(BSTR sCameraID)

sCameraID:摄像头唯一标识

执行成功返回 0,错误时返回错误码

53

QB-╳╳-╳╳╳-╳╳╳╳
9.8 图像抓拍相关接口

9.8.1 客户端抓拍 Snap

接口编号 功能描述 函数原型 参数说明 返回值

表9-40 客户端抓拍参数表

9-8-1

接口类型

方法

对当前正在播放的视频进行抓拍,并将图片保存到指定的本地文件中。

支持:bmp,jpg格式。

HRESULT Snap(long hWnd, BSTR sFileName)

hWnd:窗口句柄。

sFileName:图像文件的绝对路径。如:“c:\snapfile.jpg”

执行成功返回 0,错误时返回错误码

9.8.2 前端抓拍 SnapVCU

接口编号 功能描述 函数原型 参数说明 返回值

表9-41 前端抓拍和下载参数表

9-8-2

接口类型

方法

手动触发前端抓拍。

支持:bmp,jpg格式。

HRESULT SnapVCU(BSTR sCameraID

)

hWnd:摄像头唯一标识

执行成功返回 0,错误时返回错误码

9.8.3 查询抓拍文件 QuerySnap

接口编号 功能描述 函数原型
参数说明
返回值

表9-42 查询抓拍文件参数表

9-8-3

接口类型

方法

查询平台抓拍文件。查询结果通过异步消息SnapReturnNotify接收。

HRESULT QuerySnap(BSTR sCameraID,long nQueryType,BSTR sStartTime,

BSTR sEndTime)

sCameraID:摄像头唯一标识

nQueryType:查询位置 1:平台

sStartTime:开始时间

sEndTime:结束时间

其中时间格式为“YYYYmmDDHHMMSS”

执行成功返回 0,错误时返回错误码

54

QB-╳╳-╳╳╳-╳╳╳╳

9.8.4 查询抓拍文件结果通知 SnapReturnNotify

接口编号 功能描述
函数原型

表9-43 查询抓拍文件结果通知参数表

9-8-4

接口类型

事件

抓拍文件查询结果信息上报通知

void SnapReturnNotify(long nQueryType, BSTR nStatusCode, BSTR sQueryResult)

nQueryType:查询位置 1:平台 sCameraID:摄像头唯一编号

nStatusCode:操作结果状态码 200:成功,401:失败 sMessage:查询到的抓拍文件列表。XML形式。

sCameraID,

long

参数说明

Xml格式如下: <list>
<file filename=“2000003101120100315150807920.jpg” SnapTime=“YYYYmmDDHHMMSS” FileSize=“34197”/>
… </list>

返 回 值 无返回值

9.8.5 平台抓拍文件下载 SnapFileDownload

接口编号 功能描述 函数原型
参数说明

表9-44 平台抓拍文件下载参数表

9-8-5

接口类型

方法

下载平台端的快照文件到客户端本地。

HRESULT SnapFileDownload(BSTR sCameraID, BSTR sFileName, BSTR

sLocalSnapDownPath)

sCameraID:摄像头唯一标识

sFileName: 快照文件名(对应查询结果中返回的filename字段)

sLocalSnapDownPath:本地下载保存绝对路径,如:”c:\download”

返 回 值 执行成功返回 0,错误时返回错误码

9.8.6 平台抓拍文件下载结果通知 SnapFileDownloadResultNotify

接口编号 功能描述

表9-45 平台抓拍文件下载结果通知参数表

9-8-6

接口类型

事件

网络快照文件下载信息上报通知

55

函数原型 参数说明 返回值

QB-╳╳-╳╳╳-╳╳╳╳
void SnapFileDownloadResultNotify(BSTR sCameraID, long nStatusCode, BSTR sFile) sCameraID:通道编号 nStatusCode:操作结果状态码 200:成功,401:失败 sFile:快照文件唯一标识(文件名) 无返回值

9.9 语音对讲相关接口

9.9.1 开始双向语音 StartVoiceTalk

接口编号 功能描述 函数原型
参数说明
返回值

表9-46 开始双向语音参数表

9-9-1

接口类型

方法

打开语音

HRESULT StartVoiceTalk(BSTR sCameraID, long CallType)

sCameraID:通道编号

CallType: 保留字段,默认填0

执行成功返回 0,错误时返回错误码

9.9.2 停止双向语音 StopVoiceTalk

接口编号 功能描述 函数原型 参数说明 返回值

表9-47 停止双向语音参数表

9-9-2

接口类型

关闭语音

HRESULT StopVoiceTalk(BSTR sCameraID)

sCameraID:通道编号

执行成功返回 0,错误时返回错误码

方法

9.9.3 开始单向语音广播 StartVoiceBroadcast

接口编号 功能描述 函数原型
参数说明

表9-48 开始单向语音广播参数表

9-9-3

接口类型

方法

开始单向语音广播

HRESULT StartVoiceBroadcast(BSTR sCameraList, long CallType)

sGuList: 包含一组摄像头的编号,以XML形式输入,格式如下:

<BroadcastList>

<CameraID></CameraID>

<CameraID></CameraID>

</BroadcastList>

56

QB-╳╳-╳╳╳-╳╳╳╳
CallType: 保留字段,默认填0 返 回 值 执行成功返回 0,错误时返回错误码

9.9.4 停止单向语音广播 StopVoiceBroadcast

接口编号 功能描述 函数原型 参数说明 返回值

表9-49 停止单向语音广播参数表

9-9-4

接口类型

方法

关闭单向语音广播

HRESULT StopVoiceBroadcast()



执行成功返回 0,错误时返回错误码

9.9.5 开始语音对讲录音 StartVoiceRecord

接口编号 功能描述 函数原型 参数说明 返回值

表9-50 开始语音对讲录音参数表

9-9-5

接口类型

方法

开始语音对讲录音,当语音对讲开始时,调用此接口开始语音对讲录音。

HRESULT StartVoiceRecord(BSTR sFileName)

sFileName:保存的录音文件完整路径名

执行成功返回 0,错误时返回错误码

9.9.6 停止语音对讲录音 StopVoiceRecord

接口编号 功能描述 函数原型 参数说明 返回值

表9-51 停止语音对讲录音参数表

9-9-6

接口类型

方法

停止语音对讲录音

HRESULT StopVoiceRecord()

执行成功返回 0,错误时返回错误码

9.10 告警相关接口

9.10.1 历史告警查询 QueryAlarm

接口编号 功能描述 函数原型 参数说明

表9-52 历史告警查询参数表

9-10-1

接口类型

方法

查询历史告警信息。异步接口,通过AlarmResultNotify事件返回

HRESULT QueryAlarm(BSTR sCameraID,

BSTR sQueryType, long lStartTime, long lEndTime)

sCameraID:摄像头唯一标识

57

QB-╳╳-╳╳╳-╳╳╳╳
sQueryType:查询的历史告警类型(同告警通知)

返回值

ALARM_TYPE_DI

DI告警

ALARM_DISK_FULL 硬盘满告警

ALARM_NO_SIGNAL 无视频告警

ALARM_TYPE_MOVE_DECTION 移动侦测告警

ALARM_DISK_NOT_FORMAT 硬盘未格式化

ALARM_DISD_RW_ERROR 读写硬盘出错

ALARM_SHIELD

遮挡告警

ALARM_VS_UPGRADE 前端升级

ALARM_ACCESS_VIOLATE 非法访问

ALARM_ALL 所有告警

lStartTime: 查询告警日志起始时间

lEndTime: 查询告警日志结束时间

执行成功返回 0,错误时返回错误码

9.10.2 历史告警查询结果通知 AlarmResultNotify

接口编号 功能描述 函数原型

表9-53 历史告警查询结果通知参数表

9-10-2

接口类型

事件

告警日志查询

void AlarmResultNotify(BSTR sList)

sList:告警记录。以XML格式组织数据。

Xml格式如下:

<list>

<Alarm Name =”abcdef.mp4” LogId =”” AlarmID =”” AlarmType =””

/>

</list>

参数说明

LogId:日志文件ID

AlarmID:告警ID

AlarmName:告警日志名称

AlarmType:告警日志类型,目前的参数含义

ALARM_TYPE_DI

DI告警

ALARM_DISK_FULL 硬盘满告警

ALARM_NO_SIGNAL 无视频告警

ALARM_TYPE_MOVE_DECTION 移动侦测告警

ALARM_DISK_NOT_FORMAT 硬盘未格式化

ALARM_DISD_RW_ERROR 读写硬盘出错

ALARM_SHIELD

遮挡告警

ALARM_VS_UPGRADE 前端升级

ALARM_ACCESS_VIOLATE 非法访问

ALARM_ALL 所有告警

58

返回值

QB-╳╳-╳╳╳-╳╳╳╳
无返回值

9.10.3 布防和撤防 SetGuard

接口编号 功能描述 函数原型
参数说明

表9-54 布防和撤防参数表

9-10-3

接口类型

方法

对指定的摄像头进行布防或者撤防。

HRESULT SetGuard(BSTR sCameraID, long nGuardType)

sCameraID:摄像头编号

nGuardType:布防或者撤防类型:0: 布防;1: 撤防

返 回 值 执行成功返回 0,错误时返回错误码

9.10.4 告警通知 AlarmNofity

接口编号 功能描述 函数原型
参数说明

表9-55 告警通知参数表

9-10-4

接口类型

事件

实时告警通知,当控件收到告警时主动触发该事件通知使用客户端。

void AlarmNotify(BSTR sAlarmData)

sAlarmData:告警信息描述的XML消息

<ALARM_NOTIFY>

<AlarmList>

<Alarm>

<AlarmGlobalID>%s</AlarmGlobalID> 告警全域唯一编号,插件

内部使用

<AlarmID>%s</AlarmID>

告警唯一编号,显示的

AlarmID

<AlarmType>%s</AlarmType>

//

ALARM_TYPE_DI

DI告警

ALARM_DISK_FULL 硬盘满告警

ALARM_NO_SIGNAL 无视频告警

ALARM_TYPE_MOVE_DECTION 移动侦测告警

ALARM_DISK_NOT_FORMAT 硬盘未格式化

ALARM_DISD_RW_ERROR 读写硬盘出错

ALARM_SHIELD

遮挡告警

ALARM_VS_UPGRADE 前端升级

ALARM_ACCESS_VIOLATE 非法访问

ALARM_ALL

所有告警

<DeviceID>%s</DeviceID>

//CameraID 或者 输入/出

设备ID

<VCUID>%s</VCUID>

//前端设备编号

<AlarmStatus>%d</AlarmStatus>

//0:未确认,1确认,2清

59

QB-╳╳-╳╳╳-╳╳╳╳

返回值

除,3自动恢复

<AlarmName>%s</AlarmName>

//通道名称

<AlarmDes>%s</AlarmDes>

//告警描述

<Datetime>%s</Datetime>

//告警时间

<ResetTime>%s</ResetTime>

/告警恢复时间

<Alarm>

<Alarm>

<AlarmGlobalID>%s</AlarmGlobalID>

<AlarmID>%s</AlarmID>

<AlarmType>%d</AlarmType>

<DeviceID>%s</DeviceID>

<VCUID>%s</VCUID>

<AlarmStatus>%d</AlarmStatus>

<AlarmName>%s</AlarmName>

<AlarmDes>%s</AlarmDes>

<Datetime>%s</Datetime>

<ResetTime>%s</ResetTime>

<Alarm>

</AlarmList>

</ALARM_NOTIFY>

无返回值

9.11 其它接口

9.11.1 通用信息上报接口 NotifyEvent

接口编号 功能描述 函数原型
参数说明

表9-56 通用信息上报接口参数表

9-11-1

接口类型

事件

为了便于功能扩展,定义一个通用的控件的信息通知接口,支持将来可能

的扩展。

void NotifyEvent(long nMsgID, BSTR sCameraID, long hWnd , long

nMessage, BSTR sMessage)

nMsgID: 消息类型,表明不同的通知事件,可扩展。

sCameraID:消息相关摄像头编号

hWnd: 消息相关的窗口句柄

nMessage: 消息码

sMessage:消息详细内容

返 回 值 无返回值

9.11.2 自动调整视频大小 AutoFitVideoSize

表9-57 自动调整视频大小参数表
60

接口编号 功能描述 函数原型
参数说明
返回值

QB-╳╳-╳╳╳-╳╳╳╳

9-11-2

接口类型

方法

调整视频区域大小,自动将视频大小自适应窗口的大小。

HRESULT AutoFitVideoSize(long hWnd)

hWnd:窗口句柄

当外部窗口大小变化后(如调整窗口大小或将窗口全屏)调用该接口即可

实现视频图像大小自适应新的窗口大小。

执行成功返回 0,错误时返回-1

9.11.3 码率信息上报通知 NotifyEvent

接口编号 功能描述 函数原型
参数说明

表9-58 码率信息上报通知参数表

9-11-3

接口类型

事件

设置接收码率信息以后,以事件方式固定间隔时间上报的码率信息通知

void NotifyEvent(long nMsgID, BSTR sCameraID, long hWnd , long

nMessage, BSTR sMessage)

nMsgID: 0x80043001

sCameraID:设备ID

hWnd: 窗口句柄

nMessage: 0

sMessage:码率数据信息

数据信息格式为:

“ VFrameRate= … VBitRate= … VRcvFrame= … VLostFrame= …

ABitRate=… ARcvFrame=… ALostFrame=…”

其中:

VFrameRate:解码帧率

VBitRate:视频解码码率

VRcvFrame:视频接收帧数

VLostFrame:视频丢失帧数

ABitRate:音频解码码率

ARcvFrame:音频接收帧数

ALostFrame:音频丢失帧数

返 回 值 无返回值

9.11.4 设置是否接收码率信息 SetBitrateInfoConfig

接口编号 功能描述 函数原型
参数说明
返回值

表9-59 码率信息接收设置参数表

9-11-4

接口类型

方法

设置是否接收码率信息

HRESULT SetBitrateInfoConfig(long hWnd, long lEnable)

hWnd:窗口句柄

lEnable:1=接收;0=不接收

执行成功返回 0,错误时返回-1

61

事件返回

QB-╳╳-╳╳╳-╳╳╳╳
以事件上报方式返回码率信息。

9.11.5 视频数据上报通知 NotifyEvent

接口编号 功能描述 函数原型

表9-60 视频数据上报通知参数表

9-11-5

接口类型

事件

将解码后的图像数据以事件方式上报,每解码得到一帧数据均触发一次此

事件。使用前需首先调用SetFrameInfoConfig接口。

void NotifyEvent(long nMsgID, BSTR sCameraID, long hWnd , long

nMessage, BSTR sMessage)

nMsgID: 0x80043000

sCameraID:摄像头编号

hWnd: 窗口句柄

nMessage: 1=视频

sMessage:视频数据信息

视频数据信息为XML形式: “<pBuffer>视频帧数据缓冲区地址</pBuffer> <BufferSize>视频数据缓冲区大小</BufferSize> <Format>图像格式</Format> <Width>图像宽</Width> <Height>图像高</Height> <acTime>图像时间戳</acTime> <pReserver>扩展结构,用户自定义</pReserver>”

参数说明

其中: acTime: 图 像 时 间 戳 , 以 字 符 串 形 式 给 出 , 精 确 到 毫 秒 , 格 式 定 义 : xxxx-xx-xx-xx-xx-xx-xxxx(year-month-day-hour-minute-second-milse cond) pReserver:扩展结构,用户自定义(暂时为空)

注: (1)上述数据除时间戳为字符串外,均为LONG型 (2)图像格式包括:
typedef enum { RGB565, RGB555, RGB24, RGB32, YV12, // 排列顺序“Y0Y1……”、“V0V1……”、
“U0-U1……” UYVY, // 排列顺序“U0Y0V0Y1U2Y2V2Y3 ……”,
第一个像素位于图像左上角 YUV420, // 排列顺序“Y0Y1……”、“U0-U1……”、
“V0V1……”

62

QB-╳╳-╳╳╳-╳╳╳╳

返 回 值 无返回值

YUV422, // 排列顺序“Y0Y1……”、“U0-U1……”、 “V0V1……”
YUY2, // 排列顺序“Y0 U0 Y1 V0 Y2 U2 Y3 V2……”
YUV444 // 排列顺序“Y0Y1……”、“U0-U1……”、 “V0V1……” }VideoFormat;

9.11.6 设置是否启用视频数据上报 SetFrameInfoConfig

接口编号 功能描述 函数原型
参数说明
返回值 事件返回

表9-61 视频数据上传设置参数表

9-11-6

接口类型 方法

设置是否启用视频数据上报

HRESULT SetFrameInfoConfig(long hWnd,long nEnable)

hWnd:窗口句柄

nEnable:1=上报;0=不上报

注:默认情况下不进行视频数据上报。

执行成功返回 0,错误时返回-1

以事件上报方式返回视频码流和音频码流。

9.12 错误/消息

0x80040101 初始化控件失败 0x80040201 控件释放资源失败
0x00000000 登录平台成功 0x80040301 登录平台失败 0x80040302 登录 IP 地址格式错误 0x80040303 登录端口号错误 0x80040304 登录域名错误 0x80040305 用户名或密码错误 0x80040306 用户帐号被停用 0x80040307 用户达到最大登录数 0x80040308 登录超时 0x80040309 等待登录中 0x8004030A 重新登陆 0x8004030B 用户已在别处登录(适用于帐号不能并发登录情况)
0x00000000 注销平台成功 0x80040401 注销失败 0x80040402 等待注销中

63

QB-╳╳-╳╳╳-╳╳╳╳
0x80040501 获取设备列表失败 0x80040502 摄像头数量过多
0x80040601 获取摄像头属性失败 0x80040602 设备标识无效 0x80040603 设备已停用 0x80040604 本地路径错误
0x00000000 播放实时视频成功 0x80040701 播放实时视频失败 0x00000000 播放平台录像成功 0x80040703 播放平台录像失败
0x00000000 播放前端录像成功 0x80040705 播放前端录像失败
0x00000000 播放本地录像成功 0x80040707 播放本地录像失败
0x00000000 关闭视频播放成功 0x80040801 关闭视频播放失败
0x00000000 关闭所有窗口的视频播放成功 0x80040803 关闭所有窗口的视频播放失败
0x80040901 本地叠加文字失败 0x80040902 清除本地叠加文字失败
0x00000000 继续播放成功 0x80040A01 继续播放失败
0x00000000 暂停播放成功 0x80040A03 暂停播放失败
0x00000000 快进或快退播放成功 0x80040A05 快进或快退播放失败
0x00000000 倍速播放成功 0x80040A07 倍速播放失败 0x80040A09 获取本地的录像时长失败
0x00000000 设置录像播放位置成功 0x80040A11 设置录像播放位置失败
64

QB-╳╳-╳╳╳-╳╳╳╳
0x00000000 设置音量成功 0x80040A13 设置音量失败
0x00000000 云镜控制成功 0x80040B01 云镜控制失败 0x80040B02 云镜控制命令码错误 0x80040B03 云镜控制命令值错误
0x80040C01 查询预置位信息失败 0x80040D01 调用预置位失败
0x80040E01 客户端抓拍失败 0x80040E03 前端抓拍错误 0x80040E05 前端抓拍错误-传输失败 0x80040E07 前端抓拍错误-保存失败
0x80040F01 查询历史录像文件失败 0x00000000 开始手动录像成功 0x80041001 开始手动录像失败 0x00000000 停止手动录像成功 0x80041003 停止手动录像失败
0x80041101 查询抓拍文件失败 0x80041102 查询抓拍文件失败-无权限 0x80041201 平台抓拍文件下载失败 0x80041202 平台抓拍文件下载失败-参数不正确 0x80041203 平台抓拍文件下载失败-数目超过最大值
0x00000000 开始双向语音成功 0x80041301 开始双向语音失败 0x00000000 停止双向语音成功 0x80041303 停止双向语音失败
0x80041401 开始单向语音广播失败 0x80041403 停止单向语音广播失败 0x80041503 开始语音对讲录音失败 0x80041503 停止语音对讲录音失败
0x00000000 历史告警查询成功 0x80041601 历史告警查询失败 0x00000000 布警或撤警成功 0x80041703 布警或撤警失败
0x80041801 设置是否接收码率信息失败
65

QB-╳╳-╳╳╳-╳╳╳╳
0x80041901 设置是否启用视频数据上报失败

10.编制历史
版本号 V 1.0.0

更新时间 2010-07-21

主要内容或重大修改 主要包含客户端的功能,客户端二 次开发控件的接口,手机客户端, PC客户端的界面要求

附录A (解码器)
解码器可以将从网络接收到的视频解码,输出到一台或多台监视器上,并可实现多画面 分割显示,单画面轮巡显示,多画面分割轮巡显示。一般通过嵌入式系统实现。可通过控制 台设置、控制各个解码器。
解码器支持的技术要求如下: 1. 输出接口支持BNC接口或RCA接口,可选择支持VGA、SVGA、DVI、HDMI等接口。 2. 支持标准 H.264、MPEG4图像压缩格式,其它为可选项。 3. 支持G.722、G.711音频解码格式,其它为可选项。 4. 支持PS、RTP码流封装格式。其它为可选项。 5. 支持PAL和NTSC图像制式。 6. 主要支持 QCIF、CIF、HalfD1/2CIF、DCIF、4CIF、D1,高清可选择支持。 7. 支持RS232和RS485透明通道传输。 8. 解码延时应低于250ms,便于实时浏览视频和控制PTZ。 9. 可选择支持双向语音对讲和开关量报警输入、开关量报警输出、画面分割、轮巡解
码等。
附录B (客户端关键性能指标)
客户端主要性能指标: (1) 客户端软件CPU占用率(分别测试播放1路CIF、4路CIF、16路CIF、1路D1、4 路D1、16路D1时的资源占用情况); (2) 客户端软件内存占用率(同上); (3) 端到端视频图像延时; (4) 客户端视频加载延时; (5) 云镜控制响应时间; (6) 手动抓拍图片操作延时;
66

QB-╳╳-╳╳╳-╳╳╳╳
67


相关文档

中国移动视频监控总体技术要求V1.0.0(送审稿)
中国移动视频监控中心平台设备规范V1.0.0 (送审稿)
中国移动多媒体消息业务设备规范v1.0.6
中国移动Mobile Market业务客户端规范1.0
中国移动游戏基地手机网页游戏业务开发规范v1.0
中国移动手机动漫业务客户端规范V1.0.0.精讲
中国移动HSDPA功能测试规范(V1[1].1.0)
中国移动位置业务Le/Ls接口测试规范(V1.1.0)-20031114
电脑版