海康威视（HIKVISION） JAVA SDK Demo成功运行

  • 引子
  • 下载
  • 说明
  • 代码编译
  • 添加文件
  • 问题
  • 排查
  • 总结


引子

调海康的JAVA SDK花费时间较长，所以记录下，为其他小伙伴填填坑，提高一下效率。官方文档确实少，而且demo中的说明各种坑。

下载

注意：官方SDK区分32位和64位，如果用64位的SDK需要使用JDK64位的，不能使用32位JDK。32位的SDK同理，只能使用32位JDK的。

说明

官方的Demo的编译环境：Eclipse+Swing插件 或者 NetBeans IDE V8.2，使用的JDK为1.8。

我使用IDEA编译通过了，Eclipse和IDEA区别不大。我的编译环境：IDEA+JDK1.8（64位）+ Windows 10（64位）。编译环境全是在64位下进行的。

代码编译

导入项目时选择eclipse项目导入，如果不懂的同学可以搜索下 IDEA如何导入ecplise项目，项目导进来后根据demo中的 SDK库文件拷贝到该目录下.txt

【注意事项】
------------------------------------
1. 请到海康威视官网下载最新版本设备网络SDK：http://www.hikvision.com/Cn/download_more_401.html

2. 请修改程序代码，其中HCNetSDK.java文件自己指定loadlibrary加载库的路径，【库文件】里的HCNetSDK.dll、HCCore.dll、PlayCtrl.dll、SuperRender.dll、HCNetSDKCom文件夹等文件均拷贝到该路径下。 HCNetSDKCom文件夹（包含里面的功能组件dll库文件）需要和HCNetSDK.dll、HCCore.dll一起加载，放在同一个目录下，且HCNetSDKCom文件夹名不能修改。

3. 如果自行开发软件不能正常实现相应功能，而且程序没有指定加载的dll库路径，请在程序运行的情况下尝试删除HCNetSDK.dll。如果可以删除，说明程序可能调用到系统盘Windows->System32目录下的dll文件，建议删除或者更新该目录下的相关dll文件；如果不能删除，dll文件右键选择属性确认SDK库版本。

4. 如按上述步骤操作后还是不能实现相应功能，请根据NET_DVR_GetLastError返回的错误号判断原因。

添加文件

根据文件描述步骤拷入对应的文件和文件夹。第二条中少写了一个dll是 AudioRender.dll

完成后，我们的项目目录是这个样子

java海康威视获取预览 海康威视 java_海康威视 JAVA SDK


如果项目报错，将项目中的 jna.jar

项目不报错后，可以打开 ClientDemo.java

问题

Exception in thread "main" java.lang.UnsatisfiedLinkError: Unable to load library 'HCNetSDK: ÕҲ»µ½ָ¶

Exception in thread "main" java.lang.UnsatisfiedLinkError: Unable to load library 'PlayCtrl': ÕҲ»µ½ָ¶¨

遇到上述的两种错误时，不要惊慌，打开 HCNetSDK.java

更改

HCNetSDK INSTANCE = (HCNetSDK) Native.loadLibrary("HCNetSDK", HCNetSDK.class);

为

HCNetSDK INSTANCE = (HCNetSDK) Native.loadLibrary("你的项目绝对路径/HCNetSDK", HCNetSDK.class);  //你的项目绝对路径指 D:\Workspace\ClientDemo-NetBeansPro

更改

PlayCtrl INSTANCE = (PlayCtrl) Native.loadLibrary("PlayCtrl", PlayCtrl.class);

为

PlayCtrl INSTANCE = (PlayCtrl) Native.loadLibrary("你的项目绝对路径/PlayCtrl.dll", PlayCtrl.class);  //注意此处的PlayCtrl必须加dll后缀，要不然会报错

解决完错误后，再次打开 ClientDemo.java 中的main方法运行一下，终于出现了久违的画面。

java海康威视获取预览 海康威视 java_HIKVISION JAVA_02


终于成功运行起来了，我们兴致冲冲的点击注册，却提示 注册失败

lUserID = hCNetSDK.NET_DVR_Login_V30(m_sDeviceIP,
                (short) iPort, jTextFieldUserName.getText(), new String(jPasswordFieldPassword.getPassword()), m_strDeviceInfo);

中的lUserID返回-1，为啥会返回-1呢，不知道，完全不懂。

排查

SDK库文件拷贝到该目录下.txt 文件中的第4条描述使用NET_DVR_GetLastError错误号判断原因，好吧，我们加上输入打印。

lUserID = hCNetSDK.NET_DVR_Login_V30(m_sDeviceIP,
                (short) iPort, jTextFieldUserName.getText(), new String(jPasswordFieldPassword.getPassword()), m_strDeviceInfo);
System.out.println("注册失败错误码：" + hCNetSDK.NET_DVR_GetLastError());

打印出来发现返回41。这个41到底代表的哪个错误，好吧，去文档（设备网络SDK编程指南（DVR&NVR）.pdf）里面查一下，文档中描述说

错误名称

错误值

说明

NET_DVR_ALLOC_RESOURCE_ERROR

41

SDK 资源分配错误

SDK资源分配错误，是不是资源文件没有引用全啊。没办法，给技术支持发邮件吧。技术支持回复将所有的库文件全拷贝到项目路径下。果然是资源没有引用全的原因。

好吧，照搬，把所有文件拷贝进去后，点击注册，成功了！ - _ - - _ - - _ -但是，为什么要拷贝那么多啊，那么多文件放在项目下肯定不合适啊，肯定会有文件用不到啊。

总结

经过我的努力，发现只需要将

HCNetSDK.dll
HCCore.dll
HCNetSDKCom文件夹
PlayCtrl.dll
SuperRender.dll
AudioRender.dll
ssleay32.dll
libeay32.dll

文件和文件夹拷贝到项目目录下，官方的说明里面直接是少了三个dll文件。T_T T_T T_T

最后，如果拷贝以上文件还是报错的话，建议将所有的dll文件全拷贝到项目根目录下。

这就是我运行海康威视官方JAVA SDK DEMO的所有坑，记录一下，让大家少走弯路。