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。

相关文章

SpringBoot中六种批量更新Mysql的方式效率对比分析

SpringBoot中六种批量更新Mysql的方式效率对比分析

《SpringBoot中六种批量更新Mysql的方式效率对比分析》文章比较了MySQL大数据量批量更新的多种方法,指出REPLACEINTO和ONDUPLICATEKEY效率最高但存在数据风险,MyB... 目录效率比较测试结构数据库初始化测试数据批量修改方案第一种 for第二种 case when第三种
阅读更多...
Java docx4j高效处理Word文档的实战指南

Java docx4j高效处理Word文档的实战指南

《Javadocx4j高效处理Word文档的实战指南》对于需要在Java应用程序中生成、修改或处理Word文档的开发者来说,docx4j是一个强大而专业的选择,下面我们就来看看docx4j的具体使用... 目录引言一、环境准备与基础配置1.1 Maven依赖配置1.2 初始化测试类二、增强版文档操作示例2.
阅读更多...
一文详解如何使用Java获取PDF页面信息

一文详解如何使用Java获取PDF页面信息

《一文详解如何使用Java获取PDF页面信息》了解PDF页面属性是我们在处理文档、内容提取、打印设置或页面重组等任务时不可或缺的一环,下面我们就来看看如何使用Java语言获取这些信息吧... 目录引言一、安装和引入PDF处理库引入依赖二、获取 PDF 页数三、获取页面尺寸（宽高）四、获取页面旋转角度五、判断
阅读更多...
Spring Boot中的路径变量示例详解

Spring Boot中的路径变量示例详解

《SpringBoot中的路径变量示例详解》SpringBoot中PathVariable通过@PathVariable注解实现URL参数与方法参数绑定,支持多参数接收、类型转换、可选参数、默认值及... 目录一. 基本用法与参数映射1.路径定义2.参数绑定&nhttp://www.chinasem.cnbs
阅读更多...
JAVA中安装多个JDK的方法

JAVA中安装多个JDK的方法

《JAVA中安装多个JDK的方法》文章介绍了在Windows系统上安装多个JDK版本的方法,包括下载、安装路径修改、环境变量配置（JAVA_HOME和Path）,并说明如何通过调整JAVA_HOME在... 首先去oracle官网下载好两个版本不同的jdk（需要登录Oracle账号，没有可以免费注册）下载完
阅读更多...
Spring StateMachine实现状态机使用示例详解

Spring StateMachine实现状态机使用示例详解

《SpringStateMachine实现状态机使用示例详解》本文介绍SpringStateMachine实现状态机的步骤,包括依赖导入、枚举定义、状态转移规则配置、上下文管理及服务调用示例,重点解... 目录什么是状态机使用示例什么是状态机状态机是计算机科学中的​​核心建模工具​​，用于描述对象在其生命
阅读更多...
Spring Boot 结合 WxJava 实现文章上传微信公众号草稿箱与群发

Spring Boot 结合 WxJava 实现文章上传微信公众号草稿箱与群发

《SpringBoot结合WxJava实现文章上传微信公众号草稿箱与群发》本文将详细介绍如何使用SpringBoot框架结合WxJava开发工具包,实现文章上传到微信公众号草稿箱以及群发功能,... 目录一、项目环境准备1.1 开发环境1.2 微信公众号准备二、Spring Boot 项目搭建2.1 创建
阅读更多...
Java中Integer128陷阱

Java中Integer128陷阱

《Java中Integer128陷阱》本文主要介绍了Java中Integer与int的区别及装箱拆箱机制,重点指出-128至127范围内的Integer值会复用缓存对象,导致==比较结果为true,下... 目录一、Integer和int的联系1.1 Integer和int的区别1.2 Integer和in
阅读更多...
SpringSecurity整合redission序列化问题小结(最新整理)

SpringSecurity整合redission序列化问题小结(最新整理)

《SpringSecurity整合redission序列化问题小结(最新整理)》文章详解SpringSecurity整合Redisson时的序列化问题,指出需排除官方Jackson依赖,通过自定义反序... 目录1. 前言2. Redission配置2.1 RedissonProperties2.2 Red
阅读更多...
IntelliJ IDEA2025创建SpringBoot项目的实现步骤

IntelliJ IDEA2025创建SpringBoot项目的实现步骤

《IntelliJIDEA2025创建SpringBoot项目的实现步骤》本文主要介绍了IntelliJIDEA2025创建SpringBoot项目的实现步骤,文中通过示例代码介绍的非常详细,对大家... 目录一、创建 Spring Boot 项目1. 新建项目2. 基础配置3. 选择依赖4. 生成项目5.
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2