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实现检查多个时间段是否有重合

Java实现检查多个时间段是否有重合

《Java实现检查多个时间段是否有重合》这篇文章主要为大家详细介绍了如何使用Java实现检查多个时间段是否有重合,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录流程概述步骤详解China编程步骤1：定义时间段类步骤2：添加时间段步骤3：检查时间段是否有重合步骤4：输出结果示例代码结语作
阅读更多...
Java中String字符串使用避坑指南

Java中String字符串使用避坑指南

《Java中String字符串使用避坑指南》Java中的String字符串是我们日常编程中用得最多的类之一,看似简单的String使用,却隐藏着不少“坑”,如果不注意,可能会导致性能问题、意外的错误容... 目录8个避坑点如下：1. 字符串的不可变性：每次修改都创建新对象2. 使用 == 比较字符串，陷阱满
阅读更多...
Java判断多个时间段是否重合的方法小结

Java判断多个时间段是否重合的方法小结

《Java判断多个时间段是否重合的方法小结》这篇文章主要为大家详细介绍了Java中判断多个时间段是否重合的方法,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录判断多个时间段是否有间隔判断时间段集合是否与某时间段重合判断多个时间段是否有间隔实体类内容public class D
阅读更多...
IDEA编译报错“java: 常量字符串过长”的原因及解决方法

IDEA编译报错“java: 常量字符串过长”的原因及解决方法

《IDEA编译报错“java:常量字符串过长”的原因及解决方法》今天在开发过程中,由于尝试将一个文件的Base64字符串设置为常量,结果导致IDEA编译的时候出现了如下报错java:常量字符串过长,... 目录一、问题描述二、问题原因2.1 理论角度2.2 源码角度三、解决方案解决方案①：StringBui
阅读更多...
Java覆盖第三方jar包中的某一个类的实现方法

Java覆盖第三方jar包中的某一个类的实现方法

《Java覆盖第三方jar包中的某一个类的实现方法》在我们日常的开发中,经常需要使用第三方的jar包,有时候我们会发现第三方的jar包中的某一个类有问题,或者我们需要定制化修改其中的逻辑,那么应该如何... 目录一、需求描述二、示例描述三、操作步骤四、验证结果五、实现原理一、需求描述需求描述如下：需要在
阅读更多...
Java中ArrayList和LinkedList有什么区别举例详解

Java中ArrayList和LinkedList有什么区别举例详解

《Java中ArrayList和LinkedList有什么区别举例详解》：本文主要介绍Java中ArrayList和LinkedList区别的相关资料,包括数据结构特性、核心操作性能、内存与GC影... 目录一、底层数据结构二、核心操作性能对比三、内存与 GC 影响四、扩容机制五、线程安全与并发方案六、工程
阅读更多...
JavaScript中的reduce方法执行过程、使用场景及进阶用法

JavaScript中的reduce方法执行过程、使用场景及进阶用法

《JavaScript中的reduce方法执行过程、使用场景及进阶用法》：本文主要介绍JavaScript中的reduce方法执行过程、使用场景及进阶用法的相关资料,reduce是JavaScri... 目录1. 什么是reduce2. reduce语法2.1 语法2.2 参数说明3. reduce执行过程
阅读更多...
如何使用Java实现请求deepseek

如何使用Java实现请求deepseek

《如何使用Java实现请求deepseek》这篇文章主要为大家详细介绍了如何使用Java实现请求deepseek功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1.deepseek的api创建2.Java实现请求deepseek2.1 pom文件2.2 json转化文件2.2
阅读更多...
Java调用DeepSeek API的最佳实践及详细代码示例

Java调用DeepSeek API的最佳实践及详细代码示例

《Java调用DeepSeekAPI的最佳实践及详细代码示例》：本文主要介绍如何使用Java调用DeepSeekAPI,包括获取API密钥、添加HTTP客户端依赖、创建HTTP请求、处理响应、... 目录1. 获取API密钥2. 添加HTTP客户端依赖3. 创建HTTP请求4. 处理响应5. 错误处理6.
阅读更多...
Spring AI集成DeepSeek的详细步骤

Spring AI集成DeepSeek的详细步骤

《SpringAI集成DeepSeek的详细步骤》DeepSeek作为一款卓越的国产AI模型,越来越多的公司考虑在自己的应用中集成,对于Java应用来说,我们可以借助SpringAI集成DeepSe... 目录DeepSeek 介绍Spring AI 是什么？1、环境准备2、构建项目2.1、pom依赖2.2
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2