大华网络SDK开发手册

大华网络SDK编程手册VERSION 3.1.8(Build 070321)2007-3-21版权所有侵权必究前言非常感谢您使用我们公司的设备，我们将为您提供最好的服务。

本手册可能包含技术上不准确的地方或印刷错误，欢迎指正。

我们将会定期更新手册的内容。

修订记录目录1 简介............................................... 错误!未指定书签。

1.1概述..........................................................1.2适用性.........................................................1.3特色功能.......................................................2 设计原则 ..........................................................2.1编程说明.......................................................2.2典型调用顺序....................................................3 数据结构定义.......................................................3.1客户端数据结构..................................................3.1.1 设备信息结构................................................3.1.2 时间信息 (14)3.1.3 录像文件信息................................................3.1.4 设备状态信息................................................3.1.5 系统配置信息结构.............................................4 接口定义 ..........................................................4.1SDK初始化.....................................................4.2状态侦听.......................................................4.3字符叠加.......................................................4.4设备注册.......................................................4.5实时监视.......................................................4.6音频控制......................................... 错误!未定义书签。

4.7数据保存.......................................................4.8视频抓图.......................................................4.9回放和下载 .....................................................4.10回放控制......................................................4.11云台控制......................................................4.12实时预览......................................................4.13系统配置......................................................4.14日志管理......................................................4.15透明串口......................................................4.16远程控制........................................ 错误!未定义书签。

4.17录像控制......................................................4.18系统时间......................................................4.19用户管理......................................................4.20语音对讲......................................................4.21码流统计......................................................4.22IO控制.......................................................4.23强制I帧......................................................4.24设置限流......................................................4.25获取设备状态...................................................4.26修改通道名称 (5)4.27DDNS查询IP ..................................................4.28设备参数配置...................................................5 示例功能实现.......................................................5.1连接设备.......................................................5.2报警信息获取....................................................5.3系统配置.......................................................5.4实时监视.......................................................5.5数据保存.......................................................5.6回放/下载和进度指示..............................................5.7播放控制.......................................................5.8预览..........................................................5.9字符叠加.......................................................1简介1.1概述欢迎使用大华网络SDK编程手册，网络客户端软件开发包（DVR客户端SDK）是大华网络硬盘录像机、网络视频服务器的配套产品，本文档详细描述了开发包中各个函数实现的功能、接口及其函数之间的调用关系和示例实现。

网络客户端软件开发包主要包括业务操作和设备管理两大部分：业务操作：状态侦听、实时监视、实时预览、字符叠加、音频控制、录像回放和下载、数据保存、云台控制、语音对讲、透明串口、码流统计等功能。

设备管理：远程升级、远程重启/关闭、设备参数配置（系统通用配置、报警布/撤防设置、录像配置、串口配置、图像配置、日志管理、用户管理、设备校时、动态检测配置、网络配置）等功能。

开发包所包括的文件有：网络库：dhnetsdk.lib、dhnetsdk.dll、dhnetsdk.h解码库：decode.dll、render.dll、dllh264.dll、audiorecord.dll、AudioRecordEx.dll、avcodec.dll辅助库：dhdvr.dll、ParaTimer.dll、DetectAreaCtrl.ocx、SetDeviceConfigProj.ocx1.2适用性⏹支持所有大华网络硬盘录像机（DVR）、网络视频服务器（NVS）、网络报警服务器（NAS）⏹只支持TCP网络传输模式⏹客户端可以采用多种分辨率进行图像预览，支持的分辨率包括：QCIF、CIF、2CIF、、HalfD1、D1，VGA（640×480）等⏹客户端支持多种图像编码，包括MPEG4和H.264等1.3特色功能支持设备的以下特色功能：⏹多路预览在窄带条件下，同时多路实时监视对带宽的要求比较高，一般的处理情况有两种，其一，轮巡。

其二，多路预览。

所谓多路预览，就是在一个通道上把所有通道的数据组织在一起传输，等同于多路同时监视。

必要的时候，可以转单路监视。

大华DVR 支持多路预览功能。

⏹支持标准的MP4数据一般情况下，同一平台集成不同厂商的前端设备（如DVR），由于各厂商采用的视频压缩方法不同(包括算法、参数定义等)，导致解码端回放必须采用厂商特定的工具，造成平台开发商无法自定义播放标准。

本SDK能够解决这个问题。

通过特定接口，应用层可以通过本SDK获取标准媒体数据（FOURCC(‘D’、‘I’、‘V’、‘X’)视频数据），要支持用各种通用播放器播放，有了提供标准数据，应用层只须打包标准数据到播放器支持的容器类型(也就是文件格式,如A VI标准)就可以了。

2设计原则2.1编程说明⏹初始化和清除1、使用网络客户端软件包首先调用CLIENT_Init()对系统进行初始化，应用程序退出时调用CLIENT_Cleanup()释放所有占用的资源。