如何使用海康SDK实现异步登录网络摄像机(IPC)【源码】【监控】【录播】【NVR】

前言：

    在上一篇博客：《如何利用UDP组播实现海康网络摄像机(IPC)的自动探测功能》，我们已经通过源码实现了ONVIF协议的网络摄像机自动探测功能，获取到了IPC的IP地址和服务端口。

    要想进一步的操作IPC，就需要登录到IPC当中，海康IPC的登录有两种模式：同步和异步，同步比较简单，直接调用API就可以了，缺点是需要阻塞界面，用户体验不好；异步，无需阻塞界面，登录状态通过回调函数告知，相对比较麻烦一些，今天，我们就通过源码示例来详细介绍有关异步登录的使用方法。

    在开始写代码之前，我们先要下载好一份海康SDK，里面有详细的开发文档和丰富的示例程序；

    下载地址 => http://www.hikvision.com/cn/download_61.html

    我们示例代码使用的是 设备网络SDK_Win32，版本为 V5.2.5.25

源码下载：

    CSDN： https://download.csdn.net/download/haoyitech/10288543

源码说明：

    开发工具：下载后，请用 VS2010 打开。

    基本原理：先初始化海康SDK，准备好登录IPC需要的IP地址、服务端口、登录用户名、登录密码，调用异步登录接口，设置好回调函数；无论登录成功与否，回调函数都会以异步的方式返回，我们可以在异步回调函数当中验证和判断是否登录成功；由于异步回调函数仍然处于SDK里面的线程当中，我们为了避免阻塞SDK线程，在判断已经成功登录之后，向主窗口发起异步消息通知，在异步消息通知当中再进行实际的IPC操作，具体的操作示例，请详见：《如何使用海康SDK实现网络摄像机(IPC)自动配置》。

    总体思路：就是要将异步操作分散开，尽量不要在异步登录回调函数中进行IPC操作，要将具体操作交给主窗口主线程。

    特别注意：在程序退出释放资源时，没有直接退出，因为，有可能还处在异步登录的等待回调过程中，必须等待异步回调返回之后才能退出，否则，会引起程序崩溃。详见 Csample_hk_loginDlg::WaitForExit()

    海康SDK里面有很多的相关动态库，我们进行了部分筛选，只留下我们需要的，文件结构说明：

编译结果存放位置    => sample_hk_login\bin
海康SDK核心库       => sample_hk_login\bin\HCCore.dll
海康SDK网络库       => sample_hk_login\bin\HCNetSDK.dll
海康SDK播放D3D库    => sample_hk_login\bin\D3DX9_43.dll
海康SDK播放控件库   => sample_hk_login\bin\PlayCtrl.dll
海康SDK音频渲染库   => sample_hk_login\bin\AudioRender.dll
海康SDK播放辅助库   => sample_hk_login\bin\SuperRender.dll
海康SDK画面预览库   => sample_hk_login\bin\HCNetSDKCom\HCPreview.dll
海康SDK设备配置库   => sample_hk_login\bin\HCNetSDKCom\HCCoreDevCfg.dll
海康SDK通用配置库   => sample_hk_login\bin\HCNetSDKCom\HCGeneralCfgMgr.dll
浩一科技代码辅助库  => sample_hk_login\common

关键代码：（详见 Csample_hk_loginDlg）

1、初始化过程：

BOOL Csample_hk_loginDlg::OnInitDialog()
{
      .........................
	// 初始化海康SDK资源...
	NET_DVR_Init();

	// 初始化网络、线程、套接字...
	WORD	wsVersion = MAKEWORD(2, 2);
	WSADATA	wsData	  = {0};
	(void)::WSAStartup(wsVersion, &wsData);
      .........................
}

2、发起异步登录：

// 点击“异步登录”按钮...
void Csample_hk_loginDlg::OnBnClickedButtonAsync()
{
	if( m_HKLoginID > 0 ) {
		TRACE("=== 当前已经处于登录状态 ===\n");
		return;
	}
	ASSERT( m_HKLoginID <= 0 );
	CString strAddress("192.168.1.65");
	CString strUser("admin");
	CString strPass("admin123");
	int nCmdPort = 8000;
	DWORD dwErr = this->doDeviceLogin(strAddress, nCmdPort, strUser, strPass);
}
// 执行DVR登录操作...
DWORD Csample_hk_loginDlg::doDeviceLogin(LPCTSTR lpIPAddr, int nCmdPort, 
                                         LPCTSTR lpUser, LPCTSTR lpPass)
{	// 将摄像机的错误标志复位...
	m_dwHKErrCode = NET_DVR_NOERROR;
	// 登录之前，先释放资源，保存通知窗口...
	DWORD dwErr = GM_NoErr;
	this->ClearResource();
	// 异步方式登录DVR设备...
	NET_DVR_DEVICEINFO_V40  dvrDevV40 = {0};
	NET_DVR_USER_LOGIN_INFO dvrLoginInfo = {0};
	dvrLoginInfo.cbLoginResult = Csample_hk_loginDlg::DeviceLoginResult;
	strcpy(dvrLoginInfo.sDeviceAddress, lpIPAddr);
	strcpy(dvrLoginInfo.sUserName, lpUser);
	strcpy(dvrLoginInfo.sPassword, lpPass);
	dvrLoginInfo.bUseAsynLogin = 1;
	dvrLoginInfo.wPort = nCmdPort;
	dvrLoginInfo.pUser = this;
	// 调用异步接口函数...
	if( NET_DVR_Login_V40(&dvrLoginInfo, &dvrDevV40) < 0 ) {
		dwErr = NET_DVR_GetLastError();
		MsgLogGM(dwErr);
	}
	// 设置正在异步登录中标志...
	m_HKLoginIng = true;
	// 如果调用失败，清除所有资源...
	if( dwErr != GM_NoErr ) {
		TRACE("=== 登录失败，错误号：%lu ===\n", dwErr);
		this->ClearResource();
		return dwErr;
	}
	// 打印正在登录状态...
	TRACE("=== 正在异步登录... ===\n");
	return GM_NoErr;
}

3、等待异步反馈：

// 登录回调函数接口...
void CALLBACK Csample_hk_loginDlg::DeviceLoginResult(LONG lUserID, DWORD dwResult,
                              LPNET_DVR_DEVICEINFO_V30 lpDeviceInfo, void * pUser)
{	Csample_hk_loginDlg * lpDlg = (Csample_hk_loginDlg*)pUser;
	lpDlg->onDeviceLoginAsync(lUserID, dwResult, lpDeviceInfo);
}
// 设备异常回调函数接口...
void CALLBACK Csample_hk_loginDlg::DeviceException(DWORD dwType, LONG lUserID,
                                                  LONG lHandle, void * pUser)
{
	Csample_hk_loginDlg * lpDlg = (Csample_hk_loginDlg*)pUser;
	lpDlg->onDeviceException(dwType, lUserID, lHandle);
}
//
// 处理设备异常的实际函数...
void Csample_hk_loginDlg::onDeviceException(DWORD dwType, LONG lUserID, LONG lHandle)
{
	TRACE("=== Device Exception 0x%x ===\n", dwType);
}

4、判断登录结果，再次发起异步通知：

// 实际处理登录回调的函数...
void Csample_hk_loginDlg::onDeviceLoginAsync(LONG lUserID, DWORD dwResult,
                             LPNET_DVR_DEVICEINFO_V30 lpDeviceInfo)
{	// 正在登录状态复位...
	m_HKLoginIng = false;
	// 处在退出状态中，直接返回...
	if( m_bIsExiting ) {
		TRACE("=== onDeviceLoginAsync => Exit ===\n");
		return;
	}
	// 登录失败的处理过程，需要通知上层窗口...
	if( dwResult <= 0 || lUserID < 0 ) {
		m_dwHKErrCode = NET_DVR_GetLastError();
		TRACE("=== 登录失败(%lu)，错误：%s ===\n", m_dwHKErrCode, NET_DVR_GetErrorMsg(&m_dwHKErrCode));
		// 释放该通道上的资源数据...
		this->ClearResource();
		MsgLogGM(m_dwHKErrCode);
		return;
	}
	// 登录成功之后，保存数据...
	m_dwHKErrCode = NET_DVR_NOERROR;
	this->m_HKLoginID = lUserID;
	memcpy(&m_HKDeviceInfo, lpDeviceInfo, sizeof(NET_DVR_DEVICEINFO_V30));
	// 通过异步消息，离开登录线程...
	::PostMessage(this->m_hWnd, WM_DEVICE_LOGIN_SUCCESS, NULL, NULL);
}

5、在异步通知中操作IPC：

// 处理异步登录成功的消息通知...
LRESULT Csample_hk_loginDlg::OnDeviceLoginSuccess(WPARAM wParam, LPARAM lParam)
{
	// 打印异步登录成功消息...
	TRACE("=== 异步登录成功... ===\n");
	return S_OK;
}

6、退出登录：

// 点击“立即注销”按钮...
void Csample_hk_loginDlg::OnBnClickedButtonLogout()
{
	this->ClearResource();
}

// 释放建立资源...
void Csample_hk_loginDlg::ClearResource()
{
	// 释放登录资源...
	if( m_HKLoginID >= 0 ) {
		NET_DVR_Logout_V30(m_HKLoginID);
		m_HKLoginID = -1;
		memset(&m_HKDeviceInfo, 0, sizeof(m_HKDeviceInfo));
	}
}

7、释放资源：

Csample_hk_loginDlg::~Csample_hk_loginDlg()
{
	// 释放海康SDK资源...
	NET_DVR_Cleanup();
	// 阻塞等待退出...
	this->WaitForExit();
	// 注销登录...
	this->ClearResource();
}
// 等待异步登录退出 => 使用互斥不起作用...
void Csample_hk_loginDlg::WaitForExit()
{
	m_bIsExiting = true;
	while( m_HKLoginIng ) {
		::Sleep(5);
	}
	ASSERT( !m_HKLoginIng );
}

注意：在程序退出释放资源时，没有直接退出，因为，有可能还处在异步登录的等待回调过程中，必须等待异步回调返回之后才能退出，否则，会引起程序崩溃。

更多信息：

************************************************************
 * 浩一科技，提供云监控、云录播的全平台无插件解决方案。
 * 支持按需直播，多点布控，分布式海量存储，动态扩容；
 * 支持微信扫码登录，全平台帐号统一，关联微信小程序；
 * 支持多种数据输入：摄像头IPC、rtmp、rtsp、MP4文件；
 * 支持全实时、全动态、全网页管理，网页前后台兼容IE8；
 * 支持多终端无插件自适应播放，flvjs/hls/rtmp自动适配；
************************************************************
 * 官方网站 => https://myhaoyi.com
 * 技术博客 => http://blog.csdn.net/haoyitech
 * 开源代码 => https://github.com/HaoYiTech/
************************************************************