海康威视人脸门禁对接开发(一)准备篇

本文详细介绍了在海康设备上开发人脸识别考勤模块的过程,包括设备注册、下发卡号与人脸信息、获取和删除卡号及人脸信息等关键功能。通过使用海康SDK,实现了设备的远程配置和管理,提供了具体的代码示例和开发步骤。

前一段时间在HR系统中做了一个人脸识别考勤的模块,主要功能:设备注册,下发卡号与人脸,获取卡号与人脸,删除卡号与人脸,对设备布防,报警回调函数。

首先在Window上开发,我们项目的JDK是1.6(64位),所以必须要用Win64的SDK开发包,这个很重要,版本对不上,在调用HCNetSDK.dll这个库文件时会报错,现在开始开发。

1.先去海康官网下载最新的SDK 官网地址:https://www.hikvision.com/cn/,下载你JDK版本对应的SDK(里面包含Java的demo),你如果不知道你的JDK对应什么SDK,可以去找海康销售跟他要海康技术支持的邮箱,你在开发过程中所有遇到的问题都可以用邮件询问。

2.在你的项目中新建一个文件夹用来放置库文件,可以直接将SDK中的库文件一股脑全放进来,我这里就是全放进来的,如图:

3.将java的demo中的examples.jar和jna.jar加载到自己的项目中,将java的demo中HCNetSDK.java 直接复制到自己的项目中,我们就是通过实现这个接口的方法来对设备进行操作。

4.根据sdk手册的信息建立相应的类,接口,回调函数,新建立的这些最好也放到HCNetSDK.java中。

图中红圈表示HCNetSDK.java要去加载HCNetSDK.dll文件

所以需要写一个路径加载类:HCNetSDKPath.java

package com.ykl;

import java.io.UnsupportedEncodingException;

public class HCNetSDKPath {
		
	public static String dllPath;//HCNetSDK.dll 文件路径
	
	public static void main(String[] args) {
		String path = (HCNetSDKPath.class.getResource("/HCNetSDK/HCNetSDK.dll").getPath())
				.replaceAll("%20", " ").substring(1).replace("/","\\");
        System.out.println(path);
		try {
        	dllPath = java.net.URLDecoder.decode(path, "utf-8");
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
        System.out.println(dllPath);
	}
}

在自己的类中需要实例化HCNetSDK,具体写法是:HCNetSDK hCNetSDK = HCNetSDK.INSTANCE;

5.接下来写一个工具类,里面有调用设备的基础方法:HCNetDeviceUtil.java

package com.utils;

import java.io.ByteArrayInputStream;
import java.io.UnsupportedEncodingException;

import com.sun.jna.NativeLong;
import com.sun.jna.Pointer;
import com.ykl.FMSGCallBack_V31;

public class HCNetDeviceUtil {
	
	HCNetSDK hcNetSDK=HCNetSDK.INSTANCE;
	HCNetSDK.NET_DVR_USER_LOGIN_INFO m_strLoginInfo = new         HCNetSDK.NET_DVR_USER_LOGIN_INFO();//设备登录信息
    HCNetSDK.NET_DVR_DEVICEINFO_V40 m_strDeviceInfo = new HCNetSDK.NET_DVR_DEVICEINFO_V40();//设备信息
    static FMSGCallBack_V31 fMSFCallBack_V31;//报警回调函数实现类
    FRemoteCfgCallBackCardGet fRemoteCfgCallBackCardGet;//获取卡参数回调函数实现类
    FRemoteCfgCallBackCardSet fRemoteCfgCallBackCardSet;//下发卡回调函数实现类
    FRemoteCfgCallBackFaceGet fRemoteCfgCallBackFaceGet;//获取人脸回调函数实现类
    FRemoteCfgCallBackFaceSet fRemoteCfgCallBackFaceSet;//下发人脸回调函数实现类
    

    //登录设备,设备会返回,唯一用户ID:lUserID
    public String loginDevice(String ip,String port,String userName,String password) {
    	//初始化SDK
    	boolean status = hcNetSDK.NET_DVR_Init();
    	if(status!=true) {
    		System.out.println("初始化失败:"+hcNetSDK.NET_DVR_GetCardLastError_Card());
    	}else {
    		System.out.println("初始化成功!");
    	}
    	//设置报警回调函数,这个函数将会上次人脸识别比对结果
    	if (fMSFCallBack_V31 == null){
            fMSFCallBack_V31 = new FMSGCallBack_V31();
            Pointer pUser = null;
            if (!hcNetSDK.NET_DVR_SetDVRMessageCallBack_V31(fMSFCallBack_V31, pUser)){
                System.out.println("设置回调函数失败!");
            }
        }
    	
    	//注册
        String m_sDeviceIP = ip;//设备ip地址  
        m_strLoginInfo.sDeviceAddress = new byte[HCNetSDK.NET_DVR_DEV_ADDRESS_MAX_LEN];
        System.arraycopy(m_sDeviceIP.getBytes(), 0, m_strLoginInfo.sDeviceAddress, 0, m_sDeviceIP.length());
        
        String m_sUsername = userName;//设备用户名
        m_strLoginInfo.sUserName = new byte[HCNetSDK.NET_DVR_LOGIN_USERNAME_MAX_LEN];
        System.arraycopy(m_sUsername.getBytes(), 0, m_strLoginInfo.sUserName, 0, m_sUsername.length());
        
        String m_sPassword = password;//设备密码
        m_strLoginInfo.sPassword = new byte[HCNetSDK.NET_DVR_LOGIN_PASSWD_MAX_LEN];
        System.arraycopy(m_sPassword.getBytes(), 0, m_strLoginInfo.sPassword, 0, m_sPassword.length());
        
        m_strLoginInfo.wPort = (short)Integer.parseInt(port);
        
        m_strLoginInfo.bUseAsynLogin = false; //是否异步登录:0- 否,1- 是
        
        m_strLoginInfo.write();
        int lUserID = hcNetSDK.NET_DVR_Login_V40(m_strLoginInfo, m_strDeviceInfo);

        if (lUserID == -1) {
            System.out.println( "注册失败,错误号:" +  hcNetSDK.NET_DVR_GetLastError());
            //这里自己做错误处理
        } 
        return lUserID+"";
    }
    
    //获取卡参数
    public void GetCardInfo(int lUserID){
        int iErr = 0;
        HCNetSDK.NET_DVR_CARD_CFG_COND m_struCardInputParam = new HCNetSDK.NET_DVR_CARD_CFG_COND();
        m_struCardInputParam.dwSize = m_struCardInputParam.size();
        m_struCardInputParam.dwCardNum = 0xffffffff; //查找全部
        m_struCardInputParam.byCheckCardNo = 1;

        Pointer lpInBuffer = m_struCardInputParam.getPointer();
        fRemoteCfgCallBackCardGet = new FRemoteCfgCallBackCardGet();
        m_struCardInputParam.write();

        HCNetSDK.MY_USER_DATA userData = new HCNetSDK.MY_USER_DATA();
        userData.dwSize = userData.size();
        userData.byteData = "1234567".getBytes();
        Pointer pUserData = userData.getPointer();
        userData.write();

        int lHandle = hcNetSDK.NET_DVR_StartRemoteConfig(lUserID, HCNetSDK.NET_DVR_GET_CARD_CFG_V50, lpInBuffer, m_struCardInputParam.size(),fRemoteCfgCallBackCardGet, pUserData);
        if (lHandle < 0){
            iErr = hcNetSDK.NET_DVR_GetLastError();
            System.out.println("建立长连接失败:"+hcNetSDK.NET_DVR_GetCardLastError_Card());
            return;
        }
        System.out.println(
<think>好的,用户想了解海康威视人脸门禁SDK对接流程。首先,我需要确认用户的需求背景。可能他们正在开发门禁系统,需要集成海康的设备。接下来,我得回忆海康SDK的文档结构,通常包括开发环境准备SDK获取、初始化、功能调用等步骤。 用户可能关心如何开始,所以第步应该是注册和获取SDK。需要提醒他们去官网申请,可能需要企业资质。然后,开发环境配置,比如Windows还是Linux,依赖库的安装。这部分容易出错,要详细说明。 接下来,SDK的初始化流程很重要,包括加载库、登录设备。网络参数和设备信息是关键,用户可能需要帮助处理连接问题,比如IP、端口、用户名密码是否正确。然后,人脸功能的启用,如参数配置,这里可能需要解释结构体参数的含义。 实时回调函数和报警处理可能比较复杂,用户需要示例代码来理解如何监听事件。还有人脸库管理,增删改查操作,这部分涉及数据库交互,要注意数据同步和性能问题。 最后,调试和错误处理是常见难点,得提醒用户查看日志,处理网络波动和设备兼容性。安全方面,数据加密和权限控制也不能忽视。 需要确保回答结构清晰,分步骤讲解,避免使用专业术语过多,同时提供实际开发中的注意事项,帮助用户避免常见陷阱。可能还需要提到官方文档和技术支持的重要性,以及测试阶段的建议,比如先用Demo验证再正式集成。</think>海康威视人脸门禁SDK对接技术解析(分步骤说明) 准备工作 1. 环境要求 - 开发平台:Windows/Linux(需与设备系统匹配) - 开发语言:推荐C++/C#/Java(海康提供多语言接口) - 依赖库:需安装HCNetSDK库(海康官网下载) 2. 硬件准备 - 确认设备型号支持人脸识别功能(如DS-K1T671MW、DS-K5604系列) - 确保设备固件版本≥V4.50.000(不同版本接口可能不同) 二、SDK对接流程 1. 初始化SDK ```csharp // C#示例 CHCNetSDK.NET_DVR_Init(); // SDK初始化 CHCNetSDK.NET_DVR_SetConnectTime(2000, 1); // 设置超时 ``` 2. 设备登录 ```cpp // C++示例 NET_DVR_DEVICEINFO_V40 devInfo; LONG lUserID = NET_DVR_Login_V40( "192.168.1.64", // 设备IP 8000, // 端口 "admin", // 用户名 "password", // 密码 &devInfo); ``` 3. 人脸功能启用 ```java // Java配置参数示例 NET_DVR_FACE_PARAM_CFG config = new NET_DVR_FACE_PARAM_CFG(); config.dwSize = config.size(); config.byFaceSnapScore = 80; // 识别阈值 config.byEnableFaceSnap = 1; // 启用人脸抓拍 ``` 三、核心功能对接 1. 实时回调设置 ```cpp // 报警回调函数 NET_DVR_SetDVRMessageCallBack_V50(0, MessageCallback, NULL); // 人脸识别事件处理 void CALLBACK MessageCallback(LONG lCommand, NET_DVR_ALARMER *pAlarmer, char *pAlarmInfo, DWORD dwBufLen, void* pUser) { if(lCommand == COMM_ALARM_FACE_DETECTION) { // 处理人脸识别事件 } } ``` 2. 人脸库管理 - 添加人脸记录:`NET_DVR_AddFaceData_STD` - 删除人脸:`NET_DVR_DeleteFaceData_STD` - 查询人脸:`NET_DVR_FindFaceData_STD` 四、注意事项 1. 常见错误处理 - 错误码1018:设备未授权 → 检查激活状态 - 错误码12:网络超时 → 检查网络连接 - 错误码10:参数错误 → 验证输入参数格式 2. 性能优化 - 建议采用异步回调机制 - 人脸库超过10万条时需分页处理 - 启用压缩传输(H.265格式可降低带宽30%) 五、安全规范 1. 必须启用HTTPS协议传输敏感数据 2. 人脸数据存储需符合GB/T 35273-2020《信息安全技术》标准 3. 建议采用动态密钥交换机制(海康提供AES256加密接口) 六、测试验证 1. 使用海康官方测试工具iVMS-4200验证基础功能 2. 压力测试建议: $$ \text{并发处理能力} = \frac{\text{设备最大吞吐量}}{\text{单次识别耗时}} \times 0.7 $$ 3. 准确率验证需通过NIST FRVT测试标准 最新对接建议(2024): 1. 优先选用ISUP7.0协议版本 2. 推荐使用混合云架构降低本地计算压力 3. 注意遵守《个人信息保护法》关于生物特征数据的存储要求 开发文档获取: 访问海康开放平台(https://open.hikvision.com)下载最新版《人脸门禁开发指南V5.3》,需注册企业账号并通过认证。
评论 48
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值