客户端SDK开发使用手册 |
概述
客户端SDK是嵌入式网络硬盘录像机、视频服务器、IP设备的配套产品，用于设备远程访问及远程控制软件的开发，适用于以下产品型号：
DS-90xx混合型硬盘录像机；
DS-91xx、DS-81xx、DS-80xx、DS-70xx、DS-71xx、DS-7116、DS-72xx硬盘录像机；
DS-60xx、DS-61xx视频服务器、编/解码器；
IDS6002-HF/B双摄像机跟踪、IDS6101-HF/B智能设备（行为分析）、IDS52xx智能分析仪；
DS630x_D多路解码器；
IP设备：包含IP模块、IP摄像机（以下简称“IPC”）、IP快球等。
由于某些功能在此SDK版本中做了扩展，同时设备程序也做了相应的更新扩展，为了方便下文说明，此处将以上产品归为两类：DS7116、DS81xx、DS90xx、DS91xx系列产品称为V3.0以上版本支持的设备；其他产品称为V3.0以下版本支持的设备。
客户端SDK主要功能
图像预览、文件回放和下载、云台控制、布防/撤防、语音对讲、日志管理、解码卡、 远程升级、远程重启/关闭、格式化硬盘、参数配置（系统配置、通道配置、串口配置、报警配置、用户配置）、多路解码器、智能设备功能和获取设备能力集等。
客户端SDK包含网络通讯库、软解码库、硬解码库等功能组件：
网络通讯库 | |
RTSP通讯库 | |
软解码库 | |
转码库 | |
硬解码库 |
HCNetSDK.h | 头文件 |
HCNetSDK.lib | LIB库文件 |
HCNetSDK.dll | DLL库文件 |
本版本的客户端SDK开发包中包含以上各个组件，除网络通讯库这个组件为必须项外，用户可以根据需要选择其中的一部分组件，以下将对各个组件在SDK中的作用和使用条件分别说明。
- 网络通讯库是客户端SDK的主体，主要用于网络客户端与各类产品之间的通讯交互，负责远程功能调控、远程参数配置及码流数据的获取和处理等。
- RTSP通讯库是支持RTSP传输协议的网络库。当需要对支持RTSP协议的产品进行取流等操作时就必须加载该项组件。
- 软解码库主要用于对实时码流数据进行解码显示（实现预览功能）和对录像文件进行回放解码等。用户如果需要在SDK内部进行对实时流和录像码流播放显示时（即NET_DVR_RealPlay_V30接口的第二个结构体参数的播放句柄设置成有效句柄时）必须加载该组件，而如果用户仅需要用网络通讯库捕获到数据后再外部自行处理就不需要加载该组件，这种情况下用户在外部自行解码将更灵活，可参见软解码库函数说明《播放器SDK编程指南》。
- 转码库的功能可以分为两种：一种是将标准码流转换成采用我们公司封装格式的码流。当用户需要对支持RTSP协议的产品捕获采用本公司封装格式的码流数据时（即当设置NET_DVR_RealPlay_V30接口中的回调函数捕获数据或者调用NET_DVR_SetRealDataCallBack接口捕获数据时）必须加载该组件。另一种功能是能将标准码流转换成其他格式的封装，如3GPP、PS等。例如，当用户需要对支持RTSP协议的产品实时捕获指定封装格式的码流数据（对应的SDK接口为NET_DVR_SaveRealData_V30）时必须加载该项组件。
- 硬解码库需在配备硬解码卡（MD卡）的前提下使用，通过解码卡的解码与输出功能实现实时流的解码显示及向监视器上矩阵输出的功能。用户如果需要在SDK内部对实时流码流播放显示时必须加载该项组件。为更方便灵活地调用硬解码的相关功能，建议用户通过捕获数据在外部处理解码。相关硬解码库的功能函数可参见《板卡SDK编程指南》中解码卡API相关介绍。