海康设备网络SDK编程指南（Android）资源-CSDN文库

SDK编程指南

需积分: 50 118 浏览量 2018-08-08 13:41:36 上传评论收藏 1.28MB PDF 举报

资源推荐

资源详情

资源评论

设备网络 SDK

编程指南

(For Android)

V5.1

设备网络 SDK 编程指南

声明 .........................................................................................................................................................................I

目录 ........................................................................................................................................................................II

1 SDK 简介 .............................................................................................................................................................1

2 SDK 版本更新 .....................................................................................................................................................2

3 函数说明 ............................................................................................................................................................3

3.1 SDK 初始化 ...........................................................................................................................................3

3.1.1 初始化 SDK NET_DVR_Init .........................................................................................................3

3.1.2 释放 SDK 资源 NET_DVR_Cleanup ............................................................................................3

3.2 SDK 本地功能 .......................................................................................................................................3

本地参数配置 ............................................................................................................................................3

3.2.1 获取 SDK 本地参数 NET_DVR_GetSDKLocalConfig ...................................................................3

3.2.2 设置 SDK 本地参数 NET_DVR_SetSDKLocalConfig ...................................................................4

连接和接收超时时间及重连设置 ............................................................................................................4

3.2.3 设置网络连接超时时间 NET_DVR_SetConnectTime ...............................................................4

3.2.4 设置重连功能 NET_DVR_SetReconnect ....................................................................................4

3.2.5 设置接收超时时间 NET_DVR_SetRecvTimeOut .......................................................................4

SDK 版本信息和日志 .................................................................................................................................5

3.2.6 获取 SDK 版本信息 NET_DVR_GetSDKVersion .........................................................................5

3.2.7 获取 SDK 的版本号和 build 信息 NET_DVR_GetSDKBuildVersion ...........................................5

3.2.8 启用写日志文件 NET_DVR_SetLogToFile..................................................................................5

异常消息回调 ............................................................................................................................................6

3.2.9 注册接收异常、重连消息回调函数 NET_DVR_SetExceptionCallBack_V30 ...........................6

获取错误信息 ............................................................................................................................................7

3.2.10 返回最后操作的错误码 NET_DVR_GetLastError......................................................................7

3.2.11 返回最后操作的错误信息 NET_DVR_GetErrorMsg .................................................................7

3.3 用户注册 ..............................................................................................................................................7

3.3.1 设备的动态 IP 和端口解析 NET_DVR_GetAddrInfoByServer ...................................................7

3.3.2 通过解析服务器，获取设备的动态 IP 地址和端口号 NET_DVR_GetDVRIPByResolveSvr_EX

....................................................................................................................................................8

3.3.3 激活设备 NET_DVR_ActivateDevice ..........................................................................................8

3.3.4 用户注册设备 NET_DVR_Login_V30 .........................................................................................9

3.3.5 用户注销 NET_DVR_Logout_V30 ..............................................................................................9

3.4 获取设备能力集 ..................................................................................................................................9

3.4.1 获取设备能力集 NET_DVR_GetXMLAbility ..............................................................................9

3.5 实时预览 ........................................................................................................................................... 10

强制 I 帧 ................................................................................................................................................. 10

3.5.1 主码流动态产生一个关键帧 NET_DVR_MakeKeyFrame ...................................................... 10

3.5.2 子码流动态产生一个关键帧 NET_DVR_MakeKeyFrameSub ................................................ 10

实时预览 ................................................................................................................................................. 10

3.5.3 实时预览 NET_DVR_RealPlay_V40 ......................................................................................... 10

III

设备网络 SDK 编程指南

3.5.4 停止预览 NET_DVR_StopRealPlay .......................................................................................... 11

显示参数配置 ......................................................................................................................................... 11

3.5.5 获取预览视频显示参数 NET_DVR_ClientGetVideoEffect ..................................................... 11

3.5.6 设置预览视频显示参数 NET_DVR_ClientSetVideoEffect ...................................................... 12

零通道预览 ............................................................................................................................................. 12

3.5.7 开始零通道预览 NET_DVR_ZeroStartPlay ............................................................................. 12

3.5.8 停止零通道预览 NET_DVR_ZeroStopPlay .............................................................................. 13

客户端录像 ............................................................................................................................................. 13

3.5.9 捕获预览数据并保存到指定文件中 NET_DVR_SaveRealData ............................................. 13

3.5.10 停止数据捕获 NET_DVR_StopSaveRealData .......................................................................... 13

3.6 设备抓图 ........................................................................................................................................... 13

3.6.1 单帧数据捕获并保存成 JPEG 图片 NET_DVR_CaptureJPEGPicture ..................................... 13

3.6.2 单帧数据捕获并保存成 JPEG 存放在指定的内存空间中

NET_DVR_CaptureJPEGPicture_NEW ...................................................................................... 14

3.7 布防、撤防 ....................................................................................................................................... 14

设置报警等信息上传的回调函数 ......................................................................................................... 14

3.7.1 注册回调函数，接收设备报警消息 NET_DVR_SetDVRMessageCallBack_V30 ................... 14

布防撤防 ................................................................................................................................................. 15

3.7.2 建立报警上传通道，获取报警等信息 NET_DVR_SetupAlarmChan_V30............................ 15

3.7.3 撤销报警上传通道 NET_DVR_CloseAlarmChan_V30 ............................................................ 15

3.8 远程参数配置 ................................................................................................................................... 16

通用参数配置 ......................................................................................................................................... 16

3.8.1 获取设备配置信息 NET_DVR_GetDVRConfig ........................................................................ 16

3.8.2 设置设备配置信息 NET_DVR_SetDVRConfig ..........................................................................17

报警输出配置 ......................................................................................................................................... 18

3.8.3 获取设备报警输出 NET_DVR_GetAlarmOut_V30 ................................................................. 18

3.8.4 设置设备报警输出 NET_DVR_SetAlarmOut .......................................................................... 18

设备支持的云台协议 ............................................................................................................................. 18

3.8.5 获取设备支持的云台协议 NET_DVR_GetPTZProtocol .......................................................... 18

3.9 录像文件回放、下载、锁定及备份................................................................................................ 19

刷新录像索引 ......................................................................................................................................... 19

3.9.1 即时刷新录像索引 NET_DVR_UpdateRecordIndex ............................................................... 19

录像文件的查找 ..................................................................................................................................... 19

3.9.2 根据文件类型、时间查找设备录像文件 NET_DVR_FindFile_V30 ...................................... 19

3.9.3 逐个获取查找到的文件信息 NET_DVR_FindNextFile_V30 .................................................. 19

3.9.4 关闭文件查找，释放资源 NET_DVR_FindClose_V30 ...........................................................20

按事件查找录像 ......................................................................................................................................20

3.9.5 按事件查找录像 NET_DVR_FindFileByEvent ..........................................................................20

3.9.6 逐个获取查找到的文件信息 NET_DVR_FindNextEvent ........................................................20

3.9.7 关闭文件查找，释放资源 NET_DVR_FindClose_V30 .......................................................... 21

回放录像文件 ......................................................................................................................................... 21

3.9.8 注册回调函数，捕获录像数据 NET_DVR_SetPlayDataCallBack .......................................... 21

3.9.9 按文件名回放录像文件 NET_DVR_PlayBackByName .......................................................... 22

3.9.10 按时间回放录像文件 NET_DVR_PlayBackByTime ............................................................... 22

设备网络 SDK 编程指南

3.9.11 控制录像回放的状态 NET_DVR_PlayBackControl_V40 ....................................................... 23

3.9.12 获取回放取流进度 NET_DVR_GetPlayBackPos ..................................................................... 23

3.9.13 停止回放录像文件 NET_DVR_StopPlayBack ........................................................................ 23

下载录像文件 ......................................................................................................................................... 24

3.9.14 按文件名下载录像文件 NET_DVR_GetFileByName ............................................................. 24

3.9.15 按时间下载录像文件 NET_DVR_GetFileByTime .................................................................. 24

3.9.16 控制录像下载的状态 NET_DVR_PlayBackControl_V40 ........................................................ 24

3.9.17 获取当前下载录像文件的进度 NET_DVR_GetDownloadPos ................................................25

3.9.18 停止下载录像文件 NET_DVR_StopGetFile ............................................................................25

3.10 云台控制 ............................................................................................................................................26

云台控制操作 ..........................................................................................................................................26

3.10.1 云台控制操作（需先启动预览）NET_DVR_PTZControl .......................................................26

3.10.2 云台控制操作（不用启动预览）NET_DVR_PTZControl_Other ............................................ 27

3.10.3 带速度的云台控制操作（需先启动预览）NET_DVR_PTZControlWithSpeed ..................... 27

3.10.4 带速度的云台控制操作（不用启动预览）NET_DVR_PTZControlWithSpeed_Other .......... 27

云台预置点操作 ..................................................................................................................................... 28

3.10.5 云台预置点操作，需先启动预览 NET_DVR_PTZPreset ....................................................... 28

3.10.6 云台预置点操作 NET_DVR_PTZPreset_Other ....................................................................... 28

云台巡航操作 ......................................................................................................................................... 29

3.10.7 云台巡航操作，需先启动预览 NET_DVR_PTZPCruise ......................................................... 29

3.10.8 云台巡航操作 NET_DVR_PTZPCruise_Other ......................................................................... 30

云台轨迹操作 ......................................................................................................................................... 30

3.10.9 云台轨迹操作，需先启动预览 NET_DVR_PTZTrack ............................................................. 30

3.10.10 云台轨迹操作 NET_DVR_PTZTrack_Other ............................................................................. 31

云台区域缩放控制 ................................................................................................................................. 31

3.10.11 云台图象区域选择放大或缩小 NET_DVR_PTZSelZoomIn .................................................... 31

3.10.12 云台图像区域选择放大或缩小 NET_DVR_PTZSelZoomIn_Ex .............................................. 31

3.11 语音转发 ........................................................................................................................................... 32

3.11.1 获取当前生效的音频对讲音频压缩参数 NET_DVR_GetCurrentAudioCompress................ 32

3.11.2 启动语音转发，获取编码后的音频数据 NET_DVR_StartVoiceCom_MR_V30 ................... 32

3.11.3 转发语音数据 NET_DVR_VoiceComSendData ....................................................................... 33

3.11.4 停止语音转发 NET_DVR_StopVoiceCom ............................................................................... 33

3.12 数据透传 ........................................................................................................................................... 33

透明通道 ................................................................................................................................................. 33

3.12.1 建立透明通道 NET_DVR_SerialStart_V40 .............................................................................. 33

3.12.2 通过透明通道向设备串口发送数据 NET_DVR_SerialSend .................................................. 34

3.12.3 断开透明通道 NET_DVR_SerialStop....................................................................................... 34

向串口发送数据 ..................................................................................................................................... 34

3.12.4 直接向串口发送数据，不需要建立透明通道 NET_DVR_SendToSerialPort ........................ 34

3.12.5 直接向 232 串口发送数据，不需要建立透明通道 NET_DVR_SendTo232Port................... 35

3.13 设备手动录像 ................................................................................................................................... 35

3.13.1 远程手动启动设备录像 NET_DVR_StartDVRRecord ............................................................. 35

3.13.2 远程手动停止设备录像 NET_DVR_StopDVRRecord ............................................................. 35

3.14 远程面板控制 ................................................................................................................................... 36