大華門禁SDK二次開發（一）
阿新 • • 發佈：2018-11-21
專案中需要能夠查詢門禁訊號和控制門禁裝置，因此需要基於大華門禁SDK進行二次開發,開發語言C#。門禁開發中遇到了一些問題，經過與大華技術的郵件溝通也一一解決。做這個開發的時候，發現網上的資料比較少，想著把自己遇到的問題整理下來，讓有需要的人儘量少走一些彎路。
1. 門禁狀態查詢/控制API
- 門禁控制API
BOOL CLIENT_ControlDevice( LLONG lLoginID , CtrlType type , void *param , int waittime = 1000 );
- 門禁查詢API
BOOL CLIENT_QueryDevState( LLONG lLoginID, int nType, char *pBuf, int nBufLen, int *pRetLen, int waittime=1000 ); nType `NET_DOOR_STATUS_INFO` //門禁狀態資訊 struct NET_DOOR_STATUS_INFO{ DWORD dwSize; int nChannel; EM_NET_DOOR_STATUS_TYPE emStateType; }; //門禁狀態型別 typedef enum __EM_NET_DOOR_STATUS_TYPE{ EM_NET_DOOR_STATUS_UNKNOWN， EM_NET_DOOR_STATUS_OPEN, // 開啟 EM_NET_DOOR_STATUS_CLOSE, // 關閉 EM_NET_DOOR_STATUS_BREAK, // 門異常開啟};
2. 郵件列表
2.1 基於官網SDK開發
從大華官網下載SDK開發包，找到上面的兩個介面後，就開始操刀基於官方C# demo開發。裝置登陸程式碼是官方demo提供的，但是門禁裝置狀態查詢總是返回false。跟大華技術支援聯絡後，提供了新的門禁開發demo。
發件人: DK 傳送時間: 2017年9月27日 9:51 收件人: 大華SDK支援 主題: 專案名稱-netsdk門禁-CLIENT_QueryDevState介面C#呼叫失敗 大華大神你好， 我是專案名稱平臺開發人員，在進行門禁除錯時遇到下面的問題，煩請幫忙診斷一下： 1、C#引入介面 [DllImport("dhnetsdk.dll")] public static extern bool CLIENT_QueryDevState(IntPtr lLoginID,int nType,IntPtr pBuf,int nBufLen,ref int pRetLen,int waittime); 2、C#呼叫 public static bool QueryDevState(IntPtr lLoginID,ref NET_DOOR_STATUS_INFO statusInfo) { var pRetLen = 0; var nBufLen = Marshal.SizeOf(typeof(NET_DOOR_STATUS_INFO)); IntPtr pBuf = IntPtr.Zero; pBuf = Marshal.AllocHGlobal(nBufLen); Marshal.StructureToPtr(statusInfo, pBuf, true); var result = OriginalSDK.CLIENT_QueryDevState(lLoginID, 0x0159, pBuf, nBufLen, ref pRetLen,1000); NetGetLastError(result); return result; } 3、呼叫結果： result = false error是一個不存在的錯誤編碼，一個很大的負數 **科技集團股份有限公司 我打農村來 187******** 2017-09-27 ============================================================================================ 發件人: 大華SDK支援 傳送時間: 2017年9月27日(星期三) 上午10:12 收件人: DK 主題: 答覆: 專案名稱-netsdk門禁-CLIENT_QueryDevState介面C#呼叫失敗 請參照附件Demo進行門禁開發、封裝引用。 有問題反饋 裝置上下文環境：裝置型號、韌體版本 問題描述：截圖、操作步驟 我們再分析下。
2.2 基於新的門禁demo
這次跟上次出現的問題差不多，也是登陸正常，但是狀態查詢異常，這次又提供了新的門禁開發demo。
發件人: DK
傳送時間: 2017年9月27日 15:11
收件人: 大華SDK支援
主題: 回覆：答覆: 專案名稱-netsdk門禁-CLIENT_QueryDevState介面C#呼叫失敗
你好，下午除錯了一下，有問題，詳細錯誤見附件，你幫忙看一下。
十分感謝。
------------------
**科技集團股份有限公司
我打農村來
187********
2017-09-27
============================================================================================
發件人：大華SDK支援
傳送時間：2017年9月27日(星期三) 3:14
收件人：DK
主題：答覆: 回覆：答覆: 專案名稱-netsdk門禁-CLIENT_QueryDevState介面C#呼叫失敗
裝置型號、版本資訊再補充提供下。
============================================================================================
發件人：DK
傳送時間：2017年9月27日(星期三) 3:20
收件人：大華SDK支援
主題：回覆：答覆: 回覆：答覆: 專案名稱-netsdk門禁-CLIENT_QueryDevState介面C#呼叫失敗
裝置型號：DH-ASC1204B
軟體版本參考附件
============================================================================================
發件人: 大華SDK支援
傳送時間: 2017年9月27日(星期三) 下午4:13
收件人: DK
主題: 轉發: 回覆：答覆: 專案名稱-netsdk門禁-CLIENT_QueryDevState介面C#呼叫失敗
附件是門禁C# Demo，供參閱。
1卡操作
2查詢記錄
3監聽事件、指紋抓取
看是否覆蓋業務，是否夠用？
2.3 針對版本的門禁demo
這次有進步，之前門禁狀態查詢一直返回的是無效的錯誤碼，這次找到了有效的錯誤碼-1。起初以為是Rec NO的問題，後來經電話溝通，確認是沒有複製大華的門禁相關dll到除錯輸出目錄下（debug）。把測試demo輸出目錄的所有dll拷貝到自己的除錯輸出目錄後，功能就正常了。
發件人：DK
傳送時間：2017年9月28日(星期四) 2:40
收件人：大華SDK支援
主題：回覆：轉發: 回覆：答覆: 專案名稱-netsdk門禁-CLIENT_QueryDevState介面C#呼叫失敗
你好，我今天試了下昨天發給我的demo：
1、登陸正常；
2、點選get按鈕，執行裝置查詢操作時，返回錯誤程式碼-1（未知錯誤）
操作順序：點選get按鈕-》彈出彈出1（參見附件get按鈕彈出1）-》未填寫任何資訊，點選ok-》彈出錯誤資訊（參見報錯資訊2）
============================================================================================
發件人：大華SDK支援
時 間：2017年9月28日(星期四) 3:06
收件人：DK
主題：專案名稱-netsdk門禁-CLIENT_QueryDevState介面C#呼叫失敗
這是查詢門禁卡的，要輸入Rec NO才行。
============================================================================================
發件人: DK
傳送時間: 2017年9月28日 15:42
收件人: 大華SDK支援
主題: 回覆：答覆: 專案名稱-netsdk門禁-CLIENT_QueryDevState介面C#呼叫失敗
你好，請問門禁卡的Rec NO如何獲取？
============================================================================================
發件人：大華SDK支援
時 間：2017年9月28日(星期四) 3:49
收件人：DK
主題：答覆: 回覆：答覆: 專案名稱-netsdk門禁-CLIENT_QueryDevState介面C#呼叫失敗
請注意接聽電話，我們打了兩遍您這邊都沒接
我打農村來187********
============================================================================================
發件人：DK
時 間：2017年9月28日(星期四) 4:52
收件人：大華SDK支援
主題：回覆：答覆: 回覆：答覆: 專案名稱-netsdk門禁-CLIENT_QueryDevState介面C#呼叫失敗
你好，十分感謝，在您的指導下，已經除錯完畢。
2.4 門禁控制結構體
這是個小問題，就是在開發門禁控制功能時，一個結構體找不到，原因是兩種語言下的命名方式不一致造成的。
發件人: DK
傳送時間: 2017年9月29日 11:13
收件人: 大華SDK支援
主題: 回覆：答覆: 回覆：答覆: 專案名稱-netsdk門禁-CLIENT_QueryDevState介面C#呼叫失敗
你好，
我在做門禁事件監聽時，查不到NET_ALARM_ACCESS_LOCK_STATUS_INFO這個結構體的構造，麻煩提供一下。
============================================================================================
發件人：大華SDK支援
時 間：2017年9月29日(星期五) 11:26
收件人：DK
主題：專案名稱-netsdk門禁-CLIENT_QueryDevState介面C#呼叫失敗
C#命名規則都以NET開頭，和C++的可能不一致
去掉頭就能搜到了ALARM_ACCESS_LOCK_STATUS_INFO2.5 門禁常開、常關
這個功能是後來發現的，現場的一些門是常開的，但是我在大華自己的門禁web系統裡看不到這種常開的狀態、包括我開發的門禁服務程式裡也區分不出來常開的情況。但是DH-ACS 100桌面軟體裡可以看到門是否常開，因此就想著肯定是有獲取門是否常開的介面。查詢文件和跟技術支援溝通，只得到了這個設定常開的介面。目前門是否處於常開狀態的訊號獲取未實現。
發件人:DK
傳送時間: 2018年4月25日 10:28
收件人: 大華SDK支援
主題: 專案名稱-netsdk門禁
你好，
在現場發現了門有常開的狀態，想請問下如何查詢、控制門禁的常開、常閉狀態。
============================================================================================
發件人：大華SDK支援
時 間：2018年4月25日(星期三) 5:16
收件人：DK
主題：答覆: 專案名稱-netsdk門禁
你好！
編譯執行附件demo，可以獲取設定門禁常開常閉狀態。
3. 除錯問題
2.1 CLR20R3異常
門禁服務程式除錯完畢後，本地加入CLR連線、配置、類庫，並提升.NET版本後，在伺服器上執行直接崩潰。且無法進入除錯斷點，直接執行則報CLR20R3錯誤，無從入手。
經查，CLR20R3最好的解決辦法是檢視window日誌。
最終解決辦法，修改程式編譯版本為x86解決問題
（參考地址）。
2.2. BEX64異常
調整編譯版本為x86，解決問題。
2.3. 找不到dll
拷貝大華SDk資料夾下的庫檔案到Release或者debug目錄下即可。
3.4. 門開關機制
門禁控制邏輯是這樣的：收到開門命令後，觸發門鎖開門（發出開發訊息）並等待2-3秒，然後門會自動鎖上（發出關門訊息）。我理解常開有兩種情況：
- 強制常開：門開啟後，一直阻擋門自動鎖上；
- 設定常開：設定常開模式，門鎖開啟後，不在自動鎖上。