Java 接入海康 SDK 云台控制

原创

已于 2024-09-04 17:55:03 修改 · 3.5k 阅读

34 ·

CC 4.0 BY-SA版权

文章标签：

#java #spring boot

于 2024-09-04 17:50:32 首次发布

简介

Java 接入海康 SDK 设置 PTZ，主要实现云台基本控制和云台预置点两个功能：

云台基本控制：

NET_DVR_PTZControl：云台控制操作(需先启动图象预览)
NET_DVR_PTZControl_Other：云台控制操作(不用启动图象预览)
NET_DVR_PTZControlWithSpeed：带速度的云台控制操作(需先启动图象预览)
NET_DVR_PTZControlWithSpeed_Other：带速度的云台控制操作(不用启动图象预览)

云台预置点功能：

NET_DVR_PTZPreset：云台预置点操作（需先启动预览）
NET_DVR_PTZPreset_Other云台预置点操作(不用启动预览)

下载 SDK

首先，我们需要下载并安装海康SDK，并进行相关配置。具体步骤如下：

在海康威视官网下载 SDK 开发包，解压缩到本地目录
配置环境变量，将 SDK 的 bin 目录添加到系统的 PATH 环境变量中
在项目中引入SDK的jar包

下载SDK：https://open.hikvision.com/download/5cda567cf47ae80dd41a54b3?type=10&id=5cda5902f47ae80dd41a54b7

实现功能

添加依赖

在项目目录下新建 lib 文件夹，将下载的 SDK 开发包 库文件 里的 HCNetSDK.dll、HCCore.dll、HCNetSDKCom文件夹、libssl-1_1.dll、libcrypto-1_1.dll、hlog.dll、hpr.dll、zlib1.dll、PlayCtrl.dll、SuperRender.dll、AudioRender.dll 等文件均要加载到程序里面，HCNetSDKCom文件夹（包含里面的功能组件dll库文件） 需要和 HCNetSDK.dll、HCCore.dll 一起加载，放在同一个目录下，且 HCNetSDKCom 文件夹名不能修改。

同时将 jna.jar 和 examples.jar 也放在 lib 目录下。

在这里插入图片描述

pom.xml

<dependency>
    <groupId>com.sun</groupId>
    <artifactId>jna</artifactId>
    <version>1.0.0</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/jna.jar</systemPath>
</dependency>
<dependency>
    <groupId>com.sun</groupId>
    <artifactId>examples</artifactId>
    <version>1.0.0</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/examples.jar</systemPath>
</dependency>

实现代码

SDK初始化

static HCNetSDK hCNetSDK = null;
static FExceptionCallBack_Imp fExceptionCallBack;

static class FExceptionCallBack_Imp implements HCNetSDK.FExceptionCallBack {
   
   
    public void invoke(int dwType, int lUserID, int lHandle, Pointer pUser) {
   
   
        log.error("异常事件类型：{}", dwType);
        return;
    }
}

/**
    * @MonthName： init
    * @Description： SDK初始化
    * @Param： []
    * @return： void
    **/
public static void init() {
   
   
    // 动态库加载
    if (hCNetSDK == null) {
   
   
        synchronized (HCNetSDK.class) {
   
   
            String strDllPath = "";
            try {
   
   
                hCNetSDK = (HCNetSDK) Native.loadLibrary(System.getProperty("user.dir") + "\\lib\\HCNetSDK.dll", HCNetSDK.class);
            } catch (Exception ex) {
   
   
                log.error("加载SDK失败，loadLibrary: {}，Error: {}", strDllPath, ex.getMessage());
                return;
            }
        }
    }

    // SDK初始化，一个程序只需要调用一次
    boolean initSuc = hCNetSDK.NET_DVR_Init();
    log.info("SDK初始化: {}", initSuc);

    // 异常消息回调
    if (fExceptionCallBack == null) {
   
   
        fExceptionCallBack = new FExceptionCallBack_Imp();
    }

    Pointer pUser = null;
    if (!hCNetSDK.NET_DVR_SetExceptionCallBack_V30(0, 0, fExceptionCallBack, pUser)) {
   
   
        return;
    }
    log.info("设置异常消息回调成功");

    // 启动SDK写日志
    hCNetSDK.NET_DVR_SetLogToFile(3, "./sdkLog", false);
}

/**
* @MonthName： login
* @Description： 登录
* @Param： [ip, port, user, psw]
* @return： Integer
**/
public static Integer login(String ip, Integer port, String user, String psw) {
   
   
    // 创建设备登录信息和设备信息对象
    HCNetSDK.NET_DVR_USER_LOGIN_INFO loginInfo = new HCNetSDK.NET_DVR_USER_LOGIN_INFO();
    HCNetSDK.NET_DVR_DEVICEINFO_V40 deviceInfo = new HCNetSDK.NET_DVR_DEVICEINFO_V40();

    // 设置设备IP地址
    byte[] deviceAddress