JAVA Spring Boot与海康威视摄像头的故事

桃扇骨 2024-03-24 14:54 43阅读 0赞

#### 《菜鸟学JAVA第一篇》 ####

*  前言：JAVA Spring Boot与海康威视摄像头的故事
 *   *  关于本贴
     *  干货部分
     *   *  进入官网，选择sdk下载：
         *  下载所需要的开发包（以下教程以windows为例）:
         *  下载完SDK解压并打开
         *  运行Demo
         *  注意这边启动后，可能会出现因为jar包未引入的错误。
         *  项目创建
         *  引入SDK
         *  关于jar包以及SDK文件。
         *  引入HCNetSDK接口文件
         *  正式开始
         *   *  实现原理
             *  初始化sdk
             *  设置报警回调
             *  用户(设备)注册
             *  注销注册
             *  注销sdk使用
         *  后续完善
         *  注意事项

## 前言：JAVA Spring Boot与海康威视摄像头的故事 ##

这两天因工作原因，需要对海康威视摄像头进行二次开发。说实话，刚打开开发手册的那一刻，很劝退。由于之前接触硬件开发不多，对于其中的嵌入式设备SDK、DLL动态组件库的内容不甚了解。挠破了头皮，冲！

### 关于本贴 ###

刚开始的时候，真的是一步一个坑，虽说网上有相关教程以及官方的DEMO和文档。但是对于我这样的新手来说这些还是需要踩很多的坑。所以我决定使用博客文章的形式，来记录一下自己的学习过程以及遇到的问题，万一除了自己还有其他人需要，避免重复踩坑。话不多说，内容开始：

### 干货部分 ###

首先我这边需要做的任务内容是基于海康sdk在java Spring boot 的集成开发，暂不需要开发前台展示，所需要的也只是抓拍(车辆与人员信息等)这一部分。那么我这边就参考官方文档以及对应demo，展开描述。

官方文档以及SDK下载地址：[海康威视官方SDK下载地址][SDK]

#### 进入官网，选择sdk下载： ####

![在这里插入图片描述][ad4d3c92d90b48fc8d2b4c0fda05dddb.png]

#### 下载所需要的开发包（以下教程以windows为例）: ####

![在这里插入图片描述][ccdeea3a67ee41ecab08b2e564ad3c99.png]

#### 下载完SDK解压并打开 ####

![在这里插入图片描述][e20a7903d38e495bbcd2c87c13e2c85b.png]

> **打开后，红色区域的三个文件夹是重点内容。其中：Demo文件中存放官方Demo示例，对后续开发具有参考。开发文档中存放了各种接口的API，和各种编程指南。库文件中存放了下述步骤中所需要的dll动态库以及jar包。**

#### 运行Demo ####

打开Demo文件夹，找到对应的Java语言。通过他的提示导入所需要的dll文件。  
![在这里插入图片描述][cc38cde9ddb6450fba98ae9b6c8e1364.png]  
然后找到Demo文件的启动文件，运行并启动。  
![在这里插入图片描述][9d35d3b3bced4bc18746c937fa12f58f.png]

#### 注意这边启动后，可能会出现因为jar包未引入的错误。 ####

点击项目设置  
![在这里插入图片描述][d97014f894104311b7edb7dc2e0fa6d6.png]  
![在这里插入图片描述][293fb07b6d8843cab9ece53fecdd541c.png]  
选择要添加jar包的项目，然后点击右边的“+”按钮，找到Demo文件中lib中的jar包存放路径，选择后点击ok。  
![在这里插入图片描述][c62d8dff2ac848ad944e3242ebd98340.png]  
没看明白?没关系，看这里：[idea 引入jar包][idea _jar]

#### 项目创建 ####

1.  创建Spring boot 项目（基础操作，不多赘述）。

#### 引入SDK ####

1.  将上述步骤下载好的官方demo中的sdk文件夹放到自己的项目中（一般都放在lib文件夹中，这个理论上放哪里都行只要配置好路径能正确找到）。这里边放置的是需要的dll动态库文件，以及jna.jar、examples.jar等所需要的jar包文件。大概如图（动态库和jar包放一块就行）：
2.  pom文件中引入

<resources>
                
                <resource>
                    <directory>${project.basedir}/lib</directory>
                    <targetPath>BOOT-INF/lib/</targetPath>
                    <includes>
                        <include>**/*.jar</include>
                    </includes>
                </resource>
    
                
                <resource>
                    <directory>${project.basedir}/lib</directory>
                    <targetPath>../lib</targetPath>
                </resource>
    
                
                <resource>
                    <directory>${basedir}/src/main/resources</directory>
                </resource>
            </resources>

![在这里插入图片描述][c40014142b7d4a8fa6e229c5700110ae.png]

#### 关于jar包以及SDK文件。 ####

> **海康威视官方提供的设备网络SDK是封装的动态链接库（Windows的dll或者Linux的so），各种开发语言对接SDK，都是通过加载动态库链接，调用动态库中的接口实现功能模块对接。而Java与dll之间的引用并不友好，所以，需要利用上述中引入的jna.jar来辅助我们的代码操作。**
> 
> --------------------
> 
> **通过JNA的方式调用动态链接库中的接口，JNA(Java Native Access)框架是SUN公司主导开发的开源java框架，是建立在JNI的基础上的一个框架，JNA框架提供了一组java工具类用于在运行期间动态访问动态链接库（native library：如Window的dll、Linux的so），实现在java语言中调用C/C++语言封装的接口，java开发人员只需要在一个java接口中描述目标native library的函数与结构，JNA将自动实现Java接口到native function的映射，而不需要编写任何Native/JNI代码，大大降低了Java调用动态链接库的开发难度。相比于JNI的方式，JNA大大简化了调用本地方法的过程，使用很方便，基本上不需要脱离Java环境就可以完成。JNA调用C/C++的过程大致如下：**  
> ![在这里插入图片描述][ee9327bfe3fe46889d1948cf8c8b53da.jpeg]

#### 引入HCNetSDK接口文件 ####

1.  HCNetSDK接口文件是海康摄像头的接口文件，里边存放了各种api。  
    ![在这里插入图片描述][4318839beac44f1489332c7c35242376.png]

#### 正式开始 ####

ok，到了这一步，恭喜你，基础环境配置你已经搞定，接下来就看着接口文档来做自己需要的功能吧。  
![在这里插入图片描述][f7fcd39ff1de4307b5394362708e132c.png]

##### 实现原理 #####

1.  ##### 初始化sdk #####

![在这里插入图片描述][0198150866b04e5385891f708da5b068.png]

1.  ##### 设置报警回调 #####

![在这里插入图片描述][8ffbbd2478204e6095188e937b317ff1.png]

1.  ##### 用户(设备)注册 #####

![在这里插入图片描述][d981e52661d64f20b3bd49873f300d20.png]

1.  ##### 注销注册 #####
2.  ##### 注销sdk使用 #####

![在这里插入图片描述][7db37ca0e8fc4eb585bce1fc1c65f2ea.png]

> **具体代码实现最好是自己动手，内容参考接口文档以及Demo即可。**

下图以交通产品功能示例，其他功能差别不大  
![在这里插入图片描述][e11c9a981ad6467380e619a18017b26b.png]  
![在这里插入图片描述][663131e66f7547268782f6513cfc0c1b.png]

#### 后续完善 ####

后续我会继续发布学习的新内容，欢迎大家讨论交流，共同进步。  
很高兴可以帮助到有需要的人。

#### 注意事项 ####

> **注意：SDK所有回调都是子线程，JNA是弱引用，建议回调函数对象写成全局静态，防止被系统回收**  
> **这个一定要注意，我就是踩了这个坑出现各种各样的问题无从排查。后经公司大佬指点迷津。**

[SDK]: https://open.hikvision.com/download/5cda567cf47ae80dd41a54b3?type=10
[ad4d3c92d90b48fc8d2b4c0fda05dddb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/be516c11cba84474825067059be99bff.png
[ccdeea3a67ee41ecab08b2e564ad3c99.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/2a9897405490470ba23770a35a6c68dd.png
[e20a7903d38e495bbcd2c87c13e2c85b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/a2727530269649b199f4ca7c0424d2e7.png
[cc38cde9ddb6450fba98ae9b6c8e1364.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/525d24a3aee1479a87c20e6d39b9e01d.png
[9d35d3b3bced4bc18746c937fa12f58f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/2525affc9ca543e9a154373e3d9f69e2.png
[d97014f894104311b7edb7dc2e0fa6d6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/303efacf0c4b4952952c5c65db8f8831.png
[293fb07b6d8843cab9ece53fecdd541c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/d6f2152b40e847e3b6b40fb5d1b889b1.png
[c62d8dff2ac848ad944e3242ebd98340.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/f634a932a02f4db5888110998958dac8.png
[idea _jar]: https://blog.csdn.net/qq_52131239/article/details/124726344
[c40014142b7d4a8fa6e229c5700110ae.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/e1805267f9ae44eab1c0153de56ae4dc.png
[ee9327bfe3fe46889d1948cf8c8b53da.jpeg]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/f25595e8cca445718e186ff050593aeb.png
[4318839beac44f1489332c7c35242376.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/a54a992a4014462caffb30ce4f1d3f2c.png
[f7fcd39ff1de4307b5394362708e132c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/4132be5103324daca23f1947e89498b3.png
[0198150866b04e5385891f708da5b068.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/83dc7157dcdf4aeb8771ad7de286d818.png
[8ffbbd2478204e6095188e937b317ff1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/0c18839e872641f4bc4e6dc5c5188209.png
[d981e52661d64f20b3bd49873f300d20.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/58fbaf4685874efd95635b417c1686c7.png
[7db37ca0e8fc4eb585bce1fc1c65f2ea.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/97461269327349aa99737f1e1884e209.png
[e11c9a981ad6467380e619a18017b26b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/57182f912f0f4deda10cffc647f76304.png
[663131e66f7547268782f6513cfc0c1b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/24/574630e066f74aad937f8341eea6c66b.png