2018海康网络摄像头最新android sdk开发包（文档+demo源码）

【实例简介】Android_V5.3.3.2_build20171121_CN.zip

海康网络摄像头 硬盘录像机2018年 最新安卓sdk开发包 包括开发文档 demo 非常详细
【实例截图】

Android播放库编程指南V7.3.4.x.pdf  截图如下：

设备网络SDK编程指南（Android）.pdf 截图如下：

【核心代码】

Android播放库编程指南V7.3.4.x.pdf 目录：

目 录
目 录...............................................................................................................................................II
1. 产品简介 ...................................................................................................................................1
2. SDK 版本更新............................................................................................................................2
VERSION 7.3.4.X(2017.03) ......................................................................................................................2
3. 错误代码及说明........................................................................................................................4
3.1 基本错误码说明............................................................................................................................4
3.2 鱼眼错误码....................................................................................................................................5
4. 函数调用顺序............................................................................................................................6
4.1 文件模式........................................................................................................................................6
4.2 流模式............................................................................................................................................7
4.3 同步回放模块................................................................................................................................8
4.4 鱼眼模块........................................................................................................................................8
4.5 硬解码模块..................................................................................................................................10
4.6 预录模块......................................................................................................................................11
4.7 私有信息功能模块......................................................................................................................11
5. 函数说明 .................................................................................................................................13
5.1 系统操作及错误号获取..............................................................................................................13
5.1.1 获取播放库版本号 getSdkVersion .......................................................................................13
5.1.2 获取错误码 getLastError......................................................................................................13
5.1.3 获取播放端口 getPort..........................................................................................................13
5.1.4 释放播放端口 freePort.........................................................................................................13
5.2 文件操作......................................................................................................................................15
5.2.1 打开数据文件 openFile ........................................................................................................15
5.2.2 关闭数据文件 closeFile ........................................................................................................15
5.3 流操作..........................................................................................................................................16
5.3.1 设置流播放模式 setStreamOpenMode ...............................................................................16
5.3.2 打开流 openStream..............................................................................................................16
5.3.3 关闭流 closeStream..............................................................................................................17
5.3.4 输入流数据 inputData .........................................................................................................17
5.4 播放控制......................................................................................................................................18
5.4.1 开启播放 play.......................................................................................................................18
5.4.2 开启播放 playEx ...................................................................................................................18
5.4.3 停止播放 stop.......................................................................................................................18
5.4.4 暂停数据播放 pause ............................................................................................................18
5.4.5 快速播放 fast........................................................................................................................19
5.4.6 慢速播放 slow ......................................................................................................................19
播放库 SDK 编程指南
III
5.4.7 以独占方式播放音频 playSound.........................................................................................19
5.4.8 关闭音频 stopSound.............................................................................................................20
5.4.9 以共享方式播放音频 playSoundShare................................................................................20
5.4.10 停止共享音频播放 stopSoundShare..................................................................................20
5.4.11 算法调节音量 adjustWaveAudio .......................................................................................21
5.4.12 设置文件当前播放位置（百分比）setPlayPos................................................................21
5.4.13 获取文件当前播放位置（百分比）getPlayPos ...............................................................21
5.4.14 设置文件当前播放时间（毫秒）setPlayedTimeEx..........................................................22
5.4.15 获取文件当前播放时间（毫秒）getPlayedTimeEx .........................................................22
5.4.16 获取文件当前播放时间 getPlayedTime............................................................................22
5.4.17 设置文件当前播放帧号 setCurrentFrameNum.................................................................22
5.4.18 获取文件当前播放帧号 getCurrentFrameNum.................................................................23
5.4.19 设置音视频同步 syncToAudio............................................................................................23
5.4.20 设置窗口透明度 setWindowTransparency ........................................................................23
5.4.21 设置变分辨率回调函数 setEcnTypeChgCB........................................................................23
5.4.22 刷新当前显示窗口 refreshPlay..........................................................................................24
5.4.23 获取文件在线定位偏移量 getPlayTimeOffset ..................................................................24
5.5 获取播放或解码信息..................................................................................................................26
5.5.1 设置垂直翻转 verticalFlip ....................................................................................................26
5.5.2 获取全局时间 getSystemTime .............................................................................................26
5.5.3 获取文件总帧数 getFileTotalFrames ...................................................................................26
5.5.4 获取当前帧率 getCurrentFrameRate...................................................................................27
5.5.5 获取已解码的视频帧数 getPlayedFrames..........................................................................27
5.5.6 获取原始图像大小 getPictureSize .......................................................................................27
5.6 解码操作及控制..........................................................................................................................28
5.6.1 设置视频帧解码类型 setDecodeFrameType .......................................................................28
5.6.2 设置跳 I 帧解码 setIFrameDecInterval ................................................................................28
5.6.3 设置解码回调函数 setDecodeCB.........................................................................................28
5.6.4 设置全局时间解码回调函数 setDecodeCBEx .....................................................................29
5.6.5 文件结束回调 setFileEndCB .................................................................................................31
5.6.6 解码密钥 setSecretKey .........................................................................................................31
5.7 显示操作......................................................................................................................................32
5.7.1 设置或增加显示区域 setDisplayRegion ..............................................................................32
5.7.2 设置或增加显示区域 setDisplayRegionEx...........................................................................33
5.7.3 设置或销毁显示区域 setVideoWindow ..............................................................................34
5.7.4 设置或销毁显示区域 setVideoWindowEx...........................................................................34
5.7.5 设置同步回放组 setSycGroup..............................................................................................35
5.8 缓冲区操作..................................................................................................................................36
解码前源缓冲区............................................................................................................................36
5.8.1 获取源缓冲区剩余数据大小 getSourceBufferRemain........................................................36
5.8.2 清空所有缓冲区的剩余数据 resetSourceBuffer .................................................................36
5.8.3 清空指定缓冲区的数据 resetBuffer....................................................................................36
解码后播放缓冲区........................................................................................................................37
5.8.4 设置显示缓冲区缓冲帧数 setDisplayBuf............................................................................37
播放库 SDK 编程指南
IV
5.8.5 获取显示缓冲区缓冲帧数 getDisplayBuf ...........................................................................37
源、播放缓冲区............................................................................................................................37
5.8.6 获取指定缓冲区的大小 getBufferValue..............................................................................37
5.9 索引..............................................................................................................................................39
5.9.1 索引回调 setFileRefCB..........................................................................................................39
5.10 抓图............................................................................................................................................40
5.10.1 显示回调 setDisplayCB.......................................................................................................40
5.10.2 带全局时间显示回调 setDisplayCBEx ...............................................................................40
5.10.3 截取当前画面 BMP 图片 getBMP .....................................................................................41
5.10.4 私有信息 BMP 抓图 getBmpEx..........................................................................................42
5.10.5 截取当前画面 JPEG 图片 getJPEG.....................................................................................42
5.11 硬解码........................................................................................................................................44
5.11.1 设置硬解码优先 setHardDecode .......................................................................................44
5.11.2 设置最大硬解码路数 setMaxHardDecodePort .................................................................45
5.11.3 获取当前解码类型 getDecoderType..................................................................................45
5.11.4 切换到软解 switchToSoft ...................................................................................................45
5.11.5 切换到硬解 switchToHard..................................................................................................46
5.12 预录像功能................................................................................................................................48
5.12.1 设置预录像数据回调 setPreRecordCallBack .....................................................................48
5.12.2 设置预录像数据回调 setPreRecordCallBackEx .................................................................49
5.12.3 设置预录像开关 setPreRecordFlag....................................................................................50
5.13 鱼眼功能....................................................................................................................................52
5.13.1 广角图像矫正 setImageCorrection ....................................................................................52
5.13.2 设置鱼眼矫正类型 setFECDisplayEffect ............................................................................52
5.13.3 获取鱼眼矫正参数 getFECDisplayParam ..........................................................................53
5.13.4 设置鱼眼矫正参数 setFECDisplayParam...........................................................................53
5.13.5 开启鱼眼功能 enableFEC ...................................................................................................54
5.13.6 关闭鱼眼功能 disableFEC ..................................................................................................54
5.13.7 获取鱼眼矫正处理子端口 getPortFEC ..............................................................................54
5.13.8 删除鱼眼矫正处理子端口 delPortFEC ..............................................................................56
5.13.9 设置鱼眼矫正参数 setParamFEC.......................................................................................56
5.13.10 获取鱼眼矫正参数 getParamFEC ....................................................................................58
5.13.11 设置显示窗口 setWnd .....................................................................................................59
5.13.12 设置显示窗口 setWndEx..................................................................................................60
5.13.13 获取当前选择鱼眼子端口 getCurrentPTZPort................................................................61
5.13.14 设置当前选择鱼眼子端口 setCurrentPTZPort ................................................................61
5.13.15 画矩形或者不规则框选择 setPTZoutLineShowMode .....................................................61
5.13.16 获取当前子端口号对应的当前 PTZ 坐标值 setPTZ2Window ........................................62
5.13.17 获取当前子端口号对应的当前 PTZ 坐标值 setFECDisplayPTZ ......................................63
5.13.18 设置鱼眼 3D 旋转（此设置只针对 3D 鱼眼起作用）setFish3DRotate ........................63
5.13.19 获取鱼眼抓图所需缓存大小 getFishCapPicSize .............................................................65
5.13.20 鱼眼抓图 getFishCapPic ...................................................................................................66
5.14 私有数据....................................................................................................................................67
5.14.1 显示私有数据 renderPrivateData......................................................................................67
播放库 SDK 编程指南
V
5.14.2 显示私有数据 renderPrivateDataEx ..................................................................................67
5.14.5 私有数据回调 setAdditionalCallback.................................................................................69
5.14.6 私有数据回调 setIVSDrawFunCallback..............................................................................69
5.14.7 设置字体库路径 setOverlayPriInfoFlag .............................................................................70
5.15 倒放............................................................................................................................................71
5.15.1 倒放 reversePlay .................................................................................................................71
6. 见问题排查 .............................................................................................................................72
关于流模式接口................................................................................................................................72
Question 1 送入到播放库 openStream 接口报错..................................................................72
流模式预览........................................................................................................................................72
Question 2 实时流预览有卡顿................................................................................................72
Question 3 实时流预览不显示图像........................................................................................72
Question 4 实时流预览延时....................................................................................................73
流模式播放........................................................................................................................................73
Question 5 流模式下快放........................................................................................................73
Question 6 实时流预览显示第一帧画面比较慢....................................................................74
关于加密码流....................................................................................................................................74
Question 7 加密码流无法正常播放........................................................................................74
关于抓图............................................................................................................................................74
Question 8 如何将捕获的图片保存在内存中以供后续处理................................................74
关于播放声音问题............................................................................................................................74
Question 9 音频播放卡顿，视频播放流畅............................................................................74
Question 10 复合流文件，播放音频时画面卡顿，不播放音频。则画面正常..................74
Question 11 播放文件，无法听到声音....................................................................................74
关于文件模式问题............................................................................................................................75
Question 12 实时流播放正常，文件播放有快放现象..........................................................75
Question 13 文件打开失败......................................................................................................75
Question 14 文件模式如何定位..............................................................................................75
关于解码回调问题............................................................................................................................75
Question 15 如何获取多路数据流解码后的数据..................................................................75
Question 16 实时流数据用解码回调有丢帧现象..................................................................76
Question 17 有些码流解码回调函数中获取的每帧视频高度只有显示的一半..................76
Question 18 如何自己实现显示..............................................................................................76
Question 19 解码回调和显示回调函数的区别......................................................................76
Question 20 解码回调函数中获取连续三帧音频数据时标信息重复..................................76
关于同步回放问题............................................................................................................................76
Question 21 如何实现多个文件的同步回放..........................................................................76
关于 ANDROID 版本的播放库问题 .....................................................................................................77
Question 22 Android 版本的播放库不能正常预览...............................................................77

设备网络SDK编程指南（Android）.pdf 目录：

目 录
声 明............................................................................................................................................................... I
目 录.............................................................................................................................................................. II
1 SDK 简介 ................................................................................................................................................. 10
1.1 SDK 概述 .................................................................................................................................... 10
1.2 适用范围.................................................................................................................................... 11
2 SDK 版本更新.......................................................................................................................................... 13
3 函数说明................................................................................................................................................. 15
3.1 SDK 初始化................................................................................................................................. 15
3.1.1 初始化 SDK NET_DVR_Init................................................................................................. 15
3.1.2 释放 SDK 资源 NET_DVR_Cleanup .................................................................................... 15
3.2 SDK 本地功能............................................................................................................................. 15
本地参数配置.................................................................................................................................. 15
3.2.1 获取 SDK 本地参数 NET_DVR_GetSDKLocalConfig ............................................................ 15
3.2.2 设置 SDK 本地参数 NET_DVR_SetSDKLocalConfig ............................................................. 16
连接和接收超时时间及重连设置.................................................................................................... 16
3.2.3 设置网络连接超时时间 NET_DVR_SetConnectTime......................................................... 16
3.2.4 设置重连功能 NET_DVR_SetReconnect ............................................................................ 16
3.2.5 设置接收超时时间 NET_DVR_SetRecvTimeOut ................................................................ 16
SDK 版本信息和日志 ....................................................................................................................... 17
3.2.6 获取 SDK 版本信息 NET_DVR_GetSDKVersion................................................................... 17
3.2.7 获取 SDK 的版本号和 build 信息 NET_DVR_GetSDKBuildVersion...................................... 17
3.2.8 启用写日志文件 NET_DVR_SetLogToFile .......................................................................... 17
异常消息回调.................................................................................................................................. 18
3.2.9 注册接收异常、重连消息回调函数 NET_DVR_SetExceptionCallBack ............................... 18
获取错误信息.................................................................................................................................. 19
3.2.10 返回最后操作的错误码 NET_DVR_GetLastError............................................................... 19
3.2.11 返回最后操作的错误信息 NET_DVR_GetErrorMsg ........................................................... 19
3.3 用户注册.................................................................................................................................... 19
3.3.1 设备的动态 IP 和端口解析 NET_DVR_GetAddrInfoByServer ............................................. 19
3.3.2 通过解析服务器，获取设备的动态 IP 地址和端口号 NET_DVR_GetDVRIPByResolveSvr_EX
......................................................................................................................................... 20
3.3.3 激活设备 NET_DVR_ActivateDevice .................................................................................. 20
3.3.4 用户注册设备 NET_DVR_Login_V30 ................................................................................. 21
3.3.5 用户注销 NET_DVR_Logout_V30 ...................................................................................... 21
3.4 获取设备能力集 ........................................................................................................................ 21
3.4.1 获取设备能力集 NET_DVR_GetXMLAbility ....................................................................... 21
3.5 实时预览.................................................................................................................................... 22
强制 I 帧 22
3.5.1 主码流动态产生一个关键帧 NET_DVR_MakeKeyFrame ................................................... 22
3.5.2 子码流动态产生一个关键帧 NET_DVR_MakeKeyFrameSub.............................................. 22
III
设备网络 SDK 编程指南
实时预览23
3.5.3 实时预览 NET_DVR_RealPlay_V40 .................................................................................... 23
3.5.4 停止预览 NET_DVR_StopRealPlay ..................................................................................... 23
3.5.5 获取预览时用来解码和显示的播放器句柄 NET_DVR_GetRealPlayerIndex....................... 23
播放声音控制.................................................................................................................................. 24
3.5.6 播放声音 NET_DVR_OpenSound....................................................................................... 24
3.5.7 关闭声音 NET_DVR_CloseSound....................................................................................... 24
显示参数配置.................................................................................................................................. 24
3.5.8 获取预览视频显示参数 NET_DVR_ClientGetVideoEffect .................................................. 24
3.5.9 设置预览视频显示参数 NET_DVR_ClientSetVideoEffect................................................... 25
零通道预览...................................................................................................................................... 25
3.5.10 开始零通道预览 NET_DVR_ZeroStartPlay ......................................................................... 25
3.5.11 停止零通道预览 NET_DVR_ZeroStopPlay.......................................................................... 26
预览抓图26
3.5.12 设置抓图模式 NET_DVR_SetCapturePictureMode............................................................. 26
3.5.13 预览时抓图并保存成图片文件 NET_DVR_CapturePictureBlock ........................................ 26
3.5.14 单帧数据捕获并保存成图片 NET_DVR_CapturePicture.................................................... 27
客户端录像...................................................................................................................................... 27
3.5.15 捕获预览数据并保存到指定文件中 NET_DVR_SaveRealData........................................... 27
3.5.16 捕获预览数据并保存到指定文件中 NET_DVR_SaveRealData_V30 ................................... 27
3.5.17 停止数据捕获 NET_DVR_StopSaveRealData...................................................................... 28
实时数据回调.................................................................................................................................. 28
3.5.18 实时预览 NET_DVR_SetRealDataCallBack.......................................................................... 28
3.5.19 捕获实时码流数据（标准码流）NET_DVR_RealPlay_V40................................................ 29
3.6 设备抓图.................................................................................................................................... 29
3.6.1 单帧数据捕获并保存成 JPEG 图片 NET_DVR_CaptureJPEGPicture ................................... 29
3.6.2 单帧数据捕获并保存成 JPEG 存放在指定的内存空间中
NET_DVR_CaptureJPEGPicture_NEW ................................................................................. 30
3.7 布防、撤防................................................................................................................................ 30
设置报警等信息上传的回调函数.................................................................................................... 30
3.7.1 注册回调函数，接收设备报警消息 NET_DVR_SetDVRMessageCallBack_V30 .................. 30
布防撤防32
3.7.2 建立报警上传通道，获取报警等信息 NET_DVR_SetupAlarmChan_V41 .......................... 32
3.7.3 撤销报警上传通道 NET_DVR_CloseAlarmChan_V30 ......................................................... 32
3.8 远程参数配置 ............................................................................................................................ 32
通用参数配置.................................................................................................................................. 32
3.8.1 获取设备配置信息 NET_DVR_GetDVRConfig .................................................................... 32
3.8.2 设置设备配置信息 NET_DVR_SetDVRConfig..................................................................... 34
3.8.3 批量获取配置信息 NET_DVR_GetDeviceConfig ................................................................ 34
3.8.4 批量设置配置信息 NET_DVR_SetDeviceConfig ................................................................. 35
报警输出配置.................................................................................................................................. 36
3.8.5 获取设备报警输出 NET_DVR_GetAlarmOut_V30.............................................................. 36
3.8.6 设置设备报警输出 NET_DVR_SetAlarmOut ...................................................................... 36
设备支持的云台协议....................................................................................................................... 37
IV
设备网络 SDK 编程指南
3.8.7 获取设备支持的云台协议 NET_DVR_GetPTZProtocol....................................................... 37
3.9 录像文件回放、下载、锁定及备份 .......................................................................................... 37
刷新录像索引.................................................................................................................................. 37
3.9.1 即时刷新录像索引 NET_DVR_UpdateRecordIndex............................................................ 37
录像文件的查找.............................................................................................................................. 37
3.9.2 根据文件类型、时间查找设备录像文件 NET_DVR_FindFile_V30 .................................... 37
3.9.3 逐个获取查找到的文件信息 NET_DVR_FindNextFile_V30................................................ 38
3.9.4 关闭文件查找，释放资源 NET_DVR_FindClose_V30 ....................................................... 38
按事件查找录像.............................................................................................................................. 39
3.9.5 按事件查找录像 NET_DVR_FindFileByEvent..................................................................... 39
3.9.6 逐个获取查找到的文件信息 NET_DVR_FindNextEvent .................................................... 39
3.9.7 关闭文件查找，释放资源 NET_DVR_FindClose_V30 ....................................................... 40
回放录像文件.................................................................................................................................. 40
3.9.8 注册回调函数，捕获录像数据 NET_DVR_SetPlayDataCallBack ........................................ 40
3.9.9 按文件名回放录像文件 NET_DVR_PlayBackByName ....................................................... 40
3.9.10 按时间回放录像文件 NET_DVR_PlayBackByTime ............................................................ 41
3.9.11 按时间回放录像文件 NET_DVR_PlayBackByTime_V40 .................................................... 41
3.9.12 控制录像回放的状态 NET_DVR_PlayBackControl_V40..................................................... 42
3.9.13 获取回放取流进度 NET_DVR_GetPlayBackPos.................................................................. 42
3.9.14 停止回放录像文件 NET_DVR_StopPlayBack..................................................................... 43
3.9.15 获取回放时用来解码显示的播放库句柄 NET_DVR_GetPlayBackPlayerIndex ................... 43
3.9.16 录像回放时抓图 NET_DVR_PlayBackCaptureFile .............................................................. 43
3.9.17 按文件名倒放录像文件 NET_DVR_PlayBackReverseByName ............................................ 43
3.9.18 按时间倒放录像文件 NET_DVR_PlayBackReverseByTime_V40 ......................................... 44
下载录像文件.................................................................................................................................. 44
3.9.19 按文件名下载录像文件 NET_DVR_GetFileByName ......................................................... 44
3.9.20 按时间下载录像文件 NET_DVR_GetFileByTime............................................................... 44
3.9.21 控制录像下载的状态 NET_DVR_PlayBackControl_V40...................................................... 45
3.9.22 获取当前下载录像文件的进度 NET_DVR_GetDownloadPos............................................. 45
3.9.23 停止下载录像文件 NET_DVR_StopGetFile ....................................................................... 46
3.10 云台控制.................................................................................................................................... 46
云台控制操作.................................................................................................................................. 46
3.10.1 云台控制操作（需先启动预览）NET_DVR_PTZControl ................................................... 46
3.10.2 云台控制操作（不用启动预览）NET_DVR_PTZControl_Other......................................... 47
3.10.3 带速度的云台控制操作（需先启动预览）NET_DVR_PTZControlWithSpeed ................... 47
3.10.4 带速度的云台控制操作（不用启动预览）NET_DVR_PTZControlWithSpeed_Other......... 48
云台预置点操作.............................................................................................................................. 48
3.10.5 云台预置点操作，需先启动预览 NET_DVR_PTZPreset .................................................... 48
3.10.6 云台预置点操作 NET_DVR_PTZPreset_Other.................................................................... 49
云台巡航操作.................................................................................................................................. 49
3.10.7 云台巡航操作，需先启动预览 NET_DVR_PTZPCruise ...................................................... 49
3.10.8 云台巡航操作 NET_DVR_PTZPCruise_Other...................................................................... 50
云台轨迹操作.................................................................................................................................. 50
3.10.9 云台轨迹操作，需先启动预览 NET_DVR_PTZTrack.......................................................... 50
V
设备网络 SDK 编程指南
3.10.10 云台轨迹操作 NET_DVR_PTZTrack_Other......................................................................... 51
云台区域缩放控制 .......................................................................................................................... 51
3.10.11 云台图象区域选择放大或缩小 NET_DVR_PTZSelZoomIn ................................................. 51
3.10.12 云台图像区域选择放大或缩小 NET_DVR_PTZSelZoomIn_Ex ............................................ 52
3.11 语音转发.................................................................................................................................... 52
3.11.1 获取当前生效的音频对讲音频压缩参数 NET_DVR_GetCurrentAudioCompress............... 52
3.11.2 启动语音转发，获取编码后的音频数据 NET_DVR_StartVoiceCom_MR_V30 .................. 52
3.11.3 转发语音数据 NET_DVR_VoiceComSendData ................................................................... 53
3.11.4 停止语音转发 NET_DVR_StopVoiceCom........................................................................... 53
3.12 数据透传.................................................................................................................................... 53
透明通道53
3.12.1 建立透明通道 NET_DVR_SerialStart_V40.......................................................................... 53
3.12.2 通过透明通道向设备串口发送数据 NET_DVR_SerialSend ............................................... 54
3.12.3 断开透明通道 NET_DVR_SerialStop.................................................................................. 54
向串口发送数据.............................................................................................................................. 55
3.12.4 直接向串口发送数据，不需要建立透明通道 NET_DVR_SendToSerialPort....................... 55
3.12.5 直接向 232 串口发送数据，不需要建立透明通道 NET_DVR_SendTo232Port.................. 55
3.13 设备手动录像 ............................................................................................................................ 55
3.13.1 远程手动启动设备录像 NET_DVR_StartDVRRecord.......................................................... 55
3.13.2 远程手动停止设备录像 NET_DVR_StopDVRRecord .......................................................... 56
3.14 远程面板控制 ............................................................................................................................ 56
3.14.1 远程控制面板上的按键 NET_DVR_ClickKey...................................................................... 56
3.15 硬盘管理.................................................................................................................................... 57
3.15.1 远程格式化设备硬盘 NET_DVR_FormatDisk..................................................................... 57
3.15.2 获取格式化硬盘的进度 NET_DVR_GetFormatProgress..................................................... 57
3.15.3 关闭格式化硬盘句柄，释放资源 NET_DVR_CloseFormatHandle ..................................... 57
3.16 设备维护管理 ............................................................................................................................ 58
设备工作状态.................................................................................................................................. 58
3.16.1 获取设备的工作状态 NET_DVR_GetDVRWorkState_V30 .................................................. 58
UPNP 端口映射状态 ........................................................................................................................ 58
3.16.2 获取 UPNP 端口映射状态 NET_DVR_GetUpnpNatState .................................................... 58
远程升级58
3.16.3 设置远程升级时网络环境 NET_DVR_SetNetworkEnvironment......................................... 58
3.16.4 远程升级 NET_DVR_Upgrade ............................................................................................ 59
3.16.5 获取远程升级的进度 NET_DVR_GetUpgradeProgress....................................................... 59
3.16.6 获取远程升级的状态 NET_DVR_GetUpgradeState............................................................ 59
3.16.7 获取远程升级的阶段信息 NET_DVR_GetUpgradeStep ..................................................... 59
3.16.8 关闭远程升级句柄，释放资源 NET_DVR_CloseUpgradeHandle ....................................... 60
远程重启60
3.16.9 重启设备 NET_DVR_RebootDVR ....................................................................................... 60
3.17 人脸比对功能 ............................................................................................................................ 60
人脸比对功能.................................................................................................................................. 60
3.17.1 上传文件 NET_DVR_UploadFile_V40................................................................................. 61
3.17.2 发送数据 NET_DVR_UploadSend ...................................................................................... 61
VI
设备网络 SDK 编程指南
3.17.3 获取文件上传的进度和状态 NET_DVR_GetUploadState................................................... 62
3.17.4 获取当前上传的结果信息 NET_DVR_GetUploadResult..................................................... 62
3.17.5 停止文件上传 NET_DVR_UploadClose .............................................................................. 63
图片查找63
3.17.6 查找图片 NET_DVR_FindPicture ....................................................................................... 63
3.17.7 逐个获取查找到的图片信息 NET_DVR_FindNextPicture_V40 .......................................... 64
3.17.8 结束查找 NET_DVR_CloseFindPicture ............................................................................... 64
4 错误代码及说明 ..................................................................................................................................... 65
4.1 网络通讯库错误码..................................................................................................................... 65
4.2 RTSP 通讯库错误码.................................................................................................................... 70
4.3 软解码库错误码 ........................................................................................................................ 71
5 结构体说明............................................................................................................................................. 72
5.1 EAP_PEAP:EAP_PEAP 认证参数................................................................................................... 72
5.2 EAP_TLS:EAP_TLS 认证参数........................................................................................................ 72
5.3 EAP_TTLS:EAP_TTLS 认证参数 .................................................................................................... 73
5.4 NET_DVR_ACTIVATECFG:激活参数.............................................................................................. 73
5.5 NET_DVR_ALARMER:报警设备信息............................................................................................ 74
5.6 NET_DVR_ALARMINCFG_V30:报警输入参数 .............................................................................. 75
5.7 NET_DVR_ALARMINFO:设备报警信息 ........................................................................................ 77
5.8 NET_DVR_ALARMINFO_V30:上传的报警信息 V30...................................................................... 78
5.9 NET_DVR_ALARMINFO_V40:上传的报警信息 V40...................................................................... 79
5.10 NET_DVR_ALARMOUTCFG_V30:报警输出参数 ........................................................................... 79
5.11 NET_DVR_ALARMOUTSTATUS_V30:报警输出状态...................................................................... 80
5.12 NET_DVR_ALRAM_FIXED_HEADER:报警设备信息....................................................................... 80
5.13 NET_DVR_AP_INFO:单个无线资源参数 ...................................................................................... 81
5.14 NET_DVR_AP_INFO_LIST:无线网络资源列表 .............................................................................. 82
5.15 NET_DVR_AREAINFOCFG:籍贯参数结构体.................................................................................. 82
5.16 NET_DVR_CHANNELSTATE_V30:通道状态 ................................................................................... 85
5.17 NET_DVR_CLIENTINFO:预览参数 ................................................................................................ 86
5.18 NET_DVR_COMPRESSION_AUDIO:语音对讲音频参数................................................................. 87
5.19 NET_DVR_COMPRESSION_INFO_V30:码流压缩参数................................................................... 87
5.20 NET_DVR_COMPRESSIONCFG_V30:通道压缩参数 ...................................................................... 89
5.21 NET_DVR_DDNSPARA_V30:DDNS 配置参数 ................................................................................ 90
5.22 NET_DVR_DECODERCFG_V30:云台解码器参数........................................................................... 91
5.23 NET_DVR_DEVICECFG_V40:设备参数.......................................................................................... 91
5.24 NET_DVR_DEVICEINFO_V30:设备信息 ........................................................................................ 92
5.25 NET_DVR_DISKSTATE:硬盘状态................................................................................................... 98
5.26 NET_DVR_DIGITAL_CHANNEL_STATE:数字通道状态.................................................................... 99
5.27 NET_DVR_ETHERNET_V30:以太网参数..................................................................................... 100
5.28 NET_DVR_FACE_DETECTION: 人脸侦测报警信息结构体.......................................................... 100
5.29 NET_DVR_FACELIB_COND: 导入人脸数据(人脸图片 图片附件信息)到人脸库的条件 ............ 102
5.30 NET_DVR_FILECOND:录像文件查找条件 .................................................................................. 102
5.31 NET_DVR_FINDDATA_V30:录像文件查找结果 .......................................................................... 103
5.32 NET_DVR_FIND_PICTURE_PARAM: 图片查找条件结构体 ........................................................ 104
VII
设备网络 SDK 编程指南
5.33 NET_DVR_HANDLEEXCEPTION_V30:异常参数........................................................................... 108
5.34 NET_DVR_HIDEALARM_V30:遮挡报警参数............................................................................... 108
5.35 NET_DVR_IPADDR:IP 地址......................................................................................................... 109
5.36 NET_DVR_IPALARMOUTCFG:IP 报警输出配置 .......................................................................... 110
5.37 NET_DVR_IPALARMOUTINFO:IP 报警输出信息......................................................................... 110
5.38 NET_DVR_IPCHANINFO:IP 通道参数 ......................................................................................... 111
5.39 NET_DVR_IPDEVINFO_V31:IP 设备信息 .................................................................................... 111
5.40 NET_DVR_IPPARACFG_V40:IP 接入参数.................................................................................... 112
5.41 NET_DVR_JPEGPARA:JPEG 图像参数......................................................................................... 113
5.42 NET_DVR_MOTION_V30:移动侦测参数.................................................................................... 114
5.43 NET_DVR_MULTI_STREAM_COMPRESSIONCFG:多码流压缩参数配置....................................... 115
5.44 NET_DVR_MULTI_STREAM_COMPRESSIONCFG_COND:多码流压缩参数配置条件 .................... 115
5.45 NET_DVR_NETCFG_V30:网络参数............................................................................................. 116
5.46 NET_DVR_NTPPARA:NTP 参数................................................................................................... 117
5.47 NET_DVR_PLAYCOND: 回放或者下载信息结构体.................................................................... 118
5.48 NET_DVR_PICCFG_V30:图像参数.............................................................................................. 118
5.49 NET_DVR_FIND_PICTURE_V40: 图片查找结果信息结构体 ...................................................... 120
5.50 NET_DVR_PLATE_INFO:车牌信息.............................................................................................. 122
5.51 NET_DVR_PLATE_RESULT:车辆识别结果 ................................................................................... 123
5.52 NET_DVR_POINT_FRAME:云台图像区域位置信息.................................................................... 126
5.53 NET_DVR_PPPOECFG:PPPoE 配置参数...................................................................................... 126
5.54 NET_DVR_PRESET_NAME:单个预置点名称............................................................................... 127
5.55 NET_DVR_PRESET_NAME_ARRAY:预置点名称参数................................................................... 127
5.56 NET_DVR_PREVIEWINFO:预览参数........................................................................................... 128
5.57 NET_DVR_PTZCFG:云台协议配置 ............................................................................................. 129
5.58 NET_DVR_PTZ_PROTOCOL:云台协议信息 ................................................................................. 129
5.59 NET_DVR_QUERY_COUNTRYID_COND:按国家编号查询服务器信息条件参数.......................... 129
5.60 NET_DVR_QUERY_COUNTRYID_RET:按国家编号查询结果........................................................ 130
5.61 NET_DVR_QUERY_DDNS_COND:HIDDNS 查询或诊断条件........................................................ 130
5.62 NET_DVR_QUERY_DDNS_RET:HIDDNS 查询结果....................................................................... 131
5.63 NET_DVR_CHECK_DDNS_RET:HIDDNS 诊断结果 ....................................................................... 131
5.64 NET_DVR_QUERY_IPSERVER_COND:IPServer 查询条件............................................................. 132
5.65 NET_DVR_QUERY_IPSERVER_RET:IPServer 查询结果................................................................. 132
5.66 NET_DVR_RECORDDAY:全体录像参数....................................................................................... 132
5.67 NET_DVR_RECORDSCHED:时间段录像参数 .............................................................................. 133
5.68 NET_DVR_RECORD_V30:录像参数............................................................................................ 133
5.69 NET_DVR_RESOLVE_DEVICEINFO:域名解析设备信息................................................................ 135
5.70 NET_DVR_SCHEDTIME:时间段参数........................................................................................... 135
5.71 NET_DVR_SDKLOCAL_CFG:SDK 本地参数.................................................................................. 136
5.72 NET_DVR_SEARCH_EVENT_PARAM:按事件搜索的条件参数..................................................... 136
5.73 NET_DVR_SEARCH_EVENT_RET:按事件搜索结果信息 .............................................................. 137
5.74 NET_DVR_SEND_PARAM_IN:数据发送输入参数结构体............................................................ 140
5.75 NET_DVR_SERIALSTART_V40:串口参数子类.............................................................................. 141
5.76 NET_DVR_SERIAL_COND:串口参数基类.................................................................................... 141
VIII
设备网络 SDK 编程指南
5.77 NET_DVR_SETUPALARM_PARAM:报警布防参数 ....................................................................... 141
5.78 NET_DVR_SHELTER:隐私遮盖参数 ............................................................................................ 143
5.79 NET_DVR_SHOWSTRINGINFO:单个字符参数 ............................................................................ 144
5.80 NET_DVR_SHOWSTRING_V30:字符叠加参数............................................................................ 144
5.81 NET_DVR_STREAM_INFO:流 ID 信息......................................................................................... 145
5.82 NET_DVR_SINGLE_DDNS: DDNS 服务器信息............................................................................. 145
5.83 NET_DVR_TIME:时间参数......................................................................................................... 146
5.84 NET_DVR_TIME_EX:时间参数................................................................................................... 147
5.85 NET_DVR_TIME_V30:时间参数................................................................................................. 147
5.86 NET_DVR_UPLOAD_FILE_RET:文件上传结果信息结构体 .......................................................... 148
5.87 NET_DVR_UPNP_NAT_STATE:Upnp 端口映射状态..................................................................... 149
5.88 NET_DVR_UPNP_PORT_STATE:Upnp 端口映射状态 .................................................................. 149
5.89 NET_DVR_USER_INFO_V30:单个用户信息参数 ........................................................................ 150
5.90 NET_DVR_USER_V30:用户参数................................................................................................. 152
5.91 NET_DVR_VEHICLE_INFO:车辆信息参数................................................................................... 152
5.92 NET_DVR_VICOLOR:时间段图像参数........................................................................................ 154
5.93 NET_DVR_VIDEOEFFECT:视频显示参数..................................................................................... 154
5.94 NET_DVR_VILOST_V30:视频丢失参数....................................................................................... 155
5.95 NET_DVR_VOD_PARA: 录像回放参数 ...................................................................................... 155
5.96 NET_DVR_WIFIETHERNET:无线网口参数 .................................................................................. 156
5.97 NET_DVR_WIFI_CFG:wifi 配置参数........................................................................................... 157
5.98 NET_DVR_WIFI_CONNECT_STATUS:wifi 连接状态 ..................................................................... 158
5.99 NET_DVR_WORKSTATE_V30:设备工作状态参数 ....................................................................... 158
5.100 NET_DVR_ZEROCHANCFG:零通道压缩参数 .............................................................................. 159
5.101 NET_IPC_AUX_ALARMCFG:辅助报警参数................................................................................. 160
5.102 NET_IPC_CALLHELP_ALARMCFG:呼救报警参数 ........................................................................ 160
5.103 NET_IPC_PIR_ALARMCFG:PIR 报警参数.................................................................................... 161
5.104 NET_IPC_SINGLE_AUX_ALARMCFG:单个辅助报警参数............................................................. 161
5.105 NET_IPC_SINGLE_WIRELESS_ALARMCFG:单个无线报警参数 .................................................... 162
5.106 NET_ITS_PICTURE_INFO:抓拍图片信息..................................................................................... 163
5.107 NET_ITS_PLATE_RESULT:车辆识别结果..................................................................................... 165
5.108 NET_VCA_ADV_REACH_HEIGHT:折线攀高参数 ......................................................................... 168
5.109 NET_VCA_ADV_TRAVERSE_PLANE:折线警戒面参数.................................................................. 169
5.110 NET_VCA_AREA:区域参数 ........................................................................................................ 170
5.111 NET_VCA_AUDIO_ABNORMAL:音频异常参数........................................................................... 170
5.112 NET_VCA_BLACKLIST_INFO:黑名单信息结构体 ........................................................................ 171
5.113 NET_VCA_BLACKLIST_INFO_ALARM:黑名单报警信息............................................................... 172
5.114 NET_VCA_COMBINED_RULE:组合规则参数 .............................................................................. 173
5.115 NET_VCA_DEV_INFO:前端设备信息.......................................................................................... 174
5.116 NET_VCA_EVENT_UNION:事件参数联合体............................................................................... 175
5.117 NET_VCA_FACESNAP_INFO_ALARM: 人脸抓拍信息................................................................. 177
5.118 NET_VCA_FACESNAP_RESULT:人脸抓拍结果............................................................................. 178
5.119 NET_VCA_FACESNAP_MATCH_ALARM:黑名单比对结果 ........................................................... 180
5.120 NET_VCA_FALL_DOWN:倒地参数 ............................................................................................. 181
IX
设备网络 SDK 编程指南
5.121 NET_VCA_GET_UP:起身参数 .................................................................................................... 182
5.122 NET_VCA_HIGH_DENSITY:人员聚集参数................................................................................... 183
5.123 NET_VCA_HUMAN_ATTRIBUTE:人员信息结构体 ...................................................................... 183
5.124 NET_VCA_HIGH_DENSITY_STATUS:人员聚集状态信息.............................................................. 184
5.125 NET_VCA_HUMAN_ENTER:人员进入参数................................................................................. 185
5.126 NET_VCA_HUMAN_FEATURE:人体属性参数结构体.................................................................. 185
5.127 NET_VCA_INTRUSION:区域入侵参数........................................................................................ 187
5.128 NET_VCA_LEAVE_POSITION:离岗事件参数 ............................................................................... 187
5.129 NET_VCA_LEFT:丢包参数.......................................................................................................... 188
5.130 NET_VCA_LINE:线结构参数...................................................................................................... 189
5.131 NET_VCA_LOITER:徘徊参数...................................................................................................... 189
5.132 NET_VCA_OVER_TIME:操作超时参数....................................................................................... 190
5.133 NET_VCA_PARKING:停车参数................................................................................................... 191
5.134 NET_VCA_PEOPLENUM_CHANGE:人数变化参数....................................................................... 191
5.135 NET_VCA_POINT:点坐标参数 ................................................................................................... 192
5.136 NET_VCA_POLYGON:多边形参数 .............................................................................................. 193
5.137 NET_VCA_REACH_HIGHT:攀高参数........................................................................................... 193
5.138 NET_VCA_RECT:区域框参数 ..................................................................................................... 194
5.139 NET_VCA_RELATE_RULE_PARAM:关联规则参数 ....................................................................... 194
5.140 NET_VCA_RULE_ALARM:行为分析报警 .................................................................................... 195
5.141 NET_VCA_RULE_INFO:事件规则信息........................................................................................ 197
5.142 NET_VCA_RUN:快速移动参数 .................................................................................................. 199
5.143 NET_VCA_SCANNER:读卡器参数 .............................................................................................. 200
5.144 NET_VCA_SIT_QUIETLY:静坐参数.............................................................................................. 200
5.145 NET_VCA_SPACING_CHANGE:间距变化参数............................................................................. 201
5.146 NET_VCA_STANDUP:起立参数 .................................................................................................. 202
5.147 NET_VCA_STICK_UP:贴纸条参数 .............................................................................................. 202
5.148 NET_VCA_TAKE:捡包参数......................................................................................................... 203
5.149 NET_VCA_TAKE_LEFT:丢包/捡包参数........................................................................................ 204
5.150 NET_VCA_TARGET_INFO:报警目标信息 .................................................................................... 204
5.151 NET_VCA_TOILET_TARRY:如厕超时参数.................................................................................... 205
5.152 NET_VCA_TRAIL:尾随参数........................................................................................................ 206
5.153 NET_VCA_TRAVERSE_PLANE:穿越警戒面参数.......................................................................... 206
5.154 NET_VCA_VIOLENT_MOTION:剧烈运动参数............................................................................. 207
5.155 NET_VCA_YARD_TARRY:放风场滞留参数 .................................................................................. 208
5.156 struAlarmChannel:报警通道参数.............................................................................................. 209
5.157 struAlarmHardDisk:报警硬盘参数 ............................................................................................ 209
5.158 struIOAlarm:报警输入口信息................................................................................................... 209
5.159 struRecordingHost:录播主机专用报警参数.............................................................................. 210
5.160 uStruAlarm:报警信息联合体 .................................................................................................... 211
5.161 WEP:wep 加密参数 .................................................................................................................. 211
5.162 WPA_PSK:WPA_PSK 加密参数 .................................................................................................. 212
5.163 WPA_WPA2:WPA_WPA2 加密参数............................................................................................ 212
5.164 国家编号说明 .......................................................................................................................... 213