Java 接入海康 SDK 云台控制

2024-09-04 21:36
文章标签 java sdk 控制 海康 接入 云台

本文主要是介绍Java 接入海康 SDK 云台控制，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

简介

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 = new byte[HCNetSDK.NET_DVR_DEV_ADDRESS_MAX_LEN];byte[] ipBytes = ip.getBytes();System.arraycopy(ipBytes, 0, deviceAddress, 0, Math.min(ipBytes.length, deviceAddress.length));loginInfo.sDeviceAddress = deviceAddress;// 设置用户名和密码byte[] userName = new byte[HCNetSDK.NET_DVR_LOGIN_USERNAME_MAX_LEN];byte[] password = psw.getBytes();System.arraycopy(user.getBytes(), 0, userName, 0, Math.min(user.length(), userName.length));System.arraycopy(password, 0, loginInfo.sPassword, 0, Math.min(password.length, loginInfo.sPassword.length));loginInfo.sUserName = userName;// 设置端口和登录模式loginInfo.wPort = port.shortValue();loginInfo.bUseAsynLogin = false; // 同步登录loginInfo.byLoginMode = 0; // 使用SDK私有协议// 执行登录操作int userID = hCNetSDK.NET_DVR_Login_V40(loginInfo, deviceInfo);if (userID == -1) {log.error("登录失败，错误码为: {}", hCNetSDK.NET_DVR_GetLastError());} else {log.info("{} 设备登录成功！", ip);// read()后，结构体中才有对应的数据deviceInfo.read();// 处理通道号逻辑int startDChan = deviceInfo.struDeviceV30.byStartDChan;log.info("预览起始通道号: {}", startDChan);}// 返回登录结果return userID;
}

登出

/**
* @MonthName： logout
* @Description： 退出登录
* @Param： [lUserID]
* @return： void
**/
public static void logout(Integer lUserID) {if (Objects.nonNull(hCNetSDK) && Objects.nonNull(lUserID)) {hCNetSDK.NET_DVR_Logout(lUserID);hCNetSDK.NET_DVR_Cleanup();}
}

设置球机预置点(不用启动图象预览)

/**
* @MonthName： setPTZPresetOther
* @Description： 设置球机预置点(不用启动图象预览)
* @Param： 
* lChannel：通道号
* dwPTZPresetCmd：8、设置预置点，9、清除预置点，39、转到预置点
* dwPresetIndex：预置点的序号（从1开始），最多支持300个预置点
* @return： void
**/
public static void setPTZPresetOther(String ip, Integer port, String username, String password, Integer lChannel, Integer dwPTZPresetCmd, Integer dwPresetIndex) {Integer lUserID = null;try {init();lUserID = login(ip, port, username, password);// 设置球机预置点if (lUserID != -1) {log.info("设置预置点开始：lUserID：{}，lChannel：{}，dwPTZPresetCmd：{}，dwPresetIndex：{}", lUserID, lChannel, dwPTZPresetCmd, dwPresetIndex);boolean status = hCNetSDK.NET_DVR_PTZPreset_Other(lUserID, lChannel, dwPTZPresetCmd, dwPresetIndex);if (status) {log.info("设置预置点成功");} else {log.error("设置预置点失败，错误码：{}", hCNetSDK.NET_DVR_GetLastError());}}} catch (Exception e) {log.error("设置预置点异常：{}", e);} finally {logout(lUserID);}
}

云台控制操作(不用启动图象预览)

/**
* @MonthName： setPTZControlOther
* @Description： 云台控制操作(不用启动图象预览)
* @Param： 
* lChannel：通道号
* dwPTZCommand：云台控制命令【21、上仰，22、下俯，23、左转，24、右转】
* dwStop：云台停止动作或开始动作：0－开始，1－停止
* dwSpeed：云台控制的速度，用户按不同解码器的速度控制值设置。取值范围[1,7]
* @return： void
**/
public static void setPTZControlOther(String ip, Integer port, String username, String password, Integer lChannel, Integer dwPTZCommand, Integer dwStop, Integer dwSpeed) {Integer lUserID = null;try {init();lUserID = login(ip, port, username, password);if (lUserID != -1) {log.info("云台控制操作：lUserID：{}，lChannel：{}，dwPTZPresetCmd：{}，dwPresetIndex：{}，dwSpeed：{}", lUserID, lChannel, dwPTZCommand, dwStop, dwSpeed);boolean status = false;if (Objects.isNull(dwSpeed)) {status = hCNetSDK.NET_DVR_PTZControl_Other(lUserID, lChannel, dwPTZCommand, dwStop);} else {// 带速度status = hCNetSDK.NET_DVR_PTZControlWithSpeed_Other(lUserID, lChannel, dwPTZCommand, dwStop, dwSpeed);}if (status) {log.info("云台控制操作成功");} else {log.error("云台控制操作失败，错误码：{}", hCNetSDK.NET_DVR_GetLastError());}}} catch (Exception e) {log.error("云台控制操异常：{}", e);} finally {logout(lUserID);}
}

完整代码

package com.demo.util;import com.demo.common.HCNetSDK;
import com.sun.jna.Native;
import com.sun.jna.Pointer;
import lombok.extern.slf4j.Slf4j;import java.util.Objects;/*** @ClassName： HCNetSDKUtil.java* @ClassPath： com.demo.util.HCNetSDKUtil.java* @Description： 海康 SDK**/
@Slf4j
public class HCNetSDKUtil {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 = new byte[HCNetSDK.NET_DVR_DEV_ADDRESS_MAX_LEN];byte[] ipBytes = ip.getBytes();System.arraycopy(ipBytes, 0, deviceAddress, 0, Math.min(ipBytes.length, deviceAddress.length));loginInfo.sDeviceAddress = deviceAddress;// 设置用户名和密码byte[] userName = new byte[HCNetSDK.NET_DVR_LOGIN_USERNAME_MAX_LEN];byte[] password = psw.getBytes();System.arraycopy(user.getBytes(), 0, userName, 0, Math.min(user.length(), userName.length));System.arraycopy(password, 0, loginInfo.sPassword, 0, Math.min(password.length, loginInfo.sPassword.length));loginInfo.sUserName = userName;// 设置端口和登录模式loginInfo.wPort = port.shortValue();loginInfo.bUseAsynLogin = false; // 同步登录loginInfo.byLoginMode = 0; // 使用SDK私有协议// 执行登录操作int userID = hCNetSDK.NET_DVR_Login_V40(loginInfo, deviceInfo);if (userID == -1) {log.error("登录失败，错误码为: {}", hCNetSDK.NET_DVR_GetLastError());} else {log.info("{} 设备登录成功！", ip);// read()后，结构体中才有对应的数据deviceInfo.read();// 处理通道号逻辑int startDChan = deviceInfo.struDeviceV30.byStartDChan;log.info("预览起始通道号: {}", startDChan);}// 返回登录结果return userID;}/*** @MonthName： logout* @Description： 退出登录* @Param： [lUserID]* @return： void**/public static void logout(Integer lUserID) {if (Objects.nonNull(hCNetSDK) && Objects.nonNull(lUserID)) {hCNetSDK.NET_DVR_Logout(lUserID);hCNetSDK.NET_DVR_Cleanup();}}/*** @MonthName： setPTZPresetOther* @Description： 设置球机预置点(不用启动图象预览)* @Param： * lChannel：通道号* dwPTZPresetCmd：8、设置预置点，9、清除预置点，39、转到预置点* dwPresetIndex：预置点的序号（从1开始），最多支持300个预置点* @return： void**/public static void setPTZPresetOther(String ip, Integer port, String username, String password, Integer lChannel, Integer dwPTZPresetCmd, Integer dwPresetIndex) {Integer lUserID = null;try {init();lUserID = login(ip, port, username, password);// 设置球机预置点if (lUserID != -1) {log.info("设置预置点开始：lUserID：{}，lChannel：{}，dwPTZPresetCmd：{}，dwPresetIndex：{}", lUserID, lChannel, dwPTZPresetCmd, dwPresetIndex);boolean status = hCNetSDK.NET_DVR_PTZPreset_Other(lUserID, lChannel, dwPTZPresetCmd, dwPresetIndex);if (status) {log.info("设置预置点成功");} else {log.error("设置预置点失败，错误码：{}", hCNetSDK.NET_DVR_GetLastError());}}} catch (Exception e) {log.error("设置预置点异常：{}", e);} finally {logout(lUserID);}}/*** @MonthName： setPTZControlOther* @Description： 云台控制操作(不用启动图象预览)* @Param： * lChannel：通道号* dwPTZCommand：云台控制命令【21、上仰，22、下俯，23、左转，24、右转】* dwStop：云台停止动作或开始动作：0－开始，1－停止* dwSpeed：云台控制的速度，用户按不同解码器的速度控制值设置。取值范围[1,7]* @return： void**/public static void setPTZControlOther(String ip, Integer port, String username, String password, Integer lChannel, Integer dwPTZCommand, Integer dwStop, Integer dwSpeed) {Integer lUserID = null;try {init();lUserID = login(ip, port, username, password);if (lUserID != -1) {log.info("云台控制操作：lUserID：{}，lChannel：{}，dwPTZPresetCmd：{}，dwPresetIndex：{}，dwSpeed：{}", lUserID, lChannel, dwPTZCommand, dwStop, dwSpeed);boolean status = false;if (Objects.isNull(dwSpeed)) {status = hCNetSDK.NET_DVR_PTZControl_Other(lUserID, lChannel, dwPTZCommand, dwStop);} else {// 带速度status = hCNetSDK.NET_DVR_PTZControlWithSpeed_Other(lUserID, lChannel, dwPTZCommand, dwStop, dwSpeed);}if (status) {log.info("云台控制操作成功");} else {log.error("云台控制操作失败，错误码：{}", hCNetSDK.NET_DVR_GetLastError());}}} catch (Exception e) {log.error("云台控制操异常：{}", e);} finally {logout(lUserID);}}}

测试运行

测试

 public static void main(String[] args) {
//        setPTZPresetOther("192.168.1.64", 8000, "admin", "LZAP3508", 1, 39, 2);setPTZControlOther("192.168.1.64", 8000, "admin", "123456", 1, 22, 0, 3);
}

日志

16:18:01.987 [main] INFO com.demo.util.HCNetSDKUtil - SDK初始化: true
16:18:02.003 [main] INFO com.demo.util.HCNetSDKUtil - 设置异常消息回调成功
16:18:02.391 [main] INFO com.demo.util.HCNetSDKUtil - 192.168.1.64 设备登录成功！
16:18:02.391 [main] INFO com.demo.util.HCNetSDKUtil - 预览起始通道号: 0
16:18:02.391 [main] INFO com.demo.util.HCNetSDKUtil - 云台控制操作：lUserID：0，lChannel：1，dwPTZPresetCmd：22，dwPresetIndex：0，dwSpeed：3
16:18:02.420 [main] INFO com.demo.util.HCNetSDKUtil - 云台控制操作成功

在这里插入图片描述

这篇关于Java 接入海康 SDK 云台控制的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1137089。

相关文章

Java实现字节字符转bcd编码

Java实现字节字符转bcd编码

《Java实现字节字符转bcd编码》BCD是一种将十进制数字编码为二进制的表示方式,常用于数字显示和存储,本文将介绍如何在Java中实现字节字符转BCD码的过程,需要的小伙伴可以了解下... 目录前言BCD码是什么Java实现字节转bcd编码方法补充总结前言BCD码（Binary-Coded Decima
阅读更多...
SpringBoot全局域名替换的实现

SpringBoot全局域名替换的实现

《SpringBoot全局域名替换的实现》本文主要介绍了SpringBoot全局域名替换的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一... 目录 项目结构⚙️ 配置文件application.yml️ 配置类AppProperties.Ja
阅读更多...
Java使用Javassist动态生成HelloWorld类

Java使用Javassist动态生成HelloWorld类

《Java使用Javassist动态生成HelloWorld类》Javassist是一个非常强大的字节码操作和定义库,它允许开发者在运行时创建新的类或者修改现有的类,本文将简单介绍如何使用Javass... 目录1. Javassist简介2. 环境准备3. 动态生成HelloWorld类3.1 创建CtC
阅读更多...
JavaScript中的高级调试方法全攻略指南

JavaScript中的高级调试方法全攻略指南

《JavaScript中的高级调试方法全攻略指南》什么是高级JavaScript调试技巧,它比console.log有何优势,如何使用断点调试定位问题,通过本文,我们将深入解答这些问题,带您从理论到实... 目录观点与案例结合观点1观点2观点3观点4观点5高级调试技巧详解实战案例断点调试：定位变量错误性能分
阅读更多...
Java实现将HTML文件与字符串转换为图片

Java实现将HTML文件与字符串转换为图片

《Java实现将HTML文件与字符串转换为图片》在Java开发中,我们经常会遇到将HTML内容转换为图片的需求,本文小编就来和大家详细讲讲如何使用FreeSpire.DocforJava库来实现这一功... 目录前言核心实现：html 转图片完整代码场景 1：转换本地 HTML 文件为图片场景 2：转换 H
阅读更多...
Java使用jar命令配置服务器端口的完整指南

Java使用jar命令配置服务器端口的完整指南

《Java使用jar命令配置服务器端口的完整指南》本文将详细介绍如何使用java-jar命令启动应用,并重点讲解如何配置服务器端口,同时提供一个实用的Web工具来简化这一过程,希望对大家有所帮助... 目录1. Java Jar文件简介1.1 什么是Jar文件1.2 创建可执行Jar文件2. 使用java
阅读更多...
SpringBoot实现不同接口指定上传文件大小的具体步骤

SpringBoot实现不同接口指定上传文件大小的具体步骤

《SpringBoot实现不同接口指定上传文件大小的具体步骤》：本文主要介绍在SpringBoot中通过自定义注解、AOP拦截和配置文件实现不同接口上传文件大小限制的方法,强调需设置全局阈值远大于... 目录一  springboot实现不同接口指定文件大小1.1 思路说明1.2 工程启动说明二 具体实施2
阅读更多...
Java实现在Word文档中添加文本水印和图片水印的操作指南

Java实现在Word文档中添加文本水印和图片水印的操作指南

《Java实现在Word文档中添加文本水印和图片水印的操作指南》在当今数字时代,文档的自动化处理与安全防护变得尤为重要,无论是为了保护版权、推广品牌,还是为了在文档中加入特定的标识,为Word文档添加... 目录引言Spire.Doc for Java：高效Word文档处理的利器代码实战：使用Java为Wo
阅读更多...
SpringBoot日志级别与日志分组详解

SpringBoot日志级别与日志分组详解

《SpringBoot日志级别与日志分组详解》文章介绍了日志级别（ALL至OFF）及其作用,说明SpringBoot默认日志级别为INFO,可通过application.properties调整全局或... 目录日志级别1、级别内容2、调整日志级别调整默认日志级别调整指定类的日志级别项目开发过程中，利用日志
阅读更多...
Java中的抽象类与abstract 关键字使用详解

Java中的抽象类与abstract 关键字使用详解

《Java中的抽象类与abstract关键字使用详解》：本文主要介绍Java中的抽象类与abstract关键字使用详解,本文通过实例代码给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧... 目录一、抽象类的概念二、使用 abstract2.1 修饰类 => 抽象类2.2 修饰方法 => 抽象方法，没有
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2