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

网络

需积分: 0 175 浏览量 2022-08-04 13:08:01 上传评论收藏 1.88MB PDF 举报

资源详情

资源评论

资源推荐

设备(智能交通终端)

网络 SDK 编程指南

V5.2

设备网络 SDK 编程指南

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

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

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

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

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

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

3.2 报警模块流程 ...................................................................................................................................................... 9

3.2.1 报警（布防）流程 ..................................................................................................................................... 9

3.2.2 报警（监听）流程 ................................................................................................................................... 10

3.3 IP 通道配置........................................................................................................................................................ 11

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

4.1 交通数据接收示例代码 .................................................................................................................................... 12

5 函数说明 .................................................................................................................................................................... 17

5.1 SDK 初始化 ........................................................................................................................................................ 17

5.1.1 初始化 SDK NET_DVR_Init ........................................................................................................................ 17

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

5.2 SDK 本地功能 .................................................................................................................................................... 17

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

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

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

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

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

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

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

多网卡绑定 ................................................................................................................................................................ 19

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

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

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

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

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

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

SDK 启用写日志 ......................................................................................................................................................... 21

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

异常消息回调 ............................................................................................................................................................ 21

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

获取错误信息 ............................................................................................................................................................ 23

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

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

5.3 用户注册 ............................................................................................................................................................ 24

5.3.1 激活设备 NET_DVR_ActivateDevice ......................................................................................................... 24

设备网络 SDK 编程指南

III

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

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

5.3.4 用户注销 NET_DVR_Logout ...................................................................................................................... 25

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

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

5.5 实时预览 ............................................................................................................................................................ 26

5.5.1 设置播放显示模式 NET_DVR_SetShowMode .......................................................................................... 26

5.5.2 主码流动态产生一个关键帧 NET_DVR_MakeKeyFrame ........................................................................ 27

5.5.3 子码流动态产生一个关键帧 NET_DVR_MakeKeyFrameSub .................................................................. 27

5.5.4 实时预览 NET_DVR_RealPlay_V40 ........................................................................................................... 27

5.5.5 停止预览 NET_DVR_StopRealPlay ............................................................................................................ 28

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

5.6 预览时解码效果的参数控制 ............................................................................................................................ 29

5.6.1 设置播放库的帧缓冲区个数 NET_DVR_SetPlayerBufNumber ................................................................ 29

5.7 预览时播放声音控制 ........................................................................................................................................ 29

5.7.1 设置声音播放模式 NET_DVR_SetAudioMode ......................................................................................... 29

5.7.2 独占声卡模式下开启声音 NET_DVR_OpenSound .................................................................................. 29

5.7.3 独占声卡模式下开启声音 NET_DVR_CloseSound .................................................................................. 30

5.7.4 共享声卡模式下开启声音 NET_DVR_OpenSoundShare ......................................................................... 30

5.7.5 共享声卡模式下关闭声音 NET_DVR_CloseSoundShare ......................................................................... 30

5.7.6 调节播放音量 NET_DVR_Volume ............................................................................................................. 30

5.8 实时预览数据捕获 ............................................................................................................................................ 31

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

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

5.8.3 停止数据捕获 NET_DVR_StopSaveRealData ............................................................................................ 32

5.9 布防、撤防 ........................................................................................................................................................ 32

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

5.9.1 注册回调函数，接收设备报警消息 NET_DVR_SetDVRMessageCallBack_V31 ...................................... 32

布防撤防 .................................................................................................................................................................... 33

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

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

5.10 监听报警 ............................................................................................................................................................ 33

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

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

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

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

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

5.12 批量配置参数 .................................................................................................................................................... 37

5.12.1 批量获取配置信息 NET_DVR_GetDeviceConfig ...................................................................................... 37

5.12.2 批量设置配置信息 NET_DVR_SetDeviceConfig ....................................................................................... 38

5.13 长连接参数配置 ................................................................................................................................................ 39

5.13.1 启动长连接远程配置 NET_DVR_StartRemoteConfig ............................................................................... 39

5.13.2 逐个获取查找到的结果信息 NET_DVR_GetNextRemoteConfig ............................................................. 41

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

设备网络 SDK 编程指南

5.14 远程控制 ............................................................................................................................................................ 42

5.14.1 远程控制 NET_DVR_RemoteControl ......................................................................................................... 42

5.15 录像回放和下载 ................................................................................................................................................ 42

5.15.1 按时间回放录像文件 NET_DVR_PlayBackByTime_V40 .......................................................................... 42

5.15.2 按时间下载录像文件 NET_DVR_GetFileByTime_V40 ............................................................................ 42

5.15.3 控制录像回放的状态 NET_DVR_PlayBackControl_V40 .......................................................................... 43

回放录像文件时的数据捕获 .................................................................................................................................... 44

5.15.4 捕获回放的录像数据，并保存成文件 NET_DVR_PlayBackSaveData ................................................... 44

5.15.5 停止保存录像数据 NET_DVR_StopPlayBackSave .................................................................................... 44

5.15.6 注册回调函数，捕获录像数据 NET_DVR_SetPlayDataCallBack_V40..................................................... 44

5.16 图片下载 ............................................................................................................................................................ 45

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

5.17 设备维护管理 .................................................................................................................................................... 45

远程升级 .................................................................................................................................................................... 45

5.17.1 设置远程升级时网络环境 NET_DVR_SetNetworkEnvironment .............................................................. 45

5.17.2 远程升级 NET_DVR_Upgrade ................................................................................................................... 46

5.17.3 获取远程升级的进度 NET_DVR_GetUpgradeProgress ............................................................................ 46

5.17.4 获取远程升级的状态 NET_DVR_GetUpgradeState .................................................................................. 46

5.17.5 关闭远程升级句柄，释放资源 NET_DVR_CloseUpgradeHandle ............................................................ 46

日志查找 .................................................................................................................................................................... 47

5.17.6 查找设备的日志信息 NET_DVR_FindDVRLog_V30 ................................................................................. 47

5.17.7 逐条获取查找到的日志信息 NET_DVR_FindNextLog_V30 ..................................................................... 47

5.17.8 释放查找日志的资源 NET_DVR_FindLogClose_V30 ................................................................................ 47

恢复设备默认参数 .................................................................................................................................................... 48

5.17.9 恢复设备默认参数 NET_DVR_RestoreConfig ........................................................................................... 48

导入/导出配置文件 .................................................................................................................................................. 48

5.17.10 导出配置文件 NET_DVR_GetConfigFile_V30 ....................................................................................... 48

5.17.11 导出配置文件 NET_DVR_GetConfigFile ............................................................................................... 48

5.17.12 导入配置文件 NET_DVR_SetConfigFile_EX .......................................................................................... 48

5.17.13 导入配置文件 NET_DVR_SetConfigFile ................................................................................................ 49

关机和重启 ................................................................................................................................................................ 49

5.17.14 重启设备 NET_DVR_RebootDVR .......................................................................................................... 49

5.17.15 关闭设备 NET_DVR_ShutDownDVR ..................................................................................................... 49

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

5.18.1 获取设备支持的云台协议 NET_DVR_GetPTZProtocol ............................................................................ 50

5.19 获取 IPC 协议列表 ............................................................................................................................................ 50

5.19.1 获取设备支持的 IPC 协议表 NET_DVR_GetIPCProtoList ......................................................................... 50

5.20 获取设备状态 .................................................................................................................................................... 50

5.20.1 获取设备状态信息 NET_DVR_GetDeviceStatus ....................................................................................... 50

6 错误代码及说明 ........................................................................................................................................................ 52

6.1 网络通讯库错误码 ............................................................................................................................................ 52

6.2 RTSP 通讯库错误码 ........................................................................................................................................... 55

6.3 软解码库错误码 ................................................................................................................................................ 55

7 附录:结构体 ............................................................................................................................................................... 57