大华网络SDK开发手册

大华网络SDK编程手册VERSION 3.1.8(Build 070321)

2007-3-21

版权所有侵权必究

前言

非常感谢您使用我们公司的设备，我们将为您提供最好的服务。

本手册可能包含技术上不准确的地方或印刷错误，欢迎指正。我们将会定期更新手册的内容。

修订记录

日期修订内容作者

2006-05-30 创建林峰

2006-7-3 修订接口描述冯江

2006-7-5 修订概要描述华立高

2006-7-26 修订接口描述刘杰陈美英

2006-8-10 同步更新接口描述陈美英

2006-8-21 修订接口描述陈美英

2006-8-23 增加典型调用顺序描述陈美英

2006-8-28 3.0.0整理修订陈美英

2006-9-15 3.0.5同步增加回调数据扩展接口,更新云台控制

说明

陈美英

2006-9-21 3.0.7同步增加登录扩展接口陈美英

2006-9-29 3.0.9同步增加带有配置结构的配置功能接口说

明

陈美英

2006-10-16 增加单独修改通道名称的接口赵均树

2006-10-21 增加打开实时图像的扩展接口赵均树

2006-10-28 1、增加按时间回放和下载接口

2、增加设备配置的第三方接入和获取设备的序

列号功能

赵均树

2006-11-8 1、带数据回调的按时间回放扩展接口

2、带数据回调的按文件回放扩展接口

3、远程重启接口

4、录像回放能够播放音频

赵均树、陈琼施

2006-11-19 1、解决了反复修改第三方的IP地址时DVR比

较容易死机的问题

2、增加485接口

3、通过网络修改IP配置时DVR重启

赵均树、陈琼施

2006-11-27 1、增加DDNS查询IP的功能赵均树、陈琼施2006-12-15 修正文档中接口描述的错误,并增加链接赵均树、陈琼施、林

坚彦

2006-12-25 增加并修改语音对讲的接口叶浩、陈琼施

2006-12-29 增加用户管理接口林坚彦、陈琼施

2007-1-17 修改了CLIENT_Login的功能描述

增加了CLIENT_FindFile、

CLIENT_FindNextFile、CLIENT_FindClose 林坚彦、赵均树、陈琼施

2007-2-8

增加了设备参数配置的两个接口：林坚彦、陈琼施、赵均树

CLIENT_GetDevConfig

CLIENT_SetDevConfig

2007-3-7

修改了CLIENT_StopListen接口典型应用的笔

误

赵均树

2007-03-19

增加了个查询报警状态的接口。

林坚彦、陈琼施

2007-03-21

增加了语音对讲中的音频编码接口

增加了扩展报警侦听接口叶浩、陈琼施、林坚彦

目录

1 简介 (7)

1.1概述 (7)

1.2适用性 (7)

1.3特色功能 (7)

2 设计原则 (9)

2.1编程说明 (9)

2.2典型调用顺序 (10)

3 数据结构定义 (13)

3.1客户端数据结构 (13)

3.1.1 设备信息结构 (16)

3.1.2 时间信息 (17)

3.1.3 录像文件信息 (17)

3.1.4 设备状态信息 (17)

3.1.5 系统配置信息结构 (22)

4 接口定义 (22)

4.1SDK初始化 (22)

4.2状态侦听 (24)

4.3字符叠加 (26)

4.4设备注册 (27)

4.5实时监视 (29)

4.6音频控制 (32)

4.7数据保存 (33)

4.8视频抓图 (36)

4.9回放和下载 (37)

4.10回放控制 (47)

4.11云台控制 (50)

4.12实时预览 (52)

4.13系统配置 (53)

4.14日志管理 (57)

4.15透明串口 (59)

4.16远程控制 (61)

4.17录像控制 (62)

4.18系统时间 (63)

4.19用户管理 (64)

4.20语音对讲 (66)

4.21码流统计 (71)

4.22IO控制 (72)

4.23强制I帧 (73)

4.24设置限流 (73)

4.25获取设备状态 (74)

4.26修改通道名称 (75)

4.27DDNS查询IP (75)

4.28设备参数配置 (76)

5 示例功能实现 (90)

5.1连接设备 (90)

5.2报警信息获取 (90)

5.3系统配置 (91)

5.4实时监视 (91)

5.5数据保存 (91)

5.6回放/下载和进度指示 (92)

5.7播放控制 (92)

5.8预览 (92)

5.9字符叠加 (92)

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.ocx

1.2适用性

⏹支持所有大华网络硬盘录像机（DVR）、网络视频服务器（NVS）、网络报警

服务器（NAS）

⏹只支持TCP网络传输模式

⏹客户端可以采用多种分辨率进行图像预览，支持的分辨率包括：QCIF、CIF、

2CIF、、HalfD1、D1，VGA（640×480）等

⏹客户端支持多种图像编码，包括MPEG4和H.264等

1.3特色功能

支持设备的以下特色功能：

⏹多路预览

在窄带条件下，同时多路实时监视对带宽的要求比较高，一般的处理情况有两种，其一，轮巡。其二，多路预览。所谓多路预览，就是在一个通道上把所有通道的数据组织在一起传输，等同于多路同时监视。必要的时候，可以转单路监视。大华DVR 支持多路预览功能。

⏹支持标准的MP4数据

一般情况下，同一平台集成不同厂商的前端设备（如DVR），由于各厂商采用的视频压缩方法不同(包括算法、参数定义等)，导致解码端回放必须采用厂商特定的工