H3C+iVS8000系统报警联动协议SDK产品说明书

IVS8000 VMP报警联动协议接口说明书适用系统iVS8000适用产品文档版本V1.1H3C iVS8000系统报警联动协议SDK产品说明书V1.1杭州华三通信技术有限公司声明Copyright © 2007-2008 杭州华三通信技术有限公司及其许可者版权所有，保留一切权利。

未经本公司书面许可，任何单位和个人不得擅自摘抄、复制本书内容的部分或全部，并不得以任何形式传播。

除非另有约定，本手册仅作为使用指导，本手册中的所有陈述、信息和建议不构成任何明示或暗示的担保。

如需要获取最新手册，请登录。

H3C iVS8000系统报警联动协议SDK产品说明书关键词：SDK，API摘要：介绍了通过协议消息方式获取第三方报警信息，作为第三方以H3C iVS8000作为综合安防中心的报警接入参考。

缩略语清单：缩略语英文全名中文解释API Application Programming Interface 应用程序接口EC Encoder 编码器Encode 带存储的编码器ECR RecordableIP SAN IP Storage Area Network IP存储区域网络iVS IP Video Surveillance System IP视频监控系统Server 媒体交换服务器MS MediaSDK Software Develop Kit 软件开发包VC Video Management Client 视频管理客户端VM Video Management Server 视频管理服务器SDK版本配套表：SDK版本更新说明适用的iVS800服务器版本兼容性V1.0 对外发布 VM版本为E1216P06及以上V1.1 Bug修正，修改了结构： IE_EVENT_INFO VM版本为E1216P06及以上目录第1章 iVS8000系统概述 (4)1.1 基本业务功能 (4)第2章报警联动协议SDK解决方案概述 (5)2.1 H3C报警联动协议开放架构模型 (5)2.2 解决方案组网 (6)2.2.1 组网原理 (6)2.2.2 适用场景 (6)2.2.3 业务流程 (7)2.3 解决方案的功能规格 (7)第3章报警联动协议SDK产品接口消息说明 (8)3.1 事件上报Event消息 (8)3.1.1 消息与IE对应关系 (8)3.1.2 运用：流程与IE的对应关系 (9)3.2 下发透明通道传输Transparent消息 (10)3.2.1 消息与IE对应关系 (10)3.2.2 运用：流程与IE的对应关系 (11)3.3 IE的具体定义 (12)3.3.1 IE_HEADER (12)3.3.2 IE_DEVICE_ID (12)3.3.3 IE_DEVICE_NAME (12)3.3.4 IE_DEVICE_PORT_ID (12)3.3.5 IE_MANUFACTURER (13)3.3.6 IE_DEVICE_TYPE (13)3.3.7 IE_EVENT_INFO (13)3.3.8 IE_TRANSPARENT_DATA (13)3.4 基本结构体和枚举定义 (14)3.4.1 DEF_ST_TIME_VAL (14)3.4.2 DEF_ENM_COMMAND_TYPE (14)3.4.3 DEF_ENM_IE_TYPE (14)3.5 消息格式 (15)3.5.1 消息格式定义 (15)3.5.2 各字段说明 (16)3.5.3 对应消息头结构体 (17)3.5.4 消息体（Body） (17)3.6 消息传输方式 (19)3.6.1 端口定义 (19)3.6.2 事务（Transaction） (19)第1章 iVS8000系统概述网络视频监控系统的基本业务功能是实况、存储、点播、摄像机控制、告警处理。

但是随着经济的发展，社会对综合安防的需求越来越迫切，人们对视频监控系统的需求已经不再满足于传统的看、存、放、控等基本功能，而是要求基于视频监控系统提供的音视频数据基础上，提供更多智能化的、可增值的业务能力，如车牌识别、人像识别、运动路径检测、动态感知、门禁系统联动、对讲系统联动、报警联动等。

可以说，数字视频监控系统的综合安防化将是一个趋势，和企业IT系统的结合也将越来越紧密。

因此，传统视频监控厂商如何满足这些越来越复杂的用户需求，是必须要考虑的一个问题。

H3C iVS8000系统作为一个开放、标准、高质量的视频监控基础平台，可通过开放内部协议接口、开放SDK接口，与各安防业务系统的合作伙伴一道，以客户需求为导向，提供完善的应用级完整安防系统解决方案。

H3C开放接口API框架1.1 基本业务功能z媒体播放业务：实时监控、点播回放、录像存储与播放、屏幕抓拍、本地下载。

z远程控制业务：远程控制锁定、远程控制解锁、抢占远程控制、释放远程控制。

z数字矩阵业务：可以通过轮切方案的配置，将有操作权限的摄像机视频输出到任意监视器中。

z GIS地图服务：可在GIS地图功能下可以进行GIS地图的各种操作。

第2章报警联动协议SDK解决方案概述2.1 H3C报警联动协议开放架构模型报警联动协议SDK产品特指H3C报警联动开放协议接口，该接口以网络消息接口形式开放，用于第三方以H3C iVS8000为安防主机，将各种门禁系统、报警主机、智能视频分析系统、消防主机等产生的报警事件，以报警源接入到H3C监控系统中，并通过H3C监控系统进行报警联动和接处警。

2.2 解决方案组网2.2.1 组网原理报警联动协议SDK的组网图2.2.2 适用场景1、视频监控的门禁报警联动；2、视频监控的防盗报警联动；3、视频监控的火灾报警联动；4、视频监控的智能视频分析报警联动；5、视频监控的SCADA报警联动。

2.2.3 业务流程解决方案组网架构和联动流程2.3 解决方案的功能规格1. 实时监控到电视墙2. 实时监控到本地客户端3. 警前警后定时录像4. 云台转动到预置位5. 告警转发6. 告警在GIS地图上闪烁7. 告警日志记录第3章报警联动协议SDK产品接口消息说明3.1 事件上报Event消息3.1.1 消息与IE对应关系RequestHeaderIE_DEVICE_ID（必选）IE_DEVICE_NAME（可选）IE_DEVICE_PORT_ID（可选）IE_MANUFACTURER（必选）IE_DEVICE_TYPE（必选）IE_EVENT_INFO（必选）IE_DEVICE_ID（必选）：事件源设备ID，唯一标识触发事件的设备。

IE_DEVICE_NAME（可选）：事件源设备描述。

IE_DEVICE_PORT_ID（可选）：事件源设备的通道ID，标识事件源设备的通道ID。

IE_MANUFACTURER（必选）：事件源设备厂商。

IE_DEVICE_TYPE（必选）：事件源设备类型。

IE_EVENT INFO（必选）：事件信息。

Response OkHeaderResponse ErrHeader3.1.2 运用：流程与IE的对应关系外部设备事件上报F1（Request）：消息体携带的IE信息有IE_DEVICE_ID（必选）：事件源设备ID。

IE_DEVICE_NAME（可选）：事件源设备描述。

IE_DEVICE_PORT_ID（可选）：事件源设备的通道ID。

IE_MANUFACTURER（必选）：事件源设备厂商。

IE_DEVICE_TYPE（必选）：事件源设备类型。

IE_EVENT INFO（必选）：事件信息。

F2（Response Ok）：无消息体F3（Response Err）：无消息体VMVM 服务器向外部设备事件上报F1（Request ）：消息体携带的IE 信息有 IE_DEVICE_ID （必选）：事件源设备ID。

IE_DEVICE_NAME （可选）：事件源设备描述。

IE_DEVICE_PORT_ID （可选）：事件源设备的通道ID。

IE_MANUFACTURER （必选）：事件源设备厂商。

IE_DEVICE_TYPE （必选）：事件源设备类型。

IE_EVENT INFO （必选）：事件信息。

F2（Response Ok ）：无消息体 F3（Response Err ）：无消息体3.2 下发透明通道传输Transparent 消息3.2.1 消息与IE 对应关系RequestHeaderIE_DEVICE_ID （必选）IE_TRANSPARENT_DATA （必选）IE_DEVICE_ID ：数据源设备ID，唯一标识数据发送的设备。

IE_TRANSPARENT DATA （必选）：透明传输数据。

Response OkHeaderResponse ErrHeader3.2.2运用：流程与IE 的对应关系VMVM 向外部设备透明传输数据F1（Request ）：消息体携带的IE 信息有 IE_DEVICE_ID （必选）：事件源设备ID。

IE_TRANSPARENT_DATA（必选）：透明传输数据。

F2（Response Ok ）：无消息体 F3（Response Err ）：无消息体VM外部设备向VM 透明传输数据F1（Request ）：消息体携带的IE 信息有 IE_DEVICE_ID （必选）：事件源设备ID。

IE_TRANSPARENT_DATA（必选）：透明传输数据。

F2（Response Ok）：无消息体F3（Response Err）：无消息体3.3 IE的具体定义3.3.1 IE_HEADERStruct {UINT16 IeType; IE的具体类型，详见参数表UINT16 IeLengh; IE的长度，不含IE头的长度}3.3.2 IE_DEVICE_IDStruct {IE_HEADERUINT8 DeviceId[32]; 设备ID信息}3.3.3 IE_DEVICE_NAMEStruct {IE_HEADERUINT8 acDeviceName[64]; 设备ID信息}3.3.4 IE_DEVICE_PORT_IDStruct {IE_HEADER;UINT8 acDevicePortId[32]; /* 端子ID信息 */}3.3.5 IE_MANUFACTURERStruct {IE_HEADERUINT32 Name; 设备厂商信息}3.3.6 IE_DEVICE_TYPEStruct {IE_HEADERUNT32 DeviceType; 设备类型}3.3.7 IE_EVENT_INFOStruct {IE_HEADERDEF_ST_TIME_VAL Time; /* 事件触发的时间戳 */UINT32 firstEventType; /* 一级事件类型 */UINT32 SecondEventType; /* 二级事件类型，扩展字段暂不使用 */UINT32 EventLevel ; /* 事件级别，扩展字段暂不使用*/VOS_UINT32 ulEventDataLength; /* 事件描述的长度，在传送二进制数据时候用*/UINT8 acEventText[128]; /* 事件描述 */}3.3.8 IE_TRANSPARENT_DATAStruct {IE_HEADERUNIT32 PortNum; /* 数据输入输出端口号 */UINT32 DataLength; /* 数据长度，用于传递二进制信息的有效长度 */INT8 TransparentData[128]; /* 透明传输数据 */}3.4 基本结构体和枚举定义3.4.1 DEF_ST_TIME_VALstruct{UINT32 TvSec; /*秒：从1970年1月1日0时0分0秒算起*/UINT32 TvUsec /*毫秒*/}3.4.2 DEF_ENM_COMMAND_TYPE用于ST_VMP_MSG_HEADER中ucCommand字段值。