视频服务器与接入服务器协议资料.docx

1、视频服务器与接入服务器协议资料文档编号： TA001 版本： 2.0 作者：李文军 项目经理：陈小群全球眼平台系统视频服务器与接入服务器接口协议接口规格说明复审人部门姓名和职务开发部陈小群修改历史日期修改人姓名注释2004-06-04李文军第一次建立文件2005-03-01李文军修改了呼叫、视频参数等接口2005-05-17李文军完整的检查了所有接口2005-07-01李文军采用新的规范编写2005-11-08李文军报警协议的新修改1引言 32接口规格说明约定 32.1数据类型定义 32.2指令头 32.3指令返回头 42.4指令 42.5TCP/IP 控制约定 43接口规格说明 43.1设备

2、类型编号 43.2具体接口规格 53.2.1 视频服务器的注册 53.2.2视频服务器的心跳 63.2.3实时音视频的请求协议 73.2.4视频开始和结束的报告协议 83.2.5前端解码器、报警器控制协议文件下载协议 83.2.6前端程序手动更新协议 93.2.7控制云台协议 103.2.8获取云台状态协议 153.2.9用户呼叫请求协议 163.2.10获取视频参数协议 173.2.11设置视频参数协议 193.2.12获取移动侦测报警策略协议 213.2.13获取报警输入报警策略协议 223.2.14设置移动侦测报警策略协议 243.2.15设置报警输入报警策略协议 253.2.16主动发

3、送开始报警协议 273.2.17主动发送结束报警协议 283.2.18主动故障报警协议 293.2.19直接控制报警输出 293.2.20获取控制报警输出状态 303.2.21远程修改前端的一些参数信息 303.2.22视频文件组成协议 313.2.23本地存储视频文件方式协议 323.2.24中心存储视频文件方式协议 323.2.25本地存储视频图片方式协议 333.2.26中心存储视频图片方式协议 333.2.27故障检测自动重新注册协议 333.2.28注册失败后的处理协议 341引言视频服务器设备从硬件上来说， 主要由： 1、运行视频服务器的程序的具有 PC 功能 的机器； 2、提供视

4、频处理的 DSP 芯片； 3、提供视频源的摄像头、云台，控制云台镜 头的解码器； 4、提供报警的报警箱； 5、提供音频的拾音器组成。它主要完成模拟视音频信号的数字化，数字化后的视音频信号采 用 MPEG-4 视频 压缩算法和 G.729 音频压缩算法进行压缩编码，然后通过 IP 网将编码后的音视频数据 以 IP 包的形式传送给监控服务器或远端用户，实现视音频信号的网络传输、网络监控 和网络存储，同时可以支持远程的云镜控制和远程报警管理。接入服务器是视频服务器是消息唯一接口， 任务客户端消息都需经过接入服务器转 发。2接口规格说明约定2.1数据类型定义N：整数N+：正整数(不包含 0)R：浮点型

5、数R+：正浮点型数Byte ：一个字节范围的数( 0 - 255 )C：单个字符S：字符串X：十六进制的流DT：日期 / 时间格式字符串( 2003-12-20 03:02:13 )LDT： linux 下的时间字符串( 060215482004.45 表示 6 月 2 日 15 点 48 分 2004 年 45 秒)D：日期格式字符串( 2003-12-20 )T：时间格式字符串( 03:02:13 )T+：时间小时和分钟格式字符串( 03:02 )B：布尔类型( 0、 1)B+：布尔类型的字符串表示( false 、 true )IP ：IP 地址格式的字符串( 172.16.29.223

6、 )2.2指令头4Bytes4 Bytes4 Bytes4 Bytes32 Bytes32 Bytes版本号(N)指令长度(N)指令编号(N)指令序号(N)源 ID(S)目地 ID(S)指令头中的各字段设置：版本号 指令长度 指令编号 指令序号为 257指令中 XML格式数据的长度。如果没有 XML信息，长度为。 其它地方另行定义指令发起者自己设定的一个数值， 对应的指令返回头中指令序号 与它完全相同源 ID 目地 ID发起者的自身的业务 ID 操作目标的业务 ID2.3指令返回头4Bytes4 Bytes4 Bytes4 Bytes4 Bytes版本号(N)指令长度(N)指令编号(N)指令序

7、号(N)成功标志(N)指令返回值头中的各字段设置：版本号 为接收到指令的版本号指令长度 为指令返回值中 XML格式数据的长度指令编号 为接收到的指令中的指令编号加一指令序号 为接收到的指令中的指令序号成功标志 为 0 表示成功，其它表示错误序号2.4指令发送指令格式：指令头 + XML 格式的附加信息(如果指令长度为 0，则该项没有)指令返回值格式：指令返回值头 + XML 格式的附加信息(如果指令长度为 0，则该项没有)2.5TCP/IP 控制约定本系统指令格式采用 TCP 的方式。套接字的关闭都是主动发起者来完成。3接口规格说明3.1设备类型编号设备 宏定义 值用户TYPE USER1前端

8、服务器TYPE TERMINAL2分发服务器TYPE DISPA TCH3存储服务器TYPE STORE4摄像头TYPE CAMERA5报警器TYPE ALARM6显示墙TYPE DISPLAY73.2具体接口规格这里将全部列出视频服务器和接入服务器的消息控制的具体接口协议。注意，在 下面每一个指令返回头信息的成功标志信息中，都只是列出了 0 正确的信息。错误的信息在协议中没有太硬性规定，请各自设置。3.2.1 视频服务器的注册功能 将视频服务器注册到中心，以便于中心管理。同时通过设备 ID 可以检测设备的真 伪。获取视频服务器以及子设备的业务 ID 。 指令格式 指令头：版本号指令长度指令编

9、号指令序号源 ID目地 ID(N)(N)(N)(N)(S)(S)257XML的长度2002000因为注册时，设备还没有获取自身的业务 ID ，所以源 ID 和目的 ID 都填写 0XML： 视频连接端口（ N ） 对讲呼叫连接端口（ N） 消息端口（ N ）1 其中连接类型： 1是LAN，2为 ADSL ，3为其它类型。视频的最大连接数是指前端和 网络带宽能够支持的最大视频路数。 返回结果格式 返回值头：版本号指令长度指令编号指令序号成功标志(N)(N)(N)(N)(N)257XML的长度200300XML： 返回值：设备 ID 和子设备 ID 号只在注册验证设备的真伪才有用。一但验证通过以后

10、 交互的都是中心赋予的业务 ID 号。 HeartCycle 表示心跳周期。 SysRebootTime 和 SysRebootCycle 是为了避免前端死机。而采用的一种重起机制。 SysRebootCycle 表示 重起周期。 SysRebootTime 表示重起时刻。如 15： 45。表示在 15 点 45 分重起。 CurrentDateTime 是中心的时间。 060215482004.45 表示为 6 月 2 号 15 点 48 分 2004 年 45 秒。以便让前端和中心同步时间。子节点中每个 Camera 表示一个摄像头。其中 ID 为摄像头的业务 ID ， HasPan 表

11、示是否有云台。在里面的子节点 StoreScheme 表示此摄像头的存储有关的信息。 IsLocaleSaved 是否本地存储。如果不是，则指定存储服务器的 IP 。以及 ftp 上传的一些 信息，如 FtpUser 、 FtpPwd、 RemotePort 等等。 StorePlanHourFlag 表示存储 方案，是 一个 168 字符的 0 或 1。表示以一周 168 个小时为单位，从星期日开始， 1 表示存。 0 表示不存。子节点中每个 AlarmIn 表示一个报警输入。 ID 为报警输入的业务 ID 。 子节点中每个 AlarmOut 表示一个报警输出。 ID 为报警输出的业务 ID

12、 。3.2.2视频服务器的心跳功能 主动向中心报告自己的状态。 指令格式 指令头：版本号(N)指令长度(N)指令编号(N)指令序 号 (N)源 ID（S）目地 ID（S）257XML的长度20前端业务 ID0XML： TYPE_TERMINAL 返回结果格式 版本号(N)指令长度(N)指令编号(N)指令序号(N)成功标志(N)257XML的长度300XML：注意： 心跳信息如果在一次不成功后， 在等待 10 秒后再次发送一次。 如果还是不成功 就认为视频服务器心跳失败，然后必须使用 3.2.27 协议来尝试重新注册！3.2.3实时音视频的请求协议功能 视频的浏览有三次交互过程， 共有三个协议。

13、 第一次是被动接收视频请求协议， 由 客户端发起从接入服务器转发过来； 然后是第二次由客户端直接发起的到视频服务器的视频 连接协议。 第三个协议是在视频开始和结束时发送的报告协议。 第一个和第三个协议在本文 件中描述，分别为： 3.2.3 和 3.2.4。 第二个视频连接协议在企业客户端和视频服务器协 议中的 2.1 。 指令格式 指令头：版本号(N)指令长度(N)指令编号(N)指令序 号 (N)源 ID (S)目地 ID(S)257XML的长度5010、60020客户端SessionID摄像头 IDXML： 前端业务( S) 连接的验证信息( S31 ) DevDataID 是前端业务 ID

14、 ，用于校验。 Ticket 为验证信息，表示作为下次视频 连接的依据。 返回结果格式 版本号(N)指令长度(N)指令编号(N)指令序号(N)成功标志(N)257XML的长度5011， 600300指令编号 :5011 是对应企业客户端的返回请求， 6003 是对应显示服务器的返回请 求。XML： 连接的验证信息( S) 视频连接端口( N ) 视频编码器的类型( S) 其中 Ticket 表示回送发送的 Ticket ， VideoPort 表示为视频连接的端口， Protocol 表示为视频解码的类型。3.2.4视频开始和结束的报告协议功能 这是个主动发起协议。 在视频连接开始和结束时，

15、向接入服务器发送一个报告， 作 为以后记费的依据。 指令格式 指令头：版本号(N)指令长度(N)指令编号(N)指令序 号 (N)源 ID (S)目地 ID(S)257XML的长度40前端业务 ID0XML： 连接的验证信息( S) 服务器类型 (N+) 开始和结束标志() Ticket 为视频请求时的验证信息。 DevType 为前端类型 TYPE_TERMINAL 。Switch 中表示开始，表示结束。 返回结果格式 版本号指令长度指令编号指令序号成功标志(N)(N)(N)(N)(N)257XML的长度00XML：无3.2.5前端解码器、报警器控制协议文件下载协议功能 首先先从视频服务器上设

16、置具体的协议编号， 然后主动向中心下载解码器、 报警器 控制协议文件。 指令格式 指令头：版本号指令长度指令编号指令序源 ID目地 ID(N)(N)(N)号(N)(S)(S)257XML的长度20040前端业务 ID0XML： Key 指定要下载的协议的具体编号。 返回结果格式 版本号(N)指令长度(N)指令编号(N)指令序号(N)成功标志(N)257XML的长度200500XML：根据返回的 XML 信息，就可以主动从指定的 FTP 服务器上下载具体协议文件。FtpAddress 是指协议文件的 IP 地址， FtpPort 指端口， User 指用户名， Pwd 指密码， Path 指 协

17、议文件的相对于 FTP 主目录的路径。3.2.6前端程序手动更新协议功能 手动更新分为两组指令：一、更新请求，如果请求通过后，就可以更新了；二、更 新。1、被动更新请求 指令格式 指令头：版本号(N)指令长度(N)指令编号(N)指令序 号 (N)源 ID (S)目地 ID(S)257XML的长度80100客户端 SessionID前端业务IDXML： 这个表示客户端要更新程序的版本。 返回结果格式 版本号(N)指令长度(N)指令编号(N)指令序号(N)成功标志(N)257XML的长度801100XML：无。2、更新 指令格式 指令头：版本号(N)指令长度(N)指令编号(N)指令序 号 (N)源

18、 ID(S)目地 ID(S)257XML的长度80120客户端 SessionID前端业务 IDXML： 通过通过指定返回的 FTP 服务器的一些信息来获取更新包。 FtpAddress 是 指 写 协议的， FtpPort 指端口， User 指用户名， Pwd 指密码， Path 指更新包 相 对于 FTP 主目录的路径。 FileName 为更新包的文件名。然后前端通过这些信息到指定服务器和路径 下载更新就可以了。 返回结果格式 版本号指令长度指令编号指令序号成功标志(N)(N)(N)(N)(N)257XML的长度801300XML：无。 更新成功后，返回更新的结果。3.2.7控制云台协

19、议 指令格式 指令头：版本号(N)指令长度(N)指令编号(N)指令序 号 (N)源 ID (S)目地 ID(S)257XML的长度50060客户端SessionID摄像头 IDXML：有两种 xml 协议。第一种为基本协议，必须实现。第二种为扩展协议。第一种基本协议 : 云台镜头控制命令无论多长时间，只发送一次。 0-20 分别代表：0 # 停止1# 云台上2# 云台下3# 云台左4# 云台右5#光圈 +6#光圈 -7# 变倍 +8# 变倍 -9# 聚焦 +10#聚焦 -11#云台自动扫描开12#云台自动扫描关13#灯光开14#灯光关15# 雨刷开16#雨刷关17#探头电源开18#探头电源关19#摄头电源开20#摄头电源关1 秒以内重复发码。第二种为扩展协议 : 云台镜头控制命令在需保持动作时，需在 每一个指令分别叙述如下：进入菜单模式8100开自动光圈 8102 1关自动光圈 8102 0开背光补偿81041关背光补偿8104 0开数字变倍8106 1 关数字变倍 8106 0 自动切换夜视功能 8108 1 手动切换夜视功能 8108 0 转换为彩色显示 8110 1 转换为夜视显示 8110 0 云台方向速度控制8200Speed 表示速度从 1 255 其中： Direct 中 U 、D、L、R分别表示 上下左右。之间。停止方向速度控制8202 开随机线扫 8204 1/