前言

因為網上關于海康威視SDK這塊的開發資源比較少，自己也是一步一步摸索過來，知道那種痛苦，
所以把自己的一些過來人的經驗寫出來供大家學習參考

1.對接海康威視的SDK

進入海康威視官網

下載你所需要的SDK開發包（這里我就用windows來作為案列）

下載完SDK解壓

里面有開發文檔和SDK的動態庫文件，有各種開發語言的Demo案列。（可以參考一下他的接口調用）

注：這里需要注意的是開發文檔，很重要！里面有一份文檔接口的API，和各種編程指南

運行Demo示例

這里我使用的語言是Java，通過他的提示導入所需要的dll文件

這里可以參考一下我導入的文件

注：這兩個jar包需要編譯

注：導入成功之后如果能正確運行Demo并且能夠通過海康威視的攝像頭進行預覽的話說明導入的文件是正確的

開發接口之前的環境配置

現在就可以進行自己的開發節奏了。記住上面那兩個jar包，和lib文件夾里面的那些文件。

1. 創建一個springboot項目

2. 把lib包放到springboot項目中的resources文件中

3. 編譯那兩個jar包（這里建議是使用mvn的命令把jar包打入到自己的maven倉庫會比較好一點）

   mvm install:install-file 
       -Dfile=你jar包的路徑\examples.jar 
       -DgroupId=com.xx.xx 
       -DartifactId=examples
       -Dversion=1.0-SNAPSHOT 
       -Dpackaging=jar
   

   不導入的話也可以直接編譯到項目中去，或者使用maven的路徑引用

   <dependency>
       <groupId>examples</groupId>
       <artifactId>examples</artifactId>
       <version>1.0</version>
       <scope>system</scope>
       <systemPath>${basedir}/src/main/resources/lib/examples.jar</systemPath>
   </dependency>
   <dependency>
        <groupId>jna</groupId>
        <artifactId>jna</artifactId>
        <version>1.0</version>
        <scope>system</scope>
        <systemPath>${basedir}/src/main/resources/lib/jna.jar</systemPath>
   </dependency>
   

4. 加載SDK庫

   注：這個接口就是后面開發用到的海康威視的SDK

   

   在這里添加這句代碼

   HCNetSDK INSTANCE = (HCNetSDK) Native.loadLibrary(CommonKit.getWebPath() + "HCNetSDK.dll", HCNetSDK.class);
   

   這里我才用的是用動態獲取路徑的方式來加載的。

   注：這里的路徑很重要，如果不行的話可以配置為絕對路徑

   public class CommonKit {
   	/**
   	 * 獲取項目webapp目錄
   	 * @return String
   	 */
   	public static String getWebPath() {
   		return CommonKit.class.getClassLoader().getResource("").getPath().substring(1) + "lib/
   	}
   }
   

開始基于海康威視SDK的開發

注：這里面的SDK其實是一個大雜燴，里面有很多接口其中有攝像頭的預覽，視頻的下載和語言的播報等接口

1. 編寫工具類

   通過讀取海康威視的開發文檔我們得知調用海康威視的SDK接口的時候需要初始化，完成操作之后需要釋放資源。

   在實際開發中項目一般是一直運行的，所以這里我用了spring的兩個注解，在項目啟動時候初始化，結束項目運行

   的時候釋放資源。這樣就不用每一次操作都去初始化和釋放資源了。

   注：這兩個方法是必須的，所有的接口執行都需要初始化

   這里只是初始化和釋放資源的代碼，其他的方法按照自己的業務邏輯來進行完善。

   @Slf4j
   @Component
   public class HikvisionUtil {	
   	private static final HCNetSDK hcNetSDK = HCNetSDK.INSTANCE;
   
   	/**
        * 初始化
        */
       @PostConstruct
       public void init() {
           boolean flag = hcNetSDK.NET_DVR_Init();
           String message = flag ? "成功" : "失敗";
           log.info("攝像頭初始化" + message);
       }
   
       /**
        * 釋放資源
        */
       @PreDestroy
       public void leanup() {
           boolean flag = hcNetSDK.NET_DVR_Cleanup();
           String message = flag ? "成功" : "失敗";
           log.info("攝像頭關閉資源" + message);
       }
   }
   

2. 如何排錯？

   新手在開發的時候可能會發生很多錯誤，這里我的建議是通過打印報錯編碼和日志來進行排查錯誤

   這個接口能夠返回你上一次失敗操作的錯誤碼

   hcNetSDK.NET_DVR_GetLastError()
   

   得到錯誤碼，拿到報錯的海康SDK接口去他的文檔進行查閱

   這里我用登錄接口來舉一個例子

通過錯誤碼就能夠正確的找到錯誤的原因。

2.總結海康威視的開發

第一次對接SDK的常見問題

1. 怎么完善海康威視的后續開發？

   一般的情況都是基于攝像頭進行開發，在對攝像頭進行開發的話建議查看此文檔，里面有接口調用順序和參數說明，基于文檔完善上面的工具類。

2. 如何部署到Linux服務器上面？

   首先HCNetSDK接口類需要繼承Library，經過本人的嘗試最新版本的SDK，
   繼承Library可以同時支持windows和Linux兩種環境

如果需要部署到Linux服務器上面的話，需要下載Linux那一套SDK

下載SDK

注：Linux下面是so文件

3. 對接海康攝像頭出現 java.lang.Error: Structure.getFieldOrder()

   Exception in thread "threadPoolTaskExecutor-1" java.lang.Error: Structure.getFieldOrder() on class com.ruoyi.web.equipment.hk.HCNetSDK$NET_DVR_USER_LOGIN_INFO does not provide enough names [0] ([]) to match declared fields [15] ([bUseAsynLogin, byHttps, byLoginMode, byProxyType, byRes2, byUseTransport, byUseUTCTime, byVerifyMode, cbLoginResult, iProxyID, pUser, sDeviceAddress, sPassword, sUserName, wPort])

   注：這個問題是因為海康jna.jar比較老,結構體定義沒有getFiledOrder，可創建一個類繼承 Structure

   import com.sun.jna.Structure;
   import java.lang.reflect.Field;
   import java.lang.reflect.Modifier;
   import java.util.ArrayList;
   import java.util.List;
   
   
   public class HIKSDKStructure extends Structure {
       protected List<String> getFieldOrder(){
           List<String> fieldOrderList = new ArrayList<String>();
           for (Class<?> cls = getClass();
                !cls.equals(HIKSDKStructure.class);
                cls = cls.getSuperclass()) {
               Field[] fields = cls.getDeclaredFields();
               int modifiers;
               for (Field field : fields) {
                   modifiers = field.getModifiers();
                   if (Modifier.isStatic(modifiers) || !Modifier.isPublic(modifiers)) {
                       continue;
                   }
                   fieldOrderList.add(field.getName());
               }
           }
           return fieldOrderList;
       }
   }
   

   然后對 HCNetSDK 接口中的靜態類里面，所有繼承 Structure 替換為 HIKSDKStructure 即可

3.后續完善

攝像頭在前端的預覽

攝像頭的截圖功能

攝像頭的手動錄像功能

攝像頭的回放下載功能

---

目前就寫這么多吧，本文是一篇入門介紹文，因為網上關于這塊的資料很少，

所以真心幫助那些和我一樣一開始就接觸對接硬件開發的程序員了解大概開發的流程。

注：一定要多看文檔，海康威視文檔算比較詳細的那種了。

有后續有開發問題的話可以在下方留言，或者咨詢本人的163郵箱[email protected]。

最后：七夕節還在寫博客，寫文不易求大家給小弟個贊??