177Java利用JNI调用C++编写的DLL，连接海康人脸抓拍机，实现人脸库全量更新。

Posted 2023-02-26 zhangchao19890805

C++开发环境：Visual Studio 2022、windows10
Java开发环境：Java8、idea、windows10

这个DLL功能，是输入一个设备IP，删除设备中的所有以前的人员资料，然后用文件夹中XML和图片的新人脸库资料上传到设备的人脸库中。相当于是覆盖旧人脸库的操作。

编写调用DLL的Java代码：

FaceJni.java

package com.rzfk.jni;

/**
 * @author zhangchao
 * javah -jni com.rzfk.jni.FaceJni
 */
public class FaceJni 

    // 获取海康人脸库能力集。
    public native int updateFaceLib(String ip);

    static 
        System.loadLibrary("zhangchao_face_dll");
    

idea 点击右侧 Maven 按钮，在弹出的右侧边栏中，点击项目名 -> 点击 Lifecycle -> compile 编译Java代码。

命令行通过cd命令进入 [项目地址]\\target\\classes 文件夹。输入命令:

javah -jni com.rzfk.jni.FaceJni

这个时候 classes 文件夹中会看到 com_rzfk_jni_FaceJni.h 文件，这个文件会在后面用到。

接下来在VS2022中创建DLL项目。

打开VS2022，入下图点击 文件、新建、项目：

如下图选择DLL项目，后面输入项目名称和硬盘路径即可。项目名称 zhangchao_face_dll，和Java代码中的 System.loadLibrary("zhangchao_face_dll"); 对应起来。

项目下面创建 header 文件夹和 dll 文件夹，把海康的头文件和dll文件分别放到两个文件夹中。header文件夹中再放入 com_rzfk_jni_FaceJni.h 文件。假设我把jdk安装到 D:\\program\\Java\\jdk1.8.0_291 路径下，把 D:\\program\\Java\\jdk1.8.0_291\\include\\jni.h 复制到header文件夹中。把 D:\\program\\Java\\jdk1.8.0_291\\include\\win32\\jni_md.h 文件放入header 文件夹中。

项目配置可以参考 【160】VS2022调试通过海康摄像头烟火识别SDK

我把上面文章最后提到的4个系统dll文件也放入了dll文件夹中。注意Release也要修改。

详细的C++代码，我放到了码云上：https://gitee.com/zhangchao19890805/csdnBlog 克隆代码后进入 blog177 文件夹，其中 zhangchao_face_dll 文件夹就是C++的DLL项目。读者在克隆代码后可以用　VS2022 直接打开项目即可。

打包步骤：VS2022解决方案配置选择Release，点击【生成】 -> 【生成解决方案】即可。进入项目文件夹下的x64\\Release 路径下，把 zhangchao_face_dll.dll 文件复制到和jar包同目录下，此目录下还要放入上文提到的dll文件中的所有文件。准备好后运行jar包调用DLL的方法，即可运行DLL中的代码。

在调用DLL之前，需要先创建好下面几个文件夹：

D:\\your_hk_log_folder\\           海康日志文件夹
D:\\your_log_folder\\                 C++代码日志文件夹
D:\\your_xml\\                           要上传的人员信息XML文件夹
D:\\your_img\\                           要上传的人脸图片文件夹

你可以搜索代码中的路径做替换，换成你需要的路径。

在调用DLL更新人脸库之前，要先创建号每个人员对应的XML文件和人脸图片。同一个人的XML和人脸图片要文件名一样。建议文件名由英文或数字组成。

XML文件格式：

<FaceAppendData version="2.0" xmlns="http://www.hikvision.com/ver20/XMLSchema">
<bornTime>2014-12-12T00:00:00Z</bornTime>
<name>辛某飞</name>
<sex>female</sex>
<certificateType>ID</certificateType>
<certificateNumber>100001</certificateNumber>
<PersonInfoExtendList>
<PersonInfoExtend>
<id>1</id>
<enable>false</enable>
<name></name>
</PersonInfoExtend>
</PersonInfoExtendList>
</FaceAppendData>

sex标签是性别，female是女性，male是男性。

certificateType标签是证件类型，OfficerID-军官证, ID-身份证, passportID-护照, other-其他 。

certificateNumber标签是证件号码。