基于海康威视SDK开发的网络摄像头远程配置管理系统-支持FTP文件传输-定时抓图-计划任务配置-多设备批量操作-RESTful接...

## 海康设备 通过 SDK 查看修改网络摄像头配置 需要通过程序远程修改 海康网络摄像头配置，可以在指定的时间间隔的情况下抓图，通过 FTP 传到指定服务器，简单写一个服务，需要修改的配置项： + FTP 配置: `NET_DVR_SET_FTPCFG_V40`,`NET_DVR_GET_FTPCFG_V40` + 抓图配置: `NET_DVR_GET_JPEG_CAPTURE_CFG`,`NET_DVR_SET_JPEG_CAPTURE_CFG` + 抓图计划配置: `NET_DVR_GET_SCHED_CAPTURECFG`,`NET_DVR_SET_SCHED_CAPTURECFG` 项目目录 ```bash X:. ├─main │ ├─java │ │ └─com │ │ └─xtj │ │ └─hikvisionsdkintegration │ │ ├─config │ │ ├─controller │ │ ├─dto │ │ ├─sdklib │ │ ├─service │ │ ├─task │ │ └─util │ └─resources ``` 调用方式通过接口调用,支持 `Get,Post` 方式 get 方式 ```bash http://127.0.0.1:8099/config/state/192.168.1.143 http://127.0.0.1:8099/config/ftp?ips=192.168.1.143,192.168.1.141,192.168.1.142 http://127.0.0.1:8099/config/ftp/status?ips=192.168.1.143,192.168.1.141,192.168.1.142 ``` post 方式 ```bash curl --location --request POST 'http://127.0.0.1:8099/config/ftp' \ --header 'Content-Type: application/json' \ --data-raw ' [ "192.168.1.143", "192.168.1.141", "192.168.1.142" ]' ``` ```bash curl --location --request POST 'http://127.0.0.1:8099/config/ftp/status' \ --header 'Content-Type: application/json' \ --data-raw ' [ "192.168.1.143", "192.168.1.141", "192.168.1.142" ] ' ``` 提供了 swagger UI ,接口文档,可以直接调用  ### 配置说明 ```yaml server: port: 8099 logging: level: org: springframework.web: info # 摄像头配置 CAMERA: username: "admin" password: "hik12345" # ftp 配置 FTP: username: "face" password: "face" serverIP: "110.110.110.170" serverPort: 21 enableAnony: 0 custdir: "face" #抓图配置 snapshot: dwPicInterval: 4000 # 抓图时间间隔 4s ``` ### 部署 当前 SDK ， `window` 下需要把SDK 包和 当前项目 jar 包放到同一级目录, `Linux` 需放到 `/usr/lib/` 下面 ```bash java -jar hikvision-sdk-integration-0.0.1-SNAPSHOT.jar ``` ### Docker 方式 ```bash ┌──[[email protected]]-[~/ftpconfig] └─$ ls Dockerfile hikvision-sdk-integration-0.0.1-SNAPSHOT.jar sdk sdk.tar ┌──[[email protected]]-[~/ftpconfig] └─$ cat Dockerfile FROM openjdk:8u102-jdk COPY ./hikvision-sdk-integration-0.0.1-SNAPSHOT.jar / ADD ./sdk.tar /usr/lib/ # 设置容器启动时的命令 CMD ["java", "-jar" ,"hikvision-sdk-integration-0.0.1-SNAPSHOT.jar"] ┌──[[email protected]]-[~/ftpconfig] └─$ ``` ```bash docker pull liruilong/hikvision-sdk-config-ftp ``` ```bash ┌──[[email protected]]-[~/ftpconfig] └─$ docker run --rm -it -p 8099:8099 hikvision-sdk-config-ftp:latest . ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v2.5.3) 2023-10-12 17:20:41.184 INFO 1 --- [ main] c.x.h.HikvisionSdkIntegrationApplication : Starting HikvisionSdkIntegrationApplication v0.0.1-SNAPSHOT using Java 1.8.0_102 on bbb649e2e354 with PID 1 (/hikvision-sdk-integration-0.0.1-SNAPSHOT.jar started by root in /) 2023-10-12 17:20:41.186 INFO 1 --- [ main] c.x.h.HikvisionSdkIntegrationApplication : No active profile set, falling back to default profiles: default 2023-10-12 17:20:42.650 INFO 1 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8099 (http) 2023-10-12 17:20:42.669 INFO 1 --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat] 2023-10-12 17:20:42.669 INFO 1 --- [ main] org.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/9.0.50] 2023-10-12 17:20:42.764 INFO 1 --- [ main] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext ............. loop[2] find 2 mac and 0 ip 2023-10-12 17:20:44.151 INFO 1 --- [pool-1-thread-1] c.x.h.task.InitSdkTask : ============== InitSDK init success ==================== 2023-10-12 17:21:02.986 INFO 1 --- [nio-8099-exec-1] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring DispatcherServlet 'dispatcherServlet' 2023-10-12 17:21:02.986 INFO 1 --- [nio-8099-exec-1] o.s.web.servlet.DispatcherServlet : Initializing Servlet 'dispatcherServlet' 2023-10-12 17:21:02.988 INFO 1 --- [nio-8099-exec-1] o.s.web.servlet.DispatcherServlet : Completed initialization in 2 ms 2023-10-12 17:21:03.243 INFO 1 --- [nio-8099-exec-1] c.x.h.controller.ConfigController : userId=0 2023-10-12 17:21:03.286 INFO 1 --- [nio-8099-exec-1] c.x.h.controller.ConfigController : 获取参数成功 2023-10-12 17:21:03.287 INFO 1 --- [nio-8099-exec-1] c.x.h.controller.ConfigController : =========================== 设备信息 ============================ 2023-10-12 17:21:03.287 INFO 1 --- [nio-8099-exec-1] c.x.h.controller.ConfigController : 设备名称:IP CAMERA 设备序列号：DS-IPC-B12HV2-IA20210812AACHG51171281 2023-10-12 17:21:03.287 INFO 1 --- [nio-8099-exec-1] c.x.h.controller.ConfigController : 设备型号名称:DS-IPC-B12HV2-IA 设备 型号：31 2023-10-12 17:21:03.287 INFO 1 --- [nio-8099-exec-1] c.x.h.controller.ConfigController : 模拟通道个数：1 2023-10-12 17:21:03.289 INFO 1 --- [nio-8099-exec-1] c.x.h.controller.ConfigController : 软件版本号：[firstVersion:5, secondVersion:5, lowVersion:34] 2023-10-12 17:21:03.289 INFO 1 --- [nio-8099-exec-1] c.x.h.controller.ConfigController : 软件生成日期：Build:2021.7.14 ``` ### 海康 SDK 使用 开发手册，动态库下载： [https://open.hikvision.com/download/5cda567cf47ae80dd41a54b3?type=10&id=5cda5902f47ae80dd41a54b7](https://open.hikvision.com/download/5cda567cf47ae80dd41a54b3?type=10&id=5cda5902f47ae80dd41a54b7) + 确定需要调用的动态库功能 + 通过`开发手册`查看对应的宏定义,结构体 + 定义宏变量，结构体转化 + 编写需要的功能业务,可以参考官方的 Demo 以 FTP 配置为 Demo： 宏变量 ```java public static final int NET_DVR_GET_FTPCFG_V40 = 6162; //获取FTP信息 public static final int NET_DVR_SET_FTPCFG_V40 = 6163; //设置FTP信息 ``` 结构体转化 ```java public static class NET_DVR_STRUCTHEAD extends Structure { public short wLength; //结构长度 public byte byVersion ; /*高低4位分别代表高低版本，后续根据版本和长度进行扩展，不同的版本的长度进行限制*/ public byte byRes; } //图片命名扩展 2013-09-27 public static class NET_DVR_PICTURE_NAME_EX extends Structure { public byte[] byItemOrder = new byte[PICNAME_MAXITEM]; /* 桉数组定义文件命名的规则 */ public byte byDelimiter; /*分隔符，一般为'_'*/ public byte[] byPicNamePrefix = new byte[PICNAME_PREFIX/*32*/]; //图片名自定义前缀 } public static class STRUCT_SELF_DOMAIN extends Structure { public byte[] szDomain = new byte[64]; //服务器地址，可以使IPv4 IPv6或是域名 public byte[] byRes1 = new byte[80]; } public static class STRUCT_SELF_IP extends Structure { public NET_DVR_IPADDR struIp = new NET_DVR_IPADDR(); /*IP地址:IPv4 IPv6地址, 144字节*/ } public static class UNION_SELF_FTPSEVER extends Union { public STRUCT_SELF_DOMAIN struDomain = new