Java 接入海康 SDK 云台控制

2024-09-04 21:36

本文主要是介绍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.dllHCCore.dllHCNetSDKCom文件夹libssl-1_1.dlllibcrypto-1_1.dllhlog.dllhpr.dllzlib1.dllPlayCtrl.dllSuperRender.dllAudioRender.dll 等文件均要加载到程序里面,HCNetSDKCom文件夹(包含里面的功能组件dll库文件) 需要和 HCNetSDK.dllHCCore.dll 一起加载,放在同一个目录下,且 HCNetSDKCom 文件夹名不能修改。

同时将 jna.jarexamples.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脚本使用不同版本jdk的说明介绍

《java脚本使用不同版本jdk的说明介绍》本文介绍了在Java中执行JavaScript脚本的几种方式,包括使用ScriptEngine、Nashorn和GraalVM,ScriptEngine适用... 目录Java脚本使用不同版本jdk的说明1.使用ScriptEngine执行javascript2.

Spring MVC如何设置响应

《SpringMVC如何设置响应》本文介绍了如何在Spring框架中设置响应,并通过不同的注解返回静态页面、HTML片段和JSON数据,此外,还讲解了如何设置响应的状态码和Header... 目录1. 返回静态页面1.1 Spring 默认扫描路径1.2 @RestController2. 返回 html2

Spring常见错误之Web嵌套对象校验失效解决办法

《Spring常见错误之Web嵌套对象校验失效解决办法》:本文主要介绍Spring常见错误之Web嵌套对象校验失效解决的相关资料,通过在Phone对象上添加@Valid注解,问题得以解决,需要的朋... 目录问题复现案例解析问题修正总结  问题复现当开发一个学籍管理系统时,我们会提供了一个 API 接口去

Java操作ElasticSearch的实例详解

《Java操作ElasticSearch的实例详解》Elasticsearch是一个分布式的搜索和分析引擎,广泛用于全文搜索、日志分析等场景,本文将介绍如何在Java应用中使用Elastics... 目录简介环境准备1. 安装 Elasticsearch2. 添加依赖连接 Elasticsearch1. 创

Spring核心思想之浅谈IoC容器与依赖倒置(DI)

《Spring核心思想之浅谈IoC容器与依赖倒置(DI)》文章介绍了Spring的IoC和DI机制,以及MyBatis的动态代理,通过注解和反射,Spring能够自动管理对象的创建和依赖注入,而MyB... 目录一、控制反转 IoC二、依赖倒置 DI1. 详细概念2. Spring 中 DI 的实现原理三、

SpringBoot 整合 Grizzly的过程

《SpringBoot整合Grizzly的过程》Grizzly是一个高性能的、异步的、非阻塞的HTTP服务器框架,它可以与SpringBoot一起提供比传统的Tomcat或Jet... 目录为什么选择 Grizzly?Spring Boot + Grizzly 整合的优势添加依赖自定义 Grizzly 作为

Java后端接口中提取请求头中的Cookie和Token的方法

《Java后端接口中提取请求头中的Cookie和Token的方法》在现代Web开发中,HTTP请求头(Header)是客户端与服务器之间传递信息的重要方式之一,本文将详细介绍如何在Java后端(以Sp... 目录引言1. 背景1.1 什么是 HTTP 请求头?1.2 为什么需要提取请求头?2. 使用 Spr

Java如何通过反射机制获取数据类对象的属性及方法

《Java如何通过反射机制获取数据类对象的属性及方法》文章介绍了如何使用Java反射机制获取类对象的所有属性及其对应的get、set方法,以及如何通过反射机制实现类对象的实例化,感兴趣的朋友跟随小编一... 目录一、通过反射机制获取类对象的所有属性以及相应的get、set方法1.遍历类对象的所有属性2.获取

Java中的Opencv简介与开发环境部署方法

《Java中的Opencv简介与开发环境部署方法》OpenCV是一个开源的计算机视觉和图像处理库,提供了丰富的图像处理算法和工具,它支持多种图像处理和计算机视觉算法,可以用于物体识别与跟踪、图像分割与... 目录1.Opencv简介Opencv的应用2.Java使用OpenCV进行图像操作opencv安装j

java Stream操作转换方法

《javaStream操作转换方法》文章总结了Java8中流(Stream)API的多种常用方法,包括创建流、过滤、遍历、分组、排序、去重、查找、匹配、转换、归约、打印日志、最大最小值、统计、连接、... 目录流创建1、list 转 map2、filter()过滤3、foreach遍历4、groupingB