海康威视-NVR使用及ISAPI协议透传接入

1、初始化配置

1.1、设置通道默认密码

1.2、添加摄像头

1.3、设置不采集时间段

1.4、抓拍延迟设置

1.5、录像保存时长设置

1.6、人脸库维护

1.7、导入照片

1.8、设置事件

1.8.1、引擎配置

1.8.2、事件设置

1.8.2.1、目标比对

1.8.2.2、设置屏蔽区

1.8.2.3、人脸库

1.9、事件检索

2、ISAPI透传对接

2.1、下载SDK包

2.2、检查是否支持ISAPI

2.3、引入依赖

2.4、启动demo

3、java端接入

3.1、项目结构

3.2、类属性定义

3.3、初始化

3.4、登录

3.5、发起ISAPI调用

3.6、入参对象

3.7、出参对象

背景说明：

使用NVR网络录像机接入监控摄像头，NVR内置人脸库、人脸抓拍、比对功能、事件配置。

使用的设备型号：DS-9632NX-I8R/VPro

1、初始化配置

1.1、设置通道默认密码

1.2、添加摄像头

NVR具有自动广播功能，可以在下方的设备列表中显示所有摄像头。

然后选中添加上上方列表，开启监控。

注意勾选默认密码，否则会引起连接失败问题

1.3、设置不采集时间段

下图灰白区域表示摄像头不采集、不启用事件的事件范围，

选择一个摄像头进行配置

批量复制到其他监控

1.4、抓拍延迟设置

此处设置的开头、结尾延迟5秒，为后续的人物目标识别成功后，截取视频时间段前后五秒，共10秒的视频。默认延迟30s

1.5、录像保存时长设置

1.6、人脸库维护

1.7、导入照片

由于nvr限定jpg、jpeg类型，不支持png，所以需要进行转码

具体参见 Java工具-实现无损png转换jpg格式-CSDN博客

1.8、设置事件

1.8.1、引擎配置

必须要设置目标识别，否则人脸库无法建模，后续人脸目标比对无法进行。

1.8.2、事件设置

选择目标事件，确定必须启用

1.8.2.1、目标比对

选择目标比对，开启，

1.8.2.2、设置屏蔽区

点击右键绘图完毕

1.8.2.3、人脸库

关联人脸库和阈值设置

如果需要提高图片质量，可以设置仰俯角，避免低头、偏头图片

1.9、事件检索

在下图，设置检索条件

2、ISAPI透传对接

2.1、下载SDK包

地址：海康开放平台

下载对应操作系统的开发包

2.2、检查是否支持ISAPI

注意检查默认登录端口8000

选择内部的ISAPI透传的demo

2.3、引入依赖

将对应的库文件引入到项目的lib下

3. Windows开发时需要
将“库文件”文件夹中的HCNetSDK.dll、HCCore.dll、HCNetSDKCom文件夹、
libssl-1_1-x64.dll、libcrypto-1_1-x64.dll、hlog.dll、hpr.dll、zlib1.dll等文件拷贝到lib文件夹下，
HCNetSDKCom文件夹（包含里面的功能组件dll库文件）需要和HCNetSDK.dll、HCCore.dll一起加载，放在同一个目录下，
且HCNetSDKCom文件夹名不能修改。如果自行开发软件不能正常实现相应功能，而且程序没有指定加载的dll库路径，
请在程序运行的情况下尝试删除HCNetSDK.dll。如果可以删除，说明程序可能调用到系统盘Windows->System32目录下的dll文件，
建议删除或者更新该目录下的相关dll文件；如果不能删除，dll文件右键选择属性确认SDK库版本。

4. Linux开发时需要将“库文件”文件夹中libhcnetsdk.so、libHCCore.so、libcrypto.so.1.1、libssl.so.1.1、libhpr.so、libz.so
等文件拷贝到lib文件夹下。HCNetSDKCom文件夹（包含里面的功能组件dll库文件）需要和libhcnetsdk.so、libHCCore.so
一起加载，放在同一个目录下，且HCNetSDKCom文件夹名不能修改。如果库文件加载有问题，初始化失败，
也可以尝试将SDK所在路径添加到LD_LIBRARY_PATH环境变量中。

2.4、启动demo

启动类 JavaDemoSTDXMLConfigApp

启动后效果，使用这个demo可以进行api调试。

后续可以参照平台的接口出入参进行对接开发

3、java端接入

3.1、项目结构

win下存放dll文件，需要额外引入 sdk中的examples.jar、jna.jar文件

其中 HIKSDKStructure 类用于解决兼容低版本的Structure调用问题

import com.sun.jna.Structure;
import java.lang.reflect.Field;
import java.lang.reflect.Modifier;
import java.util.ArrayList;
import java.util.List;

/***
 * 由于 这个问题是因为海康jna.jar比较老,结构体定义没有getFiledOrder，可创建一个类继承 Structure
 * 产生错误：Structure.getFieldOrder() on class com.xxx.sdk.HCNetSDK$NET_DVR_DEVICEINFO_V30 does not provide enough names [0] ([]) to match declared fields [31] ([byAlarmInPortNum,
 * 解决：对 HCNetSDK 接口中的静态类里面，所有继承 Structure 替换为 HIKSDKStructure 即可
 * @author xuancg
 * @date 2024/6/13
 */
public class HIKSDKStructure extends Structure {
    protected List<String> getFieldOrder(){
        List<String> fieldOrderList = new ArrayList<String>();
        for (Class<?> cls = getClass();
             !cls.equals(HIKSDKStructure.class);
             cls = cls.getSuperclass()) {
            Field[] fields = cls.getDeclaredFields();
            int modifiers;
            for (Field field : fields) {
                modifiers = field.getModifiers();
                if (Modifier.isStatic(modifiers) || !Modifier.isPublic(modifiers)) {
                    continue;
                }
                fieldOrderList.add(field.getName());
            }
        }
        return fieldOrderList;
    }
}

HCNetSDK 类可以通过sdk中查找引入。但需要将所有的Structure 替换为HIKSDKStructure

public class OsSelect {

    public static boolean isLinux() {
        return System.getProperty("os.name").toLowerCase().contains("linux");
    }

    public static boolean isWindows() {
        return System.getProperty("os.name").toLowerCase().contains("windows");
    }
}