没有合适的资源?快使用搜索试试~ 我知道了~
网络库使用说明书_v1.0.3.31
试读
89页
需积分: 0 0 下载量 89 浏览量
更新于2022-08-03
收藏 563KB PDF 举报
《网络库使用说明书_v1.0.3.31》
网络库是软件开发中用于处理网络通信的核心组件,它提供了丰富的功能和编程接口,帮助开发者实现高效稳定的网络交互。本使用说明书详细介绍了网络库的功能、编程导引、数据类型定义、错误定义以及函数说明,旨在为开发者提供全面的技术支持。
一、功能说明
1. 网络库主要功能:该部分介绍网络库的核心功能,包括TCP/IP连接管理、HTTP/HTTPS协议支持、UDP广播和多播、WebSocket双向通信、SSL/TLS安全加密等。此外,还可能涵盖网络状态监测、数据压缩与解压、网络时间同步等功能。
2. 网络库文件说明:这部分详细列举了网络库中的各个文件,包括头文件(头文件中包含了接口定义)和库文件(实现网络库功能的代码)。开发者需要了解这些文件的作用,以便正确地在项目中引入和使用。
二、编程导引
1. 网络库接口调用主要流程:此部分详细阐述了使用网络库进行网络操作的基本步骤,包括初始化、连接建立、数据传输、断开连接和资源释放等关键环节。开发者需要遵循这些流程来保证程序的正确运行。
2. 实时数据流模块流程:讲解如何通过网络库实现实时数据的发送和接收,包括数据打包、发送、接收和解包的过程,适用于视频流、音频流等实时性要求高的应用场景。
3. 云台控制模块流程:针对摄像头等设备的云台控制,说明如何通过网络库发送控制指令,调整摄像头的角度和焦距。
4. 参数配置模块流程:介绍如何通过网络库设置和获取设备参数,如网络配置、编码设置等。
5. 语音对讲模块流程:说明如何利用网络库实现语音的编码、传输和解码,实现设备间的语音通信。
6. 报警模块流程:讲解如何通过网络库触发和接收报警信号,实现设备的远程监控和报警功能。
7. 解码器模块流程:描述了网络库在接收数据后如何解码,适用于解码不同格式的数据,如JPEG、H.264等。
三、数据类型定义说明
这部分详细解释了网络库中定义的各种数据类型,例如网络连接结构体、消息包结构体、错误码枚举等,这些数据类型是开发者在编程时与网络库交互的基础。
四、错误定义说明
网络库中定义了一系列的错误代码,用于标识和处理在使用过程中可能出现的问题。这部分列出了这些错误代码及其含义,帮助开发者理解并解决可能出现的异常情况。
五、函数说明
函数说明部分提供了网络库所有接口的详细文档,包括每个函数的名称、参数、返回值、功能描述和使用示例。这是开发者实际编程时最常参考的部分,每个函数的正确使用是实现特定网络功能的关键。
《网络库使用说明书_v1.0.3.31》是一份全面的开发者指南,涵盖了从基础功能到高级应用的所有方面,为开发人员提供了清晰的操作路径和详尽的技术细节,有助于高效地利用网络库进行软件开发。
网络库使用说明书
Version:1.0.3.3
版本更新说明.....................................................................................................................................4
一、功能说明.....................................................................................................................................8
网络库主要功能.........................................................................................................................8
网络库文件说明.........................................................................................................................8
二、编程导引.....................................................................................................................................9
网络库接口调用主要流程.........................................................................................................9
实时数据流模块流程...............................................................................................................10
云台控制模块流程...................................................................................................................11
参数配置模块流程...................................................................................................................12
语音对讲模块流程...................................................................................................................13
报警模块流程...........................................................................................................................14
解码器模块流程.......................................................................................................................15
三、数据类型定义说明...................................................................................................................17
四、错误定义说明...........................................................................................................................18
五、函数说明...................................................................................................................................18
5.1 初始化 SDK..................................................................................................................18
HI_NET_DEV_Init...........................................................................................................18
HI_NET_DEV_DeInit...................................................................................................... 18
5.2 用户注册.......................................................................................................................18
HI_NET_DEV_Login.......................................................................................................18
HI_NET_DEV_LoginExt................................................................................................. 19
HI_NET_DEV_Logout.....................................................................................................20
HI_NET_DEV_SetConnectTimeout................................................................................ 20
HI_NET_DEV_SetReconnect.......................................................................................... 20
5.3 实时预览.......................................................................................................................21
HI_NET_DEV_StartStream............................................................................................. 21
HI_NET_DEV_StartStreamExt........................................................................................22
HI_NET_DEV_StopStream..............................................................................................23
HI_NET_DEV_MakeKeyFrame...................................................................................... 23
5.4 实时预览数据回调.......................................................................................................24
HI_NET_DEV_SetEventCallBack...................................................................................24
HI_NET_DEV_SetStreamCallBack.................................................................................25
HI_NET_DEV_SetDataCallBack.....................................................................................27
5.5 摄像机属性设置...........................................................................................................28
HI_NET_DEV_SetConfig................................................................................................ 28
HI_NET_DEV_GetConfig............................................................................................... 48
5.6 云台控制.......................................................................................................................57
HI_NET_DEV_PTZ_Ctrl_Standard.................................................................................57
HI_NET_DEV_PTZ_Ctrl_StandardEx............................................................................ 58
HI_NET_DEV_PTZ_Ctrl_Preset..................................................................................... 58
HI_NET_DEV_PTZ_Ctrl_Extend................................................................................... 59
HI_NET_DEV_PTZ_Fully_Trans....................................................................................60
5.7 对讲...............................................................................................................................60
HI_NET_DEV_StartVoice................................................................................................60
HI_NET_DEV_StopVoice................................................................................................61
HI_NET_DEV_SendVoiceData........................................................................................61
5.8 录像抓拍.......................................................................................................................62
HI_NET_DEV_StartRecord............................................................................................. 63
HI_NET_DEV_StopRecord............................................................................................. 64
HI_NET_DEV_GetRecordState.......................................................................................64
HI_NET_DEV_SnapJpeg.................................................................................................65
5.9 设置操作通道...............................................................................................................66
HI_NET_DEV_SetChannel..............................................................................................66
HI_NET_DEV_GetChannel............................................................................................. 66
5.10 解码器.......................................................................................................................67
解码器调用顺序...............................................................................................................67
HI_NET_DEV_GetDisplayCfg........................................................................................67
HI_NET_DEV_SetDisplayCfg.........................................................................................68
HI_NET_DEV_StartDec.................................................................................................. 69
HI_NET_DEV_StopDec.................................................................................................. 69
HI_NET_DEV_GetLoopDecChnInfo.............................................................................. 70
HI_NET_DEV_SetLoopDecChnInfo...............................................................................71
HI_NET_DEV_GetLoopDecChnEnable..........................................................................71
HI_NET_DEV_SetLoopDecChnEnable.......................................................................... 71
HI_NET_DEV_GetLoopDecEnable................................................................................ 72
HI_NET_DEV_GetChnInfo............................................................................................. 72
HI_NET_DEV_GetDecChnEnable.................................................................................. 73
HI_NET_DEV_SetDecChnEnable...................................................................................74
HI_NET_DEV_StartPassiveDecode................................................................................ 74
HI_NET_DEV_StopPassiveDecode.................................................................................75
HI_NET_DEV_DecodeSendData.................................................................................... 75
解码器其他相关接口.......................................................................................................76
5.11 AVI 文件解析...............................................................................................................77
AVI 解析调用顺序...........................................................................................................77
AVI 解析接口错误定义...................................................................................................77
AVI_CreateReader............................................................................................................ 77
AVI_DestroyReader.......................................................................................................... 78
AVI_ReadFrame................................................................................................................78
AVI_SeekFrame................................................................................................................ 79
AVI_ReadFileInfo.............................................................................................................79
六、音频编解码说明.......................................................................................................................81
6.1 音频采集格式设置.......................................................................................................81
6.2 音频采集流程...............................................................................................................81
6.3 音频播放流程...............................................................................................................82
6.4 音频编码.......................................................................................................................82
6.5 音频解码.......................................................................................................................84
七、附录...........................................................................................................................................86
附录Ⅰ、文件夹列表...............................................................................................................86
附录Ⅱ、Linux Demo 使用说明............................................................................................. 86
附录Ⅲ、厂家代码和设备类型定义...................................................................................... 86
网络库使用说明书
第
4
页 共
89
页
版本更新说明
V1.0.3.3 2015-06-24
1. 修 改 HI_NET_DEV_SetConfig , 增 加 手 动 触 发 外 置 报 警 的 功 能 , 对 应 的 命 令 为 :
HI_NET_DEV_CMD_EXT_ALARM,对应的结构体为:HI_S_ExtAlarm,具体用法可参考 SDK Demo
中报警功能下的外置报警抓拍。
v1.0.3.2 2015-03-07
1. 云台透传中透传的最大数据长度修改为 128,原本为 64
2. 修 改 HI_NET_DEV_SetConfig, 增 加 继 电 器 开 关 功 能 , 对 应 的 命 令 为 :
HI_NET_DEV_CMD_RELAYCTRL,对应的结构体为:HI_S_RelayCtrl,
V1.0.2.9 2013-09-27
1、 添加新设备类型,字段 Se、Sf,详情请查阅《厂家代码和设备类型定义》。
V1.0.2.7 2013-07-15
1、 更正 C#无法调用回调函数问题,请修正相应的回调函数,重新编译
在原来的回调中加入 NETSDK_APICALL
typedef HI_S32 ( *HI_ON_STREAM_CALLBACK)(
HI_U32 u32Handle, /* 句柄 */
HI_U32 u32DataType, /* 数据类型,系统数据或音视频数据 */
HI_U8* pu8Buffer, /* 数据包含帧头 */
HI_U32 u32Length, /* 数据长度 */
HI_VOID* pUserData /* 用户数据*/
);
变更为:
typedef HI_S32 (NETSDK_APICALL *HI_ON_STREAM_CALLBACK)(
HI_U32 u32Handle, /* 句柄 */
HI_U32 u32DataType, /* 数据类型,系统数据或音视频数据 */
HI_U8* pu8Buffer, /* 数据包含帧头 */
HI_U32 u32Length, /* 数据长度 */
HI_VOID* pUserData /* 用户数据*/
);
V1.0.2.6 2013-04-13
1、 增加 AVI 文件解析 接口。
V1.0.2.5 2013-04-01
1、 添加新设备类型,字段 Sc,详情请查阅《厂家代码和设备类型定义》。Sc 设备有两
套分辨,第一套 960P\VGA\QVGA,第二套 720P\Q720\QQ720,用户可以根据实际应
用选择需要的分辨率。
网络库使用说明书
第
5
页 共
89
页
V1.0.2.3 2013-02-05
1、 修改 HI_NET_DEV_SetConfig 设置 OSD 参数 HI_NET_DEV_CMD_OSD_PARAM 中
文,linux 下,设备类型如果为 C5,中文字符必须转换成 UTF-8。
V1.0.2.2 2012-12-10
2、 添加三码流接口 HI_NET_DEV_StartStreamExt。三码流需要设备支持;
3、 网络抓拍接口:HI_NET_DEV_SnapJpeg
4、 添加三码流控制接口:参阅 HI_NET_DEV_SetConfig 和 HI_NET_DEV_GetConfig
#define HI_NET_DEV_CMD_AUDIO_VOLUME_IN 0x1070 //音频输入音量
#define HI_NET_DEV_CMD_AUDIO_VOLUME_OUT 0x1071 //音频输出音量
5、 添加三码流控制接口:参阅 HI_NET_DEV_SetConfig 和 HI_NET_DEV_GetConfig
#define HI_NET_DEV_CMD_VIDEO_PARAM_EXT 0x1047 //视频参数
#define HI_NET_DEV_CMD_AUDIO_PARAM_EXT 0x1048 //音频参数
#define HI_NET_DEV_CMD_RESOLUTION_EXT 0x1049 //分辨率
V1.0.2.1 2012-10-22
1、 添加解码器 SDK
2、 添加 WIFI 控制接口:参阅 HI_NET_DEV_SetConfig 和 HI_NET_DEV_GetConfig
#define HI_NET_DEV_CMD_WIFI_PARAM 0x1030 //WIFI 参数
#define HI_NET_DEV_CMD_WIFI_SEARCH 0x1031 //WIFI 搜索
#define HI_NET_DEV_CMD_WIFI_CHECK 0x1035 //WIFI check
V1.0.1.9 2012-05-29
1、 增加动态 I 帧接口 HI_NET_DEV_MakeKeyFrame;
V1.0.1.8 2012-03-29
1、 修改字段为 S7、S9 的设备的默认值;
2、 增加 HI_NET_DEV_LoginExt 登陆接口,接口中带有超时时间;
3、 增加 HI_NET_DEV_SetChannel 和 HI_NET_DEV_GetChannel,用于设置 NVR 通道;
4、 增加 NVR 参数设置
#define HI_NET_NVR_CMD_NET_EXT 0x1050 // NVR 网络参数
#define HI_NET_NVR_CMD_RTSP_INFO 0x1051 // NVR rtsp 参数
#define HI_NET_NVR_CMD_USER 0x1052 // NVR 用户参数
#define HI_NET_NVR_CMD_CHANNEL_INFO 0x1053 // NVR 通道参数
#define HI_NET_NVR_CMD_SEARCH 0x1055 // NVR 搜索设备
#define HI_NET_NVR_CMD_RECORD_INFO 0x1056 // NVR 通道录像参数
#define HI_NET_NVR_CMD_RECORD_SYS 0x1057 // NVR 系统参数
#define HI_NET_NVR_CMD_TIME 0x1058 // NVR 时间参数
#define HI_NET_NVR_CMD_RESET 0x1059 // NVR 恢复出厂设置
#define HI_NET_NVR_CMD_REBOOT 0x1060 // NVR 重启
#define HI_NET_NVR_CMD_RECORD_STATE 0x1061 // 获取录像状态
#define HI_NET_NVR_CMD_DISK_INFO 0x1062 // 获取硬盘信息
#define HI_NET_NVR_CMD_DISK_FORMAT 0x1063 // 格式化硬盘
剩余88页未读,继续阅读
资源推荐
资源评论
134 浏览量
2019-06-26 上传
2020-07-05 上传
5星 · 资源好评率100%
159 浏览量
5星 · 资源好评率100%
107 浏览量
178 浏览量
143 浏览量
2019-09-04 上传
2020-07-02 上传
129 浏览量
190 浏览量
2021-10-07 上传
2013-09-14 上传
2020-11-07 上传
109 浏览量
2010-02-24 上传
2023-11-16 上传
资源评论
开眼旅行精选
- 粉丝: 19
- 资源: 327
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功