NVR的SDK二次开发接口文档
采购的海康NVR及IPC的产品需支持SDK版本在XXX上 能够支持输出RTSP协议流 以下SDK的接口是必须的
1 账号验证
用户登录NVR：实现用户的认证功能，登录成功后，返回的用户ID 作为其他功能操作的唯一标识。
1.1 SDK初始化 1) 初始化SDK 接口：NET_DVR_Init 函数： BOOL NET_DVR_Init() 参数： 无
返回值： TRUE 表示成功，FALSE 表示失败。 说明： 调用设备网络SDK 其他函数的前提。 2) 释放SDK 资源 接口：NET_DVR_Cleanup 函数： BOOL NET_DVR_Cleanup() 参数： 无
返回值： TRUE 表示成功，FALSE 表示失败。
说明： 在结束之前最后调用。接口返回失败请调用NET_DVR_GetLastError 获取错误码，通过错误码判断出错原因。 1.2 NVR用户的认证/登录 1) 激活设备
接口：NET_DVR_ActivateDevice
函数： BOOL NET_DVR_ActivateDevice(char* sDVRIP, WORD wDVRPort, LPNET_DVR_ACTIVATECFGlpActivateCfg) 参 数：
[in]sDVRIP 设备IP 地址 [in]wDVRPort 设备端口
[in]lpActivateCfg 激活参数，包括激活使用的初始密码 返回值： TRUE 表示成功，FALSE 表示失败。接口返回失败请调用NET_DVR_GetLastError 获取错误码，通过错误码判断出错原因。
说明： 出厂设备需要先激活，然后再使用激活使用的初始密码登录设备。
2) IPServer 或者DDNS 域名解析，获取动态IP 地址和端口号 接口：NET_DVR_GetDVRIPByResolveSvr_EX
函数：BOOL NET_DVR_GetDVRIPByResolveSvr_EX (char* sServerIP, WORD wServerPort, BYTE* sDVRName, WORD wDVRNameLen, BYTE* sDVRSerialNumber, WORD wDVRSerialLen,
char* sGetIP, DWORD* dwPort) 参数：
[in]sServerIP 解析服务器的IP 地址
[in]wServerPort 解析服务器的端口号，IP Server 解析服务器端口号为7071，HiDDNS 服务器的端口号为80 [in]sDVRName 设备名称
[in]wDVRNameLen 设备名称的长度 [in]sDVRSerialNumber 设备的序列号 [in]wDVRSerialLen 设备序列号的长度 [out]sGetIP 获取到的设备IP 地址指针 [out]dwPort 获取到的设备端口号指针
返回值： TRUE 表示成功，FALSE 表示失败。接口返回失败请调用NET_DVR_GetLastError 获取错误码，通过错误码判断出错原因。
说 明： 该接口中的设备名称和设备序列号不能同时为空。通过设备域名或者序列号解析出设备当前IP地址和端口，然后调用NET_DVR_Login_V40 登录设备。支持的解析服务器有IPServer 和hiDDNS。 3) 用户注册设备
接口：NET_DVR_Login_V40
函 数： LONG NET_DVR_Login_V40(LPNET_DVR_USER_LOGIN_INFO pLoginInfo,LPNET_DVR_DEVICEINFO_V40 lpDeviceInfo)
参 数：
[in]pLoginInfo 登录参数，包括设备地址、登录用户、密码等 [out]lpDeviceInfo 设备信息(同步登录即pLoginInfo 中bUseAsynLogin 为0 时有效
返回值： 异步登录的状态、用户ID 和设备信息通过 NET_DVR_USER_LOGIN_INFO 结构体中设置的回调函数(fLoginResultCallBack)返回。对于同步登录，接口返回-1 表示登录失败，其他值表示返回的用户ID 值。用户ID 具有唯一性，后续对设备的操作都需要通过此ID 实现。接口返回失败请调用NET_DVR_GetLastError 获取错误码，通过错误码判断出错原因。 说 明： pLoginInfo 中bUseAsynLogin 为0 时登录为同步模式，接口返回成功即表示登录成功；pLoginInfo中bUseAsynLogin 为1 时登录为异步模式，登录是否成功在输入参数设置的回调函数中返回。设备同时最多允许128 个用户注册。SDK 支持2048 个注册，返回UserID 的取值范围为0~2047。 4) 用户注销
接口：NET_DVR_Logout
函 数： BOOL NET_DVR_Logout(LONG lUserID) 参 数：
[in]lUserID 用户ID 号，NET_DVR_Login_V40 的返回值 返回值：TRUE 表示成功，FALSE 表示失败。接口返回失败请调用NET_DVR_GetLastError 获取错误码，通过错误码判断出错原因。
说 明： 建议使用此接口实现注销功能。
2 视频监控浏览
1) 启动预览
接口：NET_DVR_RealPlay_V40
函 数： LONG NET_DVR_RealPlay_V40(LONG lUserID, LPNET_DVR_PREVIEWINFO lpPreviewInfo,
REALDATACALLBACK fRealDataCallBack_V30, void *pUser) 参 数：
[in] lUserID NET_DVR_Login_V40 的返回值
[in] lpPreviewInfo 预览参数，包括通道号、码流类型、取流协议 [in] fRealDataCallBack_V30 码流数据回调函数 [in] pUser 用户数据
返回值： -1 表示失败，其他值作为NET_DVR_StopRealPlay 等函数的句柄参数。接口返回失败请调用
NET_DVR_GetLastError 获取错误码，通过错误码判断出错原因。 说 明： ? 该接口预览参数结构中可以设置当前预览操作是否阻塞（通过bBlocked 参数设置），若设为不阻塞，表示发起与设备的连接就认为连接成功，如果发生码流接收失败、播放失败等情况 以预览异常的方式通知上层。在循环播放的时候可以减短停顿的时间，与NET_DVR_RealPlay处理一致。若设为阻塞，表示直到播放操作完成才返回成功与否。