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

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.5 TCP/IP 控制约定 43 接口规格说明 43.1 设备类型编号 4

2、3.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

3、.2.16 主动发送开始报警协议 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、运行视频服务器的

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

5、定义N：整数N+：正整数(不包含 0)R：浮点型数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

6、 地址格式的字符串( 23 )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 By

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

8、号设备 宏定义 值用户TYPE USER1前端服务器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 为

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

12、报警输出。 ID 为报警输出的业务 ID 。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) 连接的验证信息( S3

14、1 ) DevDataID 是前端业务 ID ，用于校验。 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

17、 指用户名， Pwd 指密码， Path 指 协议文件的相对于 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

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

19、 更新成功后，返回更新的结果。3.2.7 控制云台协议 指令格式 指令头：版本号(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 #

20、灯光开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

21、 、D、L、R分别表示 上下左右。之间。停止方向速度控制8202 开随机线扫 8204 1关随机线扫 8204 0 设置预置点8206预置点号（ N+） 清除预置点 8208预置点号（ N+） 调用预置点 8210预置点号（ N+） 速度（ 1255） 清除所有预置点 8212 180 度翻转8214速度（ 1255） 开看守位 82161 关看守位 82160 设置巡视轨迹 8218 巡视轨迹序号 （N+） N” Speed=“1255” /N” Speed=“1255” /N” Speed=“1255” /N” Speed=“1255” /Preset Num=“N ” Time=Pres

22、et Num=“N ” Time=。 。Preset Num=“N ” Time=Preset Num=“N ” Time= 注 Preset 标签的 Num属性指预置点序号， Time 属性单位为秒。 Preset 记录 最少 2 条，最多 16 条。清除巡视轨迹 8220 巡视轨迹序号 (N+) 调用巡视轨迹 8222 巡视轨迹序号 (N+) 清除所有巡视轨迹 8224 光圈大控制8300 1 光圈小控制 8300 0 变倍大控制 8302 1 变倍小控制 8302 0 聚焦大控制 8304 1 聚焦小控制 8304 0 光圈控制停止 8306变倍控制停止 8308聚焦控制停止 8310开

23、辅助开关 8400 辅助开关序号 (N ) 1关辅助开关8400辅助开关序号 (N ) 0 恢复球机的出厂参数设置 8402 返回结果格式 无。3.2.8 获取云台状态协议特别注意： 如果返回的是第一种协议， 在 3.2.7 云台控制时就要实现第一种协议。 如果返回 的是第二种协议，在 3.2.7 云台控制时就要实现第二种协议。一一对应，切记切记。举例： 如果返回的是第一种协议，但是又实现了 3.2.7 云台控制时的第二种协议中的预制点，将 不起作用。 指令格式 指令头：版本号(N)指令长度(N)指令编号(N)指令序 号 (N)源 ID (S)目地 ID(S)257XML的长度50420客户端

24、SessionID摄像头 IDXML： 返回结果格式 版本号指令长度指令编号指令序号成功标志(N)(N)(N)(N)(N)257XML的长度504300XML：有两种 xml 协议。第一种为基本协议，必须实现。第二种为扩展协议。第一种基本协议云台状态( S) 【注】云台状态，长度为 5 的0、1 字符串，该字符串的 5 个字符依次代表自动、 灯光、雨刷、探头、摄头的状态， 0为关闭， 1为打开。第二种扩展协议云台状态( S) 最大支持预置点数( N) 最大支持辅助开关数 (N) 云台控制命令号 云台控制命令号 。云台控制命令号 【注】云台状态同上， Preset 表示当前的解码器支持的最大预制

25、点数，Aux 表示最大支持辅助开关数， Support 中的每一个 Op表示只支持的命令号。3.2.9 用户呼叫请求协议功能 用户呼叫有两次交互过程， 首先是被动接收呼叫请求协议， 由客户端发起从接入服 务器转发过来； 第二次由客户端直接发送过来的呼叫连接协议。 这个是呼叫请求协议。 呼叫 连接协议在企业客户端和视频服务器协议中的2.2。 指令格式 指令头：版本号(N)指令长度(N)指令编号(N)指令序 号 (N)源 ID (S)目地 ID(S)257XML的长度61100客户端SessionID前端业务IDXML： 连接验证信息( S31 ) 返回结果格式 版本号指令长度指令编号指令序号成功

26、标志(N)(N)(N)(N)(N)257XML的长度611100XML：端口( N+) Port 为客户端呼叫连接时的端口号。3.2.10 获取视频参数协议 指令格式 指令头：版本号(N)指令长度(N)指令编号(N)指令序 号 (N)源 ID (S)目地 ID(S)257XML的长度50340客户端 SessionID摄像头 IDXML：参数的子集( N+ ) Para 为分别为八种视频参数： 1、帧率。 2、图像质量。 3、最大码流。 4、 图像格式。、遮挡区域。、时间和Logo 。、视频参数。、图像移动侦测参数。 返回结果格式 版本号(N)指令长度(N)指令编号(N)指令序号(N)成功标志

27、(N)257XML的长度503500XML：对于具体的子集参数 1-8 分别的 XML为 其中， FrameRate 的范围 325。 KeyFrameIntervals 的范围 10 100。默认值自定义。2其中， Level 为等级。范围：最好、较好、好、一般。分别用 0,1,2,3 代替。默认 值自定义。3其中， MaxBPS 为码流值。单位是 1000bit/sec 范围：大于 50。默认值自定义。4其中， PicFormat 范围： CIF 、QCIF 、2CIF、4CIF/D1 。分别用 0,1,2,3 代替。 SupportFormat 为支持的视频格式。 如支持 CIF 、QC

28、IF 、2CIF 为 012。如支持 QCIF 、 2CIF 为 13。 默认值自定义。5图像遮挡设置： bLogoing 值为或分别为设置和取消图像遮挡。Left 、 Top 、Width 、 Height 分别为遮挡矩形区域。范围：有一个矩型区域，大小在352 288 之间。默认值是没有效，即没有设置遮挡。6时间和 Logo 设置： bOSDing 为或分别为打开和关闭时间和 Logo 设置。 nOSDPlace 表示时间的显示位置。分别为左上，中上，右上，中左，中右，左 下，中下，右下 八个位置。 nWordPlace 表示 Logo 的显示位置。也是。 Word 为 Logo 的字。默

29、认值是有效， LOGO 位置左上。汉字位置右下。汉字内容为：视频位 置。7 视频参数设置：范围，对比度、色度、亮度、饱和度的大小范围都是0-255。默认值自定义。8移动侦测设置： bDectecting 为或 0 分别为打开和关闭移动侦测。 DetectGrade 为侦测的灵敏度。大小为。 0最灵敏， 6最迟钝。 Left 、 Top、 Width 、 Height 分 别为移动侦测的矩形区域。 ，大小在 352288 之间。 默认值是没有效， 即没有设置移动 侦测。3.2.11 设置视频参数协议 指令格式 指令头：版本号（N）指令长度（N）指令编号（N）指令序 号 （N）源 ID (S)目地

30、 ID(S)257XML的长度50320客户端SessionID摄像头 IDXML：根据不同的 Para 的值有不同的参数值 具体含义见上面的参数获取指令。如果每一项值是 1，表示要设置默认值。2 具体含义见上面的参数获取指令。如果每一项值是 1，表示要设置默认值。3 具体含义见上面的参数获取指令。如果每一项值是 1 ，表示要设置默认值。4SupportFormat= “系统支持的图像 1 ，表示要设置默认值。具体含义见上面的参数获取指令。如果每一项值是5 具体含义见上面的参数获取指令。不允许设置默认值。6具体含义见上面的参数获取指令。不允许设置默认值。7具体含义见上面的参数获取指令。如果每一项值是 1，表示要设置默认值。8 具体含义见上面的参数获取指令。不允许设置默认值。 返回结果格式 版本号（N）指令长度（N）指令编号（N）指令序号（N）成功标志（N）257XML的长度503300XML：无。3.2.12