【免费】设备网络SDK编程指南（抓拍机）1资源-CSDN文库

网络

需积分: 0 43 浏览量 2022-08-03 16:40:17 上传评论收藏 2.35MB PDF 举报

资源详情

资源评论

资源推荐

设备(智能交通摄像机)

网络 SDK 编程指南

V5.2

设备网络 SDK 编程指南

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

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

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

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

3 函数调用顺序 ............................................................................................................................................................ 17

3.1 SDK 接口调用主要流程 .................................................................................................................................... 17

3.2 报警（布防）流程 ............................................................................................................................................ 18

3.3 报警（监听）流程 ............................................................................................................................................ 19

4 函数调用实例 ............................................................................................................................................................ 20

4.1 参数配置模块的示例代码 ................................................................................................................................ 20

4.2 抓拍图片上传示例代码 .................................................................................................................................... 21

4.3 抓拍机实时状态检测结果上传 ........................................................................................................................ 27

5 函数说明 .................................................................................................................................................................... 29

5.1 SDK 初始化 ........................................................................................................................................................ 29

5.1.1 初始化 SDK NET_DVR_Init ........................................................................................................................ 29

5.1.2 释放 SDK 资源 NET_DVR_Cleanup ............................................................................................................ 29

5.2 SDK 本地功能 .................................................................................................................................................... 29

SDK 本地参数配置 ..................................................................................................................................................... 29

5.2.1 获取 SDK 本地参数 NET_DVR_GetSDKLocalCfg ....................................................................................... 29

5.2.2 设置 SDK 本地参数 NET_DVR_SetSDKLocalCfg ........................................................................................ 30

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

5.2.3 设置网络连接超时时间和连接尝试次数 NET_DVR_SetConnectTime ................................................... 31

5.2.4 设置重连功能 NET_DVR_SetReconnect ................................................................................................... 31

5.2.5 设置接收超时时间 NET_DVR_SetRecvTimeOut ...................................................................................... 31

多网卡绑定 ................................................................................................................................................................ 31

5.2.6 获取所有 IP，用于支持多网卡接口 NET_DVR_GetLocalIP .................................................................... 31

5.2.7 设置 IP 绑定 NET_DVR_SetValidIP ............................................................................................................ 32

SDK 版本、状态和能力 ............................................................................................................................................. 32

5.2.8 获取 SDK 的版本号和 build 信息 NET_DVR_GetSDKBuildVersion .......................................................... 32

5.2.9 获取当前 SDK 的状态信息 NET_DVR_GetSDKState ................................................................................. 32

5.2.10 获取当前 SDK 的功能信息 NET_DVR_GetSDKAbility .............................................................................. 32

SDK 启用写日志 ......................................................................................................................................................... 33

5.2.11 启用写日志文件 NET_DVR_SetLogToFile ................................................................................................. 33

异常消息回调 ............................................................................................................................................................ 33

5.2.12 注册接收异常、重连等消息的窗口句柄或回调函数 NET_DVR_SetExceptionCallBack_V30 ............... 33

获取错误信息 ............................................................................................................................................................ 35

5.2.13 返回最后操作的错误码 NET_DVR_GetLastError ..................................................................................... 35

5.2.14 返回最后操作的错误码信息 NET_DVR_GetErrorMsg ............................................................................. 35

5.3 用户注册 ............................................................................................................................................................ 36

5.3.1 激活设备 NET_DVR_ActivateDevice ......................................................................................................... 36

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

5.3.3 用户注册设备 NET_DVR_Login_V40 ........................................................................................................ 37

设备网络 SDK 编程指南

III

5.3.4 用户注销 NET_DVR_Logout ...................................................................................................................... 37

5.4 获取设备能力集 ................................................................................................................................................ 37

5.4.1 获取设备能力集 NET_DVR_GetDeviceAbility .......................................................................................... 37

5.4.2 获取设备能力集 NET_DVR_GetSTDAbility .............................................................................................. 39

5.5 实时预览 ............................................................................................................................................................ 39

5.5.1 主码流动态产生一个关键帧 NET_DVR_MakeKeyFrame ........................................................................ 39

5.5.2 子码流动态产生一个关键帧 NET_DVR_MakeKeyFrameSub .................................................................. 39

5.5.3 实时预览 NET_DVR_RealPlay_V40 ........................................................................................................... 40

5.5.4 停止预览 NET_DVR_StopRealPlay ............................................................................................................ 40

5.5.5 获取预览时用来解码和显示的播放库句柄 NET_DVR_GetRealPlayerIndex .......................................... 41

5.6 预览时播放声音控制 ........................................................................................................................................ 41

5.6.1 设置声音播放模式 NET_DVR_SetAudioMode ......................................................................................... 41

5.6.2 独占声卡模式下开启声音 NET_DVR_OpenSound .................................................................................. 41

5.6.3 独占声卡模式下开启声音 NET_DVR_CloseSound .................................................................................. 42

5.6.4 共享声卡模式下开启声音 NET_DVR_OpenSoundShare ......................................................................... 42

5.6.5 共享声卡模式下关闭声音 NET_DVR_CloseSoundShare ......................................................................... 42

5.6.6 调节播放音量 NET_DVR_Volume ............................................................................................................. 42

5.7 实时预览数据捕获 ............................................................................................................................................ 43

5.7.1 注册回调函数，捕获实时码流数据 NET_DVR_SetRealDataCallBack ..................................................... 43

5.7.2 捕获数据并保存到指定的文件中 NET_DVR_SaveRealData .................................................................... 43

5.7.3 停止数据捕获 NET_DVR_StopSaveRealData ............................................................................................ 44

5.8 预览时抓图 ........................................................................................................................................................ 44

5.8.1 设置抓图模式 NET_DVR_SetCapturePictureMode .................................................................................. 44

5.8.2 预览时，单帧数据捕获图片并保存成文件 NET_DVR_CapturePicture ................................................. 44

5.9 布防、撤防 ........................................................................................................................................................ 45

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

5.9.1 注册报警回调函数 NET_DVR_SetDVRMessageCallBack_V31.................................................................. 45

布防撤防 .................................................................................................................................................................... 46

5.9.2 建立报警上传通道，获取报警等信息 NET_DVR_SetupAlarmChan_V41 .............................................. 46

5.9.3 撤销报警上传通道 NET_DVR_CloseAlarmChan_V30 .............................................................................. 47

5.10 监听报警 ............................................................................................................................................................ 47

5.10.1 启动监听，接收设备主动上传的报警等信息 NET_DVR_StartListen_V30 ............................................ 47

5.10.2 停止监听（支持多线程）NET_DVR_StopListen_V30 ............................................................................. 48

5.11 远程参数配置 .................................................................................................................................................... 48

通用参数配置 ............................................................................................................................................................ 48

5.11.1 获取设备的配置信息 NET_DVR_GetDVRConfig ...................................................................................... 48

5.11.2 设置设备的配置信息 NET_DVR_SetDVRConfig ....................................................................................... 50

5.11.3 批量获取配置信息 NET_DVR_GetDeviceConfig ...................................................................................... 51

5.11.4 批量设置配置信息 NET_DVR_SetDeviceConfig ....................................................................................... 52

抓拍参数配置 ............................................................................................................................................................ 53

5.11.5 获取设备的配置信息 NET_DVR_GetDVRConfig ...................................................................................... 53

5.11.6 设置设备的配置信息 NET_DVR_SetDVRConfig ....................................................................................... 54

5.11.7 批量获取配置信息 NET_DVR_GetDeviceConfig ...................................................................................... 55

5.11.8 批量设置配置信息 NET_DVR_SetDeviceConfig ....................................................................................... 57

设备网络 SDK 编程指南

5.11.9 获取设备参数 NET_DVR_GetSTDConfig ................................................................................................... 58

5.11.10 设置设备参数 NET_DVR_SetSTDConfig ............................................................................................... 58

长连接参数配置 ........................................................................................................................................................ 59

5.11.11 启动长连接远程配置 NET_DVR_StartRemoteConfig .......................................................................... 59

5.11.12 逐个获取查找到的结果信息 NET_DVR_GetNextRemoteConfig ......................................................... 60

5.11.13 发送长连接数据 NET_DVR_SendRemoteConfig .................................................................................. 61

5.11.14 关闭长连接配置接口所创建的句柄，释放资源 NET_DVR_StopRemoteConfig ............................... 61

获取设备支持的云台协议 ........................................................................................................................................ 61

5.11.15 获取设备支持的云台协议 NET_DVR_GetPTZProtocol ........................................................................ 61

5.12 证书管理 ............................................................................................................................................................ 62

证书创建、删除 ........................................................................................................................................................ 62

5.12.1 远程控制 NET_DVR_RemoteControl ......................................................................................................... 62

证书信息获取 ............................................................................................................................................................ 62

5.12.2 批量获取配置信息 NET_DVR_GetDeviceConfig ...................................................................................... 62

证书上传下载 ............................................................................................................................................................ 63

5.12.3 上传文件 NET_DVR_UploadFile_V40........................................................................................................ 63

5.12.4 获取文件上传的进度和状态 NET_DVR_GetUploadState ........................................................................ 64

5.12.5 停止文件上传 NET_DVR_UploadClose ..................................................................................................... 64

5.12.6 开始下载文件 NET_DVR_StartDownload ................................................................................................. 64

5.12.7 获取文件下载的进度和状态 NET_DVR_GetDownloadState ................................................................... 64

5.12.8 停止文件下载 NET_DVR_StopDownload ................................................................................................. 65

5.13 远程控制 ............................................................................................................................................................ 65

5.13.1 远程控制 NET_DVR_RemoteControl ......................................................................................................... 65

5.14 手动触发抓拍 .................................................................................................................................................... 66

5.14.1 网络触发抓拍 NET_DVR_ContinuousShoot ............................................................................................. 66

5.14.2 手动抓拍 NET_DVR_ManualSnap ............................................................................................................. 66

5.15 雨刷控制 ............................................................................................................................................................ 66

5.15.1 云台控制操作 NET_DVR_PTZControl_Other ............................................................................................ 66

5.16 图片的查找、下载 ............................................................................................................................................ 67

查找图片 .................................................................................................................................................................... 67

5.16.1 根据类型和时间查找图片 NET_DVR_FindPicture ................................................................................... 67

5.16.2 逐个获取查找到的图片 NET_DVR_FindNextPicture ............................................................................... 67

5.16.3 关闭图片查找，释放资源 NET_DVR_CloseFindPicture ......................................................................... 68

图片下载 .................................................................................................................................................................... 68

5.16.4 获取图片数据并存放在指定的内存空间中 NET_DVR_GetPicture_V30 ................................................ 68

5.16.5 图片下载 NET_DVR_GetPicture ................................................................................................................ 68

5.17 文件上传 ............................................................................................................................................................ 68

5.17.1 上传文件 NET_DVR_UploadFile_V40........................................................................................................ 68

5.17.2 获取文件上传的进度和状态 NET_DVR_GetUploadState ........................................................................ 69

5.17.3 停止文件上传，释放资源 NET_DVR_UploadClose ................................................................................. 69

5.18 获取设备状态 .................................................................................................................................................... 69

5.18.1 获取设备状态信息 NET_DVR_GetDeviceStatus ....................................................................................... 69

5.19 设备维护管理 .................................................................................................................................................... 70

在线状态检测 ............................................................................................................................................................ 70