卡口通信协议卡口接入服务器通信协议Word格式.docx

1、5.1协议枚举定义值规则说明 125.2手持终端与中心服务器通信枚举 125.3卡口设备与中心服务器通信枚举 195.4通用响应枚举 216手持终端 226.1登录 226.2保持在线 236.3用户管理 246.3.1获取用户列表 246.3.2添加帐号 246.3.3修改用户 256.3.1删除帐号 256.4修改密码 256.5卡口管理 266.5.1获取卡口列表 266.5.2添加卡口设备 266.5.3修改卡口设备 276.5.4删除卡口设备 276.6对讲 286.6.1发起对讲 286.6.2收到对讲 286.6.3结束对讲 296.6.4对方结束对讲 306.7实时语音广播 3

2、06.7.1发起广播 306.7.2结束广播 306.7.3卡口结束广播 316.8摄像机参数设置 316.8.1获取摄像机参数 316.8.2设置摄像机参数 336.9摄像机录像设置 346.9.1获取录像计划 346.9.2设置录像计划 346.10摄像机录像设置 356.10.1获取抓图参数 356.10.2设置抓图参数 366.11区域入侵侦测开关 366.11.1获取区域入侵侦测 366.11.2设置区域入侵侦测 376.12摄像机报警 386.13摄像机状态 396.13.1摄像机上线 396.13.2摄像机掉线 396.14卡口状态 396.14.1卡口上线 396.14.2卡口

3、掉线 396.15订阅设备状态 406.16取消订阅设备状态 406.17通知添加卡口设备 406.18通知删除卡口设备 416.19获取卡口详细信息 416.20获取报警录音文件列表 416.21获取报警录音文件 426.22上传报警录音文件 426.23添加报警录音文件 426.24修改报警录音文件 436.25删除报警录音文件 436.26获取广播录音文件列表 446.27获取广播录音文件 446.28上传广播录音文件 446.29添加广播录音文件 446.30修改广播录音文件 456.31删除广播录音文件 456.32卡口报警联动 466.32.1获取卡口报警联动 466.32.2获取

4、卡口报警联动录音文件 466.32.3上传卡口报警联动录音文件 476.32.4设置卡口报警联动 476.33文件上传下载 476.33.1下载文件 476.33.2上传文件 486.33.3取消流传输 496.33.4收到取消流传输 496.34卡口广播 496.34.1获取卡口广播 496.34.2设置卡口广播 506.34.3获取卡口广播录音文件 516.34.4上传卡口广播录音文件 516.35卡口LED显示 516.35.1获取卡口LED显示配置 516.34.2设置卡口LED显示配置 526.36预览卡口视频 536.36.1开流 536.36.2关流 546.37录像查询 546

5、.37.1查询月录像（查询一个月中那些天有录像） 546.37.2查询录像详细 556.38查询报警图片 566.38.1查询报警图片 566.38.2获取报警抓图 586.39录像回放 586.39.1请求录像回放 586.39.2快播，慢播，暂停，继续 596.39.3停止回放 596.40录像下载 606.41控制云台 606.42到预置位 606.43开关扫描 616.44获取扫描状态 616.45获取卡口设备状态 626.46开关卡口设备电源 626.47获取气象信息 637卡口设备 637.1向卡口注册 637.2对讲 647.2.1发起对讲 647.2.2收到对讲 647.2.3

6、结束对讲 657.2.4对方结束对讲 667.3实时语音广播 667.3.1手机请求广播 667.3.2手机挂断广播 667.4卡口报警联动 677.4.1获取卡口报警联动 677.4.2获取卡口报警联动录音文件 677.5上传下载 687.5.1收到下载请求 687.5.2收到上传请求 697.5.3收到取消流传输 707.6卡口广播 707.6.1获取卡口广播 707.6.2设置卡口广播 717.6.3获取卡口广播录音文件 717.6.4上传卡口广播录音文件 717.7卡口LED显示 727.7.1获取卡口LED显示配置 727.7.2设置卡口LED显示配置 737.8报警通知到卡口 74

7、7.9通知卡口同步时间 747.10控制云台 747.11到预置位 757.12开关扫描 757.13获取扫描状态 767.14获取卡口设备状态 767.15开关卡口设备电源 777.16获取气象信息 778网页配置 788.1网页登录 781引言1.1编写目的1.2背景1.3定义卡口通信协议（卡口接入服务器通信协议），下文列出本文件中用到专门术语的定义和外文首字母组词的原词组。卡口接入服务器：卡口设备、IP摄像机，手持终端通过卡口接入服务器处理数据，转发信令，存取数据库，视音频转发。手持终端：安卓下开发的一款远程管理前端卡口等。中心服务器：卡口接入服务器简写1.4参考资料方案资料：2文档约定

8、为方便阅读该文档，发起方使用如下所示的图形表示：响应方，使用另一种图形表示：3系统的结构4传输协议数据的传输协议由卡口接入服务器统一约定，各客户端逐步实现协议规范。4.1协议介绍目前，实现数据传输协议的设备有手机和卡口设备和IP摄像机，卡口设备、手持终端同卡口接入服务器通信采用DKLPRT（XX实时通信协议）。当前借鉴RTMP协议的子协议AMF，该协议是Adobe公司的协议，主要用于数据交互和远程过程调用，在功能上与WebService相当。其特点主要有： 基于远程的异步方法调用 数据压缩率高 支持20种数据类型，满足各种使用场景 统一格式解析方法 便于系统扩展4.2协议说明手持终端和卡口设备

9、与卡口接入服务器进行数据传输时，每次传输的数据包由数据头和数据内容两部分组成；下面以手持终端登录为例说明协议规则，手持终端向卡口接入服务器发送的数据（以十六进制表示）如下：03 00 00 00 00 00 00 00 76 00 01 00 00 13 00 03 00 07 43 6d 64 54 79 70 65 06 00 00 00 01 00 0d 54 72 61 6e 73 61 63 74 69 6f 6e 49 64 11 00 20 39 65 31 37 64 66 66 30 30 36 62 36 34 36 63 36 38 38 65 38 63 31 38 3

10、8 65 61 63 62 61 35 66 65 00 06 4f 62 6a 65 63 74 13 00 02 00 08 55 73 65 72 4e 61 6d 65 11 00 08 68 65 6c 70 73 6f 66 74 00 08 50 61 73 73 77 6f 72 64 11 00 06 31 32 33 34 35 36上面的数据包含了头和内容两部分，下面分别进行拆分说明。4.2.1数据头数据头包含的内容：03 00 00 00 00 00 00 00 76 00 01 00 00字节数据类型值字节数说明03byte31头类型和通道，前两位表示类型，后六位表示

11、通道00 00 00 00int4时间戳00 00 00 76118数据大小00 01short2消息类型00 00流ID第一个字节03包含了两部分信息，即头类型和通道，将03以二进制形式表示为00000011，前两位00表示头类型为0，后六位000011表示通道为3；头类型共有四个值，主要用于对数据头进行优化，降低网络传输流量，这在传输音频和视频信息的时候尤其有用。头类型详细说明见下表：完整的头数据包（时间戳、数据大小、消息类型、流ID）没有流ID的头数据包只包含时间戳的头数据包空头，即头数据不包含任何信息对于通道信息，可表示的最大通道数为，有效的通道值为263（0和1 有特殊用途）；协议约

12、定通道等于0或者1时，说明当前通道数不够用，需要进行通道扩充，即没有扩充时实际可用通道数为62个；当通道为0时，数据头会在第一个字节后面再增加一个字节以扩充通道数，一个字节可存储的值范围为0255，此时可表示的最大通道数为，有效的通道值为64319；当通道为1时，数据头会在第一个字节后面再增加两个字节进行通道扩充，此时可表示的最大通道数为，有效的通道值为32065535。图3.2 数据通道扩展当通道扩展一个字节时，会有一个加减操作，当通道扩展两个字节时，则没有这一操作，因为此时可使用的通道数已经足够多，无须进行加减操作。这里重点介绍通道扩展一个字节时的相关操作，比如现在手持终端要给卡口接入服务

13、器发送数据包，在构建数据头时，指定通道数为270，由于第一个字节的后六位最大可用的通道数为63，因此需要扩展一个字节，扩展的字节中实际存储的值为，其二进制形式的值如图3.3。图3.3 206的二进制形式卡口接入服务器收到该数据包后，解析通道时，首先应判断数据头中第一个字节后六们的值，如果该值等于0，则说明有一个通道字节扩展，读出扩展字节的值，然后加上64即为实际通道的值。目前已经约定使用的通道如下表：通道用于Command和Notify的消息类型6用于AudioData音频的消息类型7用于VideoData视频的消息类型8用于AckSize的消息类型9用于FileData的消息类型 11用于Heartbeat心跳包的消息类型数据头中的消息类型用来说明数据包的作用，当前使用的消息类型有六种，如下表：Command命令类型，主要用于发送与接收业务数据AudioData音频类型VideoData视频类型Heartbeat5心跳包AckSize接收数据数大小，结合音频和视频消息使用，防止网络阻塞FileData文件传输，在文件传输中，时间戳有特殊意义，0表示正常传输，1标识文件无法读取，2发送文件结束None其它类型，目前未使用4.2.2数据优化数据