NVR的SKD二次开发接口文档Word格式文档下载.docx

1、 调用设备网络SDK 其他函数的前提。 2） 释放SDK 资源 接口：NET_DVR_Cleanup 函数： BOOL NET_DVR_Cleanup（） 参数： 说明： 在结束之前最后调用。接口返回失败请调用NET_DVR_GetLastError 获取错误码，通过错误码判断出错原因。 NVR用户的认证/登录 1） 激活设备 接口：NET_DVR_ActivateDevice 函数： BOOL NET_DVR_ActivateDevice（char* sDVRIP, WORD wDVRPort, LPNET_DVR_ACTIVATECFGlpActivateCfg） 参 数： insDVRI

2、P 设备IP 地址 inwDVRPort 设备端口 inlpActivateCfg 激活参数，包括激活使用的初始密码 返回值： 出厂设备需要先激活，然后再使用激活使用的初始密码登录设备。 2） IPServer 或者DDNS 域名解析，获取动态IP 地址和端口号 接口：NET_DVR_GetDVRIPByResolveSvr_EX 函数：BOOL NET_DVR_GetDVRIPByResolveSvr_EX （char* sServerIP, WORD wServerPort, BYTE* sDVRName, WORD wDVRNameLen, BYTE* sDVRSerialNumber,

3、 WORD wDVRSerialLen, char* sGetIP, DWORD* dwPort） 参数： insServerIP 解析服务器的IP 地址 inwServerPort 解析服务器的端口号，IP Server 解析服务器端口号为7071，HiDDNS 服务器的端口号为80 insDVRName 设备名称 inwDVRNameLen 设备名称的长度 insDVRSerialNumber 设备的序列号 inwDVRSerialLen 设备序列号的长度 outsGetIP 获取到的设备IP 地址指针 outdwPort 获取到的设备端口号指针 返回值： 说 明： 该接口中的设备名称和设

4、备序列号不能同时为空。通过设备域名或者序列号解析出设备当前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） 参 数： inpLoginInfo 登录参数，包括设备地址、登录用户、密码等 outlpDeviceInfo 设备信息（同步登录即pLoginInf

5、o 中bUseAsynLogin 为0 时有效 返回值： 异步登录的状态、用户ID 和设备信息通过 NET_DVR_USER_LOGIN_INFO 结构体中设置的回调函数（fLoginResultCallBack）返回。对于同步登录，接口返回-1 表示登录失败，其他值表示返回的用户ID 值。用户ID 具有唯一性，后续对设备的操作都需要通过此ID 实现。 说 明： pLoginInfo 中bUseAsynLogin 为0 时登录为同步模式，接口返回成功即表示登录成功；pLoginInfo中bUseAsynLogin 为1 时登录为异步模式，登录是否成功在输入参数设置的回调函数中返回。设备同时最多

6、允许128 个用户注册。SDK 支持2048 个注册，返回UserID 的取值范围为02047。 4） 用户注销 接口：NET_DVR_Logout 函 数： BOOL NET_DVR_Logout（LONG lUserID） 参 数： inlUserID 用户ID 号，NET_DVR_Login_V40 的返回值 返回值：TRUE 表示成功，FALSE 表示失败。 建议使用此接口实现注销功能。 2 视频监控浏览 1） 启动预览 接口：NET_DVR_RealPlay_V40 函 数： LONG NET_DVR_RealPlay_V40（LONG lUserID, LPNET_DVR_PREV

7、IEWINFO 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 获取错误码，通过错误码判断出错原因。 ?

8、 该接口预览参数结构中可以设置当前预览操作是否阻塞，若设为不阻塞，表示发起与设备的连接就认为连接成功，如果发生码流接收失败、播放失败等情况 以预览异常的方式通知上层。在循环播放的时候可以减短停顿的时间，与NET_DVR_RealPlay处理一致。若设为阻塞，表示直到播放操作完成才返回成功与否。 ? 该接口中的回调函数可以置为空，这样该函数将不回调码流数据给用户，不过用户仍可以通过接口NET_DVR_SetRealDataCallBack 或NET_DVR_SetStandardDataCallBack 注册捕获码流数据 的回调函数以捕获码流数据。 fRealDataCallBack_V30 回

9、调函数中不能执行可能会占用时间较长的接口或操作，不建议调用该SDK本身的接口。 Linux 64 位系统不支持软解码功能，因此需要将窗口句柄传NULL，设置回调函数，只取流不解码显示。 ? 客户端异常离线时，设备端对取流连接的保持时间为10 秒。 2） 停止预览 接口：NET_DVR_StopRealPlay 函 数： LONG NET_DVR_StopRealPlay （LONG lRealHandle） 参 数： inlRealHandle 预览句柄，NET_DVR_RealPlay_V40 的返回值 返回值： 3） 获取预览时用来解码和显示的播放库句柄 接口：NET_DVR_GetRea

10、lPlayerIndex 函 数： int NET_DVR_GetRealPlayerIndex（LONG lRealHandle） 参 数： -1 表示失败，其他值表示播放句柄。 用户可以通过返回的句柄自行实现播放库SDK 提供的其他功能，详见本公司提供的软解码库函数说明播放器SDK 编程指南。 3 IPC录像 IPC信息操作 1） 获取IPC信息列表 接口：NET_DVR_GetSadpInfoList 函 数： BOOL NET_DVR_GetSadpInfoList（LONG lUserID, LPNET_DVR_SADPINFO_LIST lpSadpInfoList） 参 数： i

11、nlUserID NET_DVR_Login_V40 的返回值 outlpSadpInfoList IPC 信息列表结构 返回值： 2） 修改IPC信息 接口：NET_DVR_UpdateSadpInfo 函 数： BOOL NET_DVR_UpdateSadpInfo（LONG lUserID, LPNET_DVR_SADP_VERIFY lpSadpVerify, LPNET_DVR_SADPINFO lpSadpInfo） 参 数： inlUserID NET_DVR_Login_V40 的返回值 inlpSadpVerify 校验信息 inlpSadpInfo 修改的IPC 信息列表结

12、构 返回值： 声音控制功能 1） 设置声音播放模式 接口：NET_DVR_SetAudioMode 函 数： BOOL NET_DVR_SetAudioMode（DWORD dwMode） 参 数： indwMode 声音播放模式：1- 独占声卡，单路音频模式；2- 共享声卡，多路音频模式 返回值： 不调用该接口设置声音播放模式，默认为独占播放。 2） 独占声卡模式下开启声音 接口：NET_DVR_OpenSound 函 数： BOOL NET_DVR_OpenSound（LONG lRealHandle） 参 数： inlRealHandle NET_DVR_RealPlay_V40 的返回值 返回值： 如果当前是共享模式播放，调用该接口将返回失败。以独占方式只能打开一路通道播放，即依次打开多个通道时仅打开最后一路。 3） 独占声卡模式下关闭声音 接口：NET_DVR_CloseSound 函 数： BOOL NET_DVR_CloseSound（） 参 数：接口返回失败请调用NE