SDK接口调用的主要流程

SDK接口调用的主要流程

其中虚线框的流程是可选部分，不会影响其他流程和模块的功能使用。按实现功能的不同可以分成十个模块，实现每个模块的功能时初始化SDK、用户注册设备、注销设备和释放SDK资源这4个流程是必不可少的。

初始化SDK（NET_DVR_Init接口）：对整个网络SDK系统的初始化，内存预分配等操作。

设置连接超时时间（NET_DVR_SetConnectTime接口）：这部分为可选，用于设置SDK中的网络连接超时时间，用户可以根据自己的需要设置该值。在不调用此接口设置超时时间的情况下，将采用SDK中的默认值。

设置接收异常消息的回调函数（NET_DVR_SetDVRMessage或者NET_DVR_SetExceptionCallBack_V30）：由于SDK中大部分模块的功能都是由异步模式实现，所以我们提供此接口用于接收预览、报警、回放、透明通道和语音对讲等模块发生异常信息。用户可以在初始化SDK后就设置该回调函数，在应用层对各个模块异常消息的接收和处理。

从解析服务器获得设备的IP地址（NET_DVR_GetDVRIPByResolveSvr）：该接口提供一种在仅知道设备名称和序列号的情况下，从解析服务器获得设备IP地址的方法。如：当前设备是通过拨号上网方式获取到动态IP地址，而运行了我公司IPServer软件的服务器即为解析服务器，我们可以通过此接口输入解析服务器的地址、设备的名称和序列号等信息查询该设备的IP地址。IPServer是海康威视提供的一款域名解析服务器软件，详细功能介绍请参考海康威视官方网站内容http://www.hikvision.com/。

用户注册设备（NET_DVR_Login_V30接口）：实现用户的注册功能，注册成功后，返回的用户ID作为其他功能操作的唯一标识，SDK允许最大注册用户数为512个。就设备而言，V3.0以上版本支持的设备允许有32个注册用户名，而且同时最多允许128个用户注册；V3.0以下版本支持的设备允许有16个注册用户名，而且同时最多允许128个用户注册。

预览模块：从前端服务器取实时码流，解码显示以及播放控制等功能，同时支持软解码和解码卡解码。具体流程详见预览模块流程。

回放和下载模块：可以通过按时间和按文件名的方式远程回放或者下载前端服务器的录像文件，后续可以进行解码或者存储。同时还支持断点续传功能。具体流程详见回放和下载模块流程。

参数配置模块：设置和获取前端服务器的参数，主要包括设备参数、网络参数、通道压缩参数、串口参数、报警参数、异常参数、交易信息和用户配置等参数信息。具体流程详见参数配置模块流程。

远程设备维护模块：实现关闭设备、重启设备、恢复默认值、远程硬盘格式化、远程升级和配置文件导入/导出等维护工作。具体流程详见远程设备维护模块流程。

语音对讲转发模块：实现和前端服务器的语音数据对讲和语音数据获取，音频编码格式可以指定。具体流程详见语音对讲转发模块流程。

报警模块：处理前端服务器上传的各种报警信号。报警分为“布防”和“监听”两种方式，在采用监听方式并且不需要获取用户ID的情况下，报警模块可以无需进行“用户注册”操作步骤。具体流程详见报警模块流程。

透明通道模块：透明通道是将IP数据报文解析后直接发送到串行口的一种技术。实际上起到了延伸串行设备控制距离的作用。可利用IP网络控制多种串行设备，如控制解码器、矩阵、报警主机、门禁、仪器仪表等串行设备，对用户来说，只看到点对点传输，无须关心网络传输过程，所以称为串口透明通道。 SDK提供485和232串口作为透明通道功能，其中要将232串口作为透明通道使用，首先必须在232串口的配置信息（NET_DVR_RS232CFG）中将工作模式选为透明通道，这样232串口才可作为透明通道使用。具体流程详见透明通道模块流程。

云台控制模块：实现对云台的基本操作、预置点、巡航、轨迹和透明云台的控制。SDK将云台控制分为两种模式：一种是通过图像预览返回的句柄进行控制；另一种是无预览限制，通过用户注册ID号进行云台控制。

解码器功能模块：实现解码器设备的配置、解码控制等功能。SDK支持单路解码器和多路解码器，但目前以多路解码器为主流产品。具体流程详见多路解码器功能模块流程。

智能行为分析功能模块：实现对智能产品的参数配置、报警上传和能力集获取等功能。具体流程详见智能行为分析功能模块流程。