网络SDK开发手册Word文件下载.docx
《网络SDK开发手册Word文件下载.docx》由会员分享，可在线阅读，更多相关《网络SDK开发手册Word文件下载.docx（97页珍藏版）》请在冰豆网上搜索。
增加以下接口：
H264_DVR_StartDVRRecord，H264_DVR_StopDVRRecord，H264_DVR_SetSystemDateTime，H264_DVR_GetDVRWorkState，H264_DVR_ClickKey
2010．08．7
H264_DVR_StorageManage，H264_DVR_SendNetAlarmMsg，H264_DVR_StartAlarmCenterListen，
H264_DVR_StopAlarmCenterListen，H264_DVR_APIboolH264_DVR_DelRealDataCallBack，H264_DVR_APIlongH264_DVR_PlayBackByTime，H264_DVR_APIlongH264_DVR_GetFileByTime，H264_DVR_APIboolH264_DVR_PTZControlEx，H264_DVR_APIlongH264_DVR_GetDevConfig，H264_DVR_APIlongH264_DVR_SetDevCon，H264_DVR_APIlongH264_DVR_SetConfigOverNet
2011．06．27
H264_DVR_SetConnectTime,H264_DVR_APIlongCALL_METHODH264_DVR_SetConfigOverNet,H264_DVR_APIlongCALL_METHODH264_DVR_PauseRealPlay,H264_DVR_SetRealDataCallBack_V2,H264_DVR_FindFileByTime,H264_DVR_PlayBackByName_V2,H264_DVR_PlayBackByTime,H264_DVR_PlayBackByTimeEx,CALL_METHODH264_DVR_GetFileByTime,H264_DVR_CatchPic,H264_DVR_CatchPicInBuffer,H264_DVR_SerialWrite,H264_DVR_SerialRead,H264_DVR_GetDDNSInfo,H264_DVR_MakeKeyFrame
目录
1.简介6
1.1概述6
1.2适用性6
设计原则7
1.3编程说明7
1.4典型调用顺序8
2数据结构定义11
2.1客户端数据结构11
2.1.1常量定义14
2.1.2设备信息结构22
2.1.3时间信息22
2.1.4录像文件信息24
2.1.5配置信息结构29
2.1.6网络键盘键值定义50
2.1.7网络报警信息52
2.1.8存储设备控制信息53
2.1.9RTSP信息53
2.1.10互信互通53
2.1.11新望平台54
2.1.12视搜平台54
2.1.13VVEYE平台55
2.1.14媒体包以及包信息55
3接口定义57
3.1SDK初始化57
3.2报警状态获取58
3.3设备注册60
3.4实时监视61
3.5回放和下载64
3.6回放控制69
3.7云台控制70
3.8系统配置71
3.9日志管理73
3.10远程控制73
3.11语音对讲75
3.12录像模式设置77
3.13设置系统时间78
3.14获取设置运行状态信息78
3.15网络键盘79
3.16网络报警79
3.17报警中心80
3.18磁盘管理80
3.19抓图81
3.20透明232,48582
3.21获取DDNS信息83
3.22支持强迫I帧83
3.23设置连接设备超时时间和尝试次数84
4示例功能实现85
1.简介
1.1概述
欢迎使用我公司网络SDK编程手册，网络SDK是软件开发商在开发我司网络硬盘录像机监控联网应用时的开发套件。
本文档详细描述了开发包中各个函数实现的功能、接口及其函数之间的调用关系和示例实现。
开发包所包括的文件有：
网络库
NetSDK
头文件
NetSDK.lib
Lib文件
NetSDK.dll
接口库
辅助库
DllDeinterlace.dll
解码辅助库
H264Play.dll
hi_h264dec_w.dll
1.2适用性
⏹支持网络硬盘录像机的监视、回放、报警、远程配置、日志查询等功能。
⏹支持TCP传输模式，设备端同时支持10个TCP连接。
⏹可通过SDK回调接口开发流媒体转发、回放、报警等服务器程序。
⏹客户端可以采用多种分辨率进行图像预览，支持的分辨率包括：
QCIF、CIF、2CIF、、HalfD1、D1，VGA（640×
480）等
⏹SDK在录像回放/下载时,同一登陆ID对于同一通道在同一时间回放和下载不可同时进行操作。
⏹SDK性能与设备的运行情况和运行客户端的计算机CPU能力密切相关,理论上能同时支持2000个用户注册;
同时支持2000路网络预览和网络回放;
同时支持2000路报警上传;
在图象显示方面同时支持300路。
设计原则
1.3编程说明
⏹初始化和清除
1、使用网络客户端软件包首先调用H264_DVR_Init（）对系统进行初始化，应用程序退出时调用H264_DVR_Cleanup（）释放所有占用的资源。
2、大多数函数调用均应该在H264_DVR_Init（）之后，H264_DVR_Cleanup（）之前，而H264_DVR_GetLastError可以在任何时候调用等等。
⏹用户登录和注销
用户在访问前端设备之前必须通过调用H264_DVR_Login（）登录到前端设备上，
如果登陆的软件是特殊的（不是web）可以调用H264_DVR_LoginEx（）指定登陆的软件类型,登录成功后返回一个全局唯一的句柄。
此句柄就像一个会话通道，之后该用户可通过此句柄访问前端设备。
退出该会话时则通过H264_DVR_Logout（）函数在前端设备上注销此句柄以终止该会话通道的使用。
建立连接与登录是同步的。
⏹心跳功能
在本开发包中提供自动心跳功能（20秒一次心跳）当设备断开能及时回调给客户端。
⏹同步与异步
异步通过设置回调函数的方式实现，网络数据通过回调函数传达到应用程序,有些异步在设置后返回请求句柄，结束请求时将请求句柄提供给SDK以注销相关资源。
⏹回调函数
一般都有dwUser参数,由用户自定义需要的数据,一般用来传入类对象指针,方便回调处理在类中实现,回调应用都可以采取这种方式。
1.4典型调用顺序
A.初始化
SDK初始化H264_DVR_Init（）
B.SDK功能信息获取
设置报警消息回调H264_DVR_SetDVRMessCallBack（）
C.登录连接设备
登入设备H264_DVR_Login（）
H264_DVR_LoginEx（）
报警消息订阅H264_DVR_SetupAlarmChan（）
D.设备功能操作与信息获取
系统参数配置H264_DVR_GetDevConfig（）
H264_DVR_SetDevConfig（）
查询日志H264_DVR_FindDVRLog（）
云台控制H264_DVR_PTZControl（）
H264_DVR_PTZControlEx（）
E.实时监视通道
打开监视通道H264_DVR_RealPlay（）
H264_DVR_StopRealPlay（）
监视数据回调保存H264_DVR_SetRealDataCallBack（）
F.回放/下载通道
查询录像H264_DVR_FindFile（）
H264_DVR_FindFileByTime（）
回放及控制H264_DVR_PlayBackByName
H264_DVR_PlayBackByName_V2（）
H264_DVR_PlayBackByTime（）
H264_DVR_PlayBackByTimeEx（）
H264_DVR_PlayBackControl（）
H264_DVR_StopPlayBack（）
下载H264_DVR_GetFileByName（）
H264_DVR_GetFileByTime（）
H264_DVR_GetDownloadPos（）
H264_DVR_StopGetFile（）
G.远程控制
远程升级H264_DVR_Upgrade（）
H264_DVR_GetUpgradeState（）
H264_DVR_CloseUpgradeHandle（）
重启/清除日志H264_DVR_ControlDVR（）
H.注销断开设备
停止报警消息订阅H264_DVR_CloseAlarmChan（）
断开连接H264_DVR_Logout（）
I.释放SDK资源
SDK退出H264_DVR_Cleanup（）
2数据结构定义
2.1客户端数据结构
//云台操作类型
typedefenumPTZ_ControlType
{
TILT_UP=0,//上
TILT_DOWN,//下
PAN_LEFT,//左
PAN_RIGHT,//右
PAN_LEFTTOP,//左上
PAN_LEFTDOWN,//左下
PAN_RIGTHTOP,//右上
PAN_RIGTHDOWN,//右下
ZOOM_IN,//变倍大
ZOOM_OUT,//变倍小
FOCUS_FAR,//焦点后调
FOCUS_NEAR,//焦点前调
IRIS_OPEN,//光圈扩大
IRIS_CLOSE,//光圈缩小
EXTPTZ_OPERATION_ALARM,///<
报警功能
EXTPTZ_LAMP_ON,///<
灯光开
EXTPTZ_LAMP_OFF,//灯光关
EXTPTZ_POINT_SET_CONTROL,//设置预置点
EXTPTZ_POINT_DEL_CONTROL,//清除预置点
EXTPTZ_POINT_MOVE_CONTROL,//转预置点
EXTPTZ_STARTPANCRUISE,//开
升级会员 