《大华网络SDK开发手册》由会员分享，可在线阅读，更多相关《大华网络SDK开发手册（83页珍藏版）》请在金锄头文库上搜索。
1、精品文档，仅供学习与交流，如有侵权请联系网站删除大华网络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-2
2、83.0.0整理修订陈美英2006-9-153.0.5同步增加回调数据扩展接口,更新云台控制说明陈美英2006-9-213.0.7同步增加登录扩展接口陈美英2006-9-293.0.9同步增加带有配置结构的配置功能接口说明陈美英2006-10-16增加单独修改通道名称的接口赵均树2006-10-21增加打开实时图像的扩展接口赵均树2006-10-281、增加按时间回放和下载接口2、增加设备配置的第三方接入和获取设备的序列号功能赵均树2006-11-81、带数据回调的按时间回放扩展接口2、带数据回调的按文件回放扩展接口3、远程重启接口4、录像回放能够播放音频赵均树、陈琼施2006-11-191、
3、 解决了反复修改第三方的IP地址时DVR比较容易死机的问题2、 增加485接口3、 通过网络修改IP配置时DVR重启赵均树、陈琼施2006-11-271、 增加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增加了设备参数
4、配置的两个接口：CLIENT_GetDevConfig CLIENT_SetDevConfig林坚彦、陈琼施、赵均树2007-3-7修改了CLIENT_StopListen接口典型应用的笔误赵均树2007-03-19增加了个查询报警状态的接口。林坚彦、陈琼施2007-03-21增加了语音对讲中的音频编码接口增加了扩展报警侦听接口叶浩、陈琼施、林坚彦目 录1 简 介71.1 概述71.2 适用性71.3 特色功能82 设计原则92.1 编程说明92.2 典型调用顺序103 数据结构定义133.1 客户端数据结构133.1.1 设备信息结构163.1.2 时间信息163.1.3 录像文件信息173
5、.1.4 设备状态信息173.1.5 系统配置信息结构214 接口定义214.1 SDK初始化214.2 状态侦听234.3 字符叠加254.4 设备注册264.5 实时监视274.6 音频控制314.7 数据保存324.8 视频抓图354.9 回放和下载364.10 回放控制464.11 云台控制494.12 实时预览514.13 系统配置524.14 日志管理574.15 透明串口584.16 远程控制604.17 录像控制624.18 系统时间634.19 用户管理634.20 语音对讲654.21 码流统计694.22 IO控制704.23 强制I帧714.24 设置限流714.25
6、获取设备状态724.26 修改通道名称724.27 DDNS查询IP734.28 设备参数配置735 示例功能实现875.1 连接设备885.2 报警信息获取885.3 系统配置885.4 实时监视885.5 数据保存895.6 回放/下载和进度指示895.7 播放控制895.8 预览895.9 字符叠加891 简 介1.1 概述欢迎使用大华网络SDK编程手册，网络客户端软件开发包（DVR客户端SDK）是大华网络硬盘录像机、网络视频服务器的配套产品，本文档详细描述了开发包中各个函数实现的功能、接口及其函数之间的调用关系和示例实现。 网络客户端软件开发包主要包括业务操作和设备管理两大部分： 业务
7、操作：状态侦听、实时监视、实时预览、字符叠加、音频控制、录像回放和下载、数据保存、云台控制、语音对讲、透明串口、码流统计等功能。设备管理：远程升级、远程重启/关闭、设备参数配置（系统通用配置、报警布/撤防设置、录像配置、串口配置、图像配置、日志管理、用户管理、设备校时、动态检测配置、网络配置）等功能。 开发包所包括的文件有：网络库：dhnetsdk.lib、dhnetsdk.dll、dhnetsdk.h解码库：decode.dll、render.dll、dllh264.dll、audiorecord.dll、AudioRecordEx.dll、avcodec.dll辅助库：dhdvr.dll、
8、ParaTimer.dll、DetectAreaCtrl.ocx、SetDeviceConfigProj.ocx1.2 适用性 n 支持所有大华网络硬盘录像机（DVR）、网络视频服务器（NVS）、网络报警 服务器（NAS） n 只支持TCP网络传输模式 n 客户端可以采用多种分辨率进行图像预览，支持的分辨率包括： QCIF、CIF、2CIF、HalfD1、D1，VGA（640480）等n 客户端支持多种图像编码，包括MPEG4和H.264等1.3 特色功能支持设备的以下特色功能：n 多路预览在窄带条件下，同时多路实时监视对带宽的要求比较高，一般的处理情况有两种，其一，轮巡。其二，多路预览。所谓
9、多路预览，就是在一个通道上把所有通道的数据组织在一起传输，等同于多路同时监视。必要的时候，可以转单路监视。大华DVR支持多路预览功能。n 支持标准的MP4数据一般情况下，同一平台集成不同厂商的前端设备（如DVR），由于各厂商采用的视频压缩方法不同(包括算法、参数定义等)，导致解码端回放必须采用厂商特定的工具，造成平台开发商无法自定义播放标准。本SDK能够解决这个问题。通过特定接口，应用层可以通过本SDK获取标准媒体数据（FOURCC(D、I、V、X)视频数据），要支持用各种通用播放器播放，有了提供标准数据，应用层只须打包标准数据到播放器支持的容器类型(也就是文件格式,如AVI标准)就可以了。2
10、 设计原则2.1 编程说明n 初始化和清除1、 使用网络客户端软件包首先调用CLIENT_Init()对系统进行初始化，应用程序退出时调用CLIENT_Cleanup()释放所有占用的资源。 2、 大多数函数调用均应该在CLIENT_Init()之后，CLIENT_Cleanup()之前，除了少数函数，譬如CLIENT_SetConnectTime()在CLIENT_Init()之前调用，而CLIENT_GetSDKVersion()可以在任何时候调用等等。n 操作句柄系统设计上多处使用了句柄概念，很多操作均针对句柄，如回放、下载以及语音对讲等。n 用户登录和注销用户在访问前端设备之前必须通过
11、调用CLIENT_Login ()登录到前端设备上，登录成功后返回一个全局唯一的句柄。此句柄就像一个会话通道，之后该用户可通过此句柄访问前端设备。退出该会话时则通过CLIENT_Logout ()函数在前端设备上注销此句柄以终止该会话通道的使用。建立连接与登录是同步的。 n 心跳功能在本开发包中提供自动心跳功能（20秒一次心跳）当设备断开能及时回调给客户端。n 同步与异步异步以设置回调函数来响应网络数据，有些异步在设置后返回请求句柄，结束请求时将请求句柄提供给SDK以注销相关资源。n SDK提供协议探测和转换n 回调函数一般都有dwUser参数, 由用户自定义需要的数据, 一般用来传入类对象指
12、针, 方便回调处理在类中实现,回调应用都可以采取这种方式。2.2 典型调用顺序A. 初始化 SDK初始化 CLIENT_Init()B. SDK功能设置或信息获取设置连接等待时间 CLIENT_SetConnectTime()获取SDK版本 CLIENT_GetSDKVersion()设置消息回调 CLIENT_SetDVRMessCallBack()设置自定义叠加画板 CLIENT_RigisterDrawFun()C. 登录连接设备登录设备 CLIENT_Login()开始侦听 CLIENT_StartListen()D. 设备功能操作与信息获取系统配置 CLIENT_QueryConfi
13、g() CLIENT_SetupConfig()获取设备状态 CLIENT_GetDEVWorkState()获取协议信息 CLIENT_QueryComProtocol()查询获取系统信息 CLIENT_QuerySystemInfo()查询通道名称 CLIENT_QueryChannelName()查询日志 CLIENT_QueryLogCallback() CLIENT_QueryLog()用户管理 CLIENT_QueryUserInfo()CLIENT_OperateUserInfo()云台控制 CLIENT_PTZControl() CLIENT_DHPTZControl()语音对
14、讲 CLIENT_StartTalk() CLIENT_SendTalkData_Custom() CLIENT_StopTalk()设置限流 CLIENT_SetMaxFlux()透明串口 CLIENT_CreateTransComChannel() CLIENT_SendTransComData() CLIENT_DestroyTransComChanne()E. 实时监视通道打开监视通道 CLIENT_RealPlay() CLIENT_RealPlayEx()保存监视图像数据 CLIENT_SaveRealData()监视数据回调保存 CLIENT_SetRealDataCallBack()CLIENT_SetRealDataCallBackEx()获取视频
