视频联网云平台EasyCVR是一个集视频联网共享、存储、流媒体转发、视频转码、视频上云、智能分析统一等多种功能为一体的流媒体视频服务融合性平台。EasyCVR可以集成海康EHome私有协议，本文讲一下EasyCVR集成海康EHome协议报警模块。
开启监听服务并接收设备报警信息依赖于中心管理服务（CMS）和报警管理服务（AMS）。监听服务开启后，当报警被触发时，设备会自动上传报警，因此可通过配置监听服务（即AMS）接收报警信息。
开启监听服务并接收报警的接口调用流程图：
操作基本步骤：
1、调用NET_EALARM_StartListen开启AMS报警监听并注册回调函数用于接收报警信息。AMS的IP地址和端口号由CMS发送给设备。
2、当报警触发时，从AMS注册的回调函数中获取报警信息进行处理。
3、调用NET_EALARM_StopListen停止AMS报警监听。
4、调用NET_ECMS_ForceLogout强制注销设备
前提条件：
1、请确保已调用NET_ECMS_Init和NET_EALARM_Init初始化CMS和AMS。
2、请确保已调用NET_ECMS_StartListen开启CMS监听以接收设备注册信息。
如果是ehome v4 版本，设备要设置SessionKey，SessionKey可通过回调数据类型“enum_dev_sessionkey”获得。
开启监听服务并接收报警的示例代码
注：在该示例代码中，CMS和AMS安装在同一台电脑的同一个程序中。
#include <stdio.h>
#include <Windows.h>
#include "HCISUPCMS.h"
#include "HCISUPAlarm.h"
LONG lLoginID = -1;
LONG lListenHandle = -1;
//
//注册回调函数
BOOL CALLBACK RegisterCallBack(LONG lUserID, DWORD dwDataType, void *pOutBuffer, DWORD dwOutLen, void *pInBuffer, DWORD dwInLen, void *pUser)
{
if (ENUM_DEV_ON == dwDataType)
{
NET_EHOME_DEV_REG_INFO *pDevInfo = (NET_EHOME_DEV_REG_INFO *)pOutBuffer;
if (pDevInfo != NULL)
{
lLoginID = lUserID;
printf("On-line, lUserID: %d, Device ID: %s
", lLoginID, pDevInfo->byDeviceID);
}
//输入参数
NET_EHOME_SERVER_INFO *pServerInfo = (NET_EHOME_SERVER_INFO *)pInBuffer;
pServerInfo->dwTimeOutCount = 6; //心跳超时次数
pServerInfo->dwKeepAliveSec = 15; //心跳间隔
memcpy(pServerInfo->struUDPAlarmSever.szIP, "10.16.2.123", sizeof("10.16.2.123")); //报警服务器IP地址（TCP协议）
pServerInfo->struUDPAlarmSever.wPort = 7200; //报警服务器端口（UDP协议），需要和报警服务器启动监听的端口一致
pServerInfo->dwAlarmServerType = 0; //报警服务器类型：0- 只支持UDP协议上报，1- 支持UDP、TCP两种协议上报
}
else if (ENUM_DEV_OFF == dwDataType)
{
printf("Off-line, lUserID: %d
", lUserID);
NET_ECMS_ForceLogout(lUserID);
}
else
{
}
return TRUE;
}
//
//AMS报警回调函数
BOOL CALLBACK AlarmMSGCallBack(LONG lHandle, NET_EHOME_ALARM_MSG *pAlarmMsg, void *pUserData)
{
lListenHandle = lHandle;
DWORD dwType = pAlarmMsg->dwAlarmType; //不同的报警类型(dwAlarmType)，pAlarmInfo对应不同的报警信息类型
printf("Callback of alarm listening, dwAlarmType[%d]
", dwType);
switch(dwType)
{
case EHOME_ALARM_UNKNOWN://未知报警信息
printf("Unknown Alarm Type!
");
break;
case EHOME_ALARM://基本报警信息：移动侦测、视频遮盖、视频丢失、PIR报警、人脸侦测、区域入侵等
NET_EHOME_ALARM_INFO struAlarmInfo;
memcpy(&struAlarmInfo, pAlarmMsg->pAlarmInfo, sizeof(NET_EHOME_ALARM_INFO));
printf("Basic Alarm: Device ID[%s], szAlarmTime[%s], Alarm Type[%d], Action[%d], VideoChannel[%d]!
", struAlarmInfo.szDeviceID,
struAlarmInfo.szAlarmTime, struAlarmInfo.dwAlarmType, struAlarmInfo.dwAlarmAction, struAlarmInfo.dwVideoChannel);
break;
case EHOME_ALARM_HEATMAP_REPORT://热度图报告上传
NET_EHOME_HEATMAP_REPORT struHeatmapInfo;
memcpy(&struHeatmapInfo, pAlarmMsg->pAlarmInfo, sizeof(NET_EHOME_HEATMAP_REPORT));
printf("Heatmap report: Device ID[%s], StartTime[%s], StopTime[%s], dwVideoChannel[%d]!
", struHeatmapInfo.byDeviceID,
struHeatmapInfo.byStartTime, struHeatmapInfo.byStopTime, struHeatmapInfo.dwVideoChannel);
break;
case EHOME_ALARM_FACESNAP_REPORT://人脸抓拍报告上传
NET_EHOME_FACESNAP_REPORT struFaceSnap;
memcpy(&struFaceSnap, pAlarmMsg->pAlarmInfo, sizeof(NET_EHOME_FACESNAP_REPORT));
printf("Face snap: Device ID[%s], AlarmTime[%s], dwFaceScore[%d], dwVideoChannel[%d]!
", struFaceSnap.byDeviceID,
struFaceSnap.byAlarmTime, struFaceSnap.dwFaceScore, struFaceSnap.dwVideoChannel);
break;
case EHOME_ALARM_GPS://GPS信息上传
NET_EHOME_GPS_INFO struGpsInfo;
memcpy(&struGpsInfo, pAlarmMsg->pAlarmInfo, sizeof(NET_EHOME_GPS_INFO));
printf("GPS info: Device ID[%s], SampleTime[%s], Longitude[%d], Latitude[%d]!
", struGpsInfo.byDeviceID,
struGpsInfo.bySampleTime, struGpsInfo.dwLongitude, struGpsInfo.dwLatitude );
break;
case EHOME_ALARM_CID_REPORT://报警主机CID报警信息
NET_EHOME_CID_INFO struCIDInfo;
memcpy(&struCIDInfo, pAlarmMsg->pAlarmInfo, sizeof(NET_EHOME_CID_INFO));
printf("CID info: Device ID[%s], AlarmTime[%s], CID Code[%d], CID Type[%d], CID Describe[%s]!
", struCIDInfo.byDeviceID,
struCIDInfo.byTriggerTime, struCIDInfo.dwCIDCode, struCIDInfo.dwCIDType, struCIDInfo.byCIDDescribe );
break;
default:
break;
}
return TRUE;
}
void main(){
//开启AMS报警监听
//AMS初始化
NET_EALARM_Init();
//报警监听参数
NET_EHOME_ALARM_LISTEN_PARAM struListen = {0};
memcpy(struListen.struAddress.szIP, "10.16.2.123", sizeof("10.16.2.123"));
struListen.struAddress.wPort = 7200; //报警服务的监听端口
struListen.fnMsgCb = AlarmMSGCallBack; //报警回调函数
struListen.pUserData = NULL;
struListen.byProtocolType = 1; //0- TCP方式(保留，暂不支持)，1- UDP方式
//启动报警监听
LONG lHandle = NET_EALARM_StartListen(&struListen);
if(lHandle < -1)
{
printf("NET_EALARM_StartListen failed, error code: %d
", NET_EALARM_GetLastError());
NET_EALARM_Fini();
return;
}
printf("NET_EALARM_StartListen!
");
//
//CMS注册模块初始化
NET_ECMS_Init();
//注册监听参数
NET_EHOME_CMS_LISTEN_PARAM struCMSListenPara = {0};
memcpy(struCMSListenPara.struAddress.szIP, "0.0.0.0", sizeof("0.0.0.0"));
struCMSListenPara.struAddress.wPort = 7660;
struCMSListenPara.fnCB = RegisterCallBack;
//启动监听，接收设备注册信息，注册回调函数里面需要发送报警主机IP和端口给设备
LONG lListen = NET_ECMS_StartListen(&struCMSListenPara);
if(lListen < -1)
{
printf("NET_ECMS_StartListen failed, error code: %d
", NET_ECMS_GetLastError());
NET_ECMS_Fini();
return;
}
printf("NET_ECMS_StartListen!
");
while(1)
{
Sleep(1000); //注册成功之后再做后续操作
if(lLoginID >= 0)
{
break;
}
}
Sleep(300000); //等待5分钟，接收报警信息
//退出
//CMS停止监听
if(!NET_ECMS_StopListen(lListen))
{
printf("NET_ECMS_StopListen failed, error code: %d
", NET_ECMS_GetLastError());
}
//CMS反初始化，释放资源
NET_ECMS_Fini();
//AMS停止报警监听
if(lListenHandle >= 0)
{
if (!NET_EALARM_StopListen(lListenHandle))
{
printf("NET_EALARM_StopListen failed, error code: %d
", NET_ECMS_GetLastError());
}
}
//AMS反初始化，释放资源
NET_EALARM_Fini();
printf("Exit!");
}
如果大家还想了解更多关于EasyCVR集成海康EHome私有协议的调用和说明，可以翻阅TSINGSEE青犀视频往期相关文章，其中包括：设备录像回看说明、语音对讲操作流程、Ehome协议调用流程介绍等。