ONVIF2.0中文协议原版
1 范围 ............................................................................................................................................. 16
2 引用标准 ..................................................................................................................................... 17
3 术语与定义 .................................................................................................................................. 19
3.1 定义 ............................................................................................................................................
3.2 缩写 .............................................................................................................................................
4 概述 ............................................................................................................................................. 23
4.1 WEB 服务 .....................................................................................................................................
4.2 IP 配置 .......................................................................................................................................
4.3 设备发现 .....................................................................................................................................
4.4 设备类型 .....................................................................................................................................
4.5 设备管理 .....................................................................................................................................
4.5.1 功能 ....................................................................................................................................
4.5.2 网络 ....................................................................................................................................
4.5.3 系统 ....................................................................................................................................
4.5.4 系统信息检索 ....................................................................................................................
4.5.5 固件升级 ............................................................................................................................
4.5.6 系统还原 ............................................................................................................................
4.5.7 安全 ....................................................................................................................................
4.6 设备 IO .......................................................................................................................................
4.7 图像配置 ....................................................................................................................................
4.8 媒体配置 ....................................................................................................................................
4.8.1 媒体配置文件 ....................................................................................................................
4.9 实时流 ........................................................................................................................................
4.10 事件处理 ..................................................................................................................................
4.11 PTZ控制 ...................................................................................................................................
4.12 视频分析 ..................................................................................................................................
4.13 分析设备 ...................................................................................................................................
4.14 显示 ..........................................................................................................................................
4.15 接收器 .......................................................................................................................................
4.15.1 同步点 ..............................................................................................................................
4.16 存储 ..........................................................................................................................................
4.16.1 存储模式 ..........................................................................................................................
4.16.2 记录 ..................................................................................................................................
4.16.3 查找 ..................................................................................................................................
4.16.4 回放 ..................................................................................................................................
4.17 安全 ...........................................................................................................................................
5 WEB 服务框架 ............................................................................................................................. 38
5.1 服务概述 ....................................................................................................................................
5.1.1 服务要求 ............................................................................................................................
5.2 WSDL概述 ...................................................................................................................................
5.3 命名空间 ....................................................................................................................................
第 1 页
19
20
23
24
24
24
25
25
25
26
26
26
26
26
27
27
28
28
30
31
31
32
34
34
34
34
35
35
36
36
37
37
38
38
39
40
ONVIF2.0中文协议原版
42
43
43
5.4 类型 ............................................................................................................................................
5.5 消息 ............................................................................................................................................
5.6 操作 .............................................................................................................................................
5.6.1 单向操作 ............................................................................................................................
44
5.6.2 要求 - 应答操作类型 .......................................................................................................... 44
45
5.7 端口类型 .....................................................................................................................................
5.8 绑定 ............................................................................................................................................
5.9 端口 ............................................................................................................................................
5.10 服务 ...........................................................................................................................................
5.11 错误处理 ...................................................................................................................................
5.11.1 协议错误 ..........................................................................................................................
5.11.2 SOAP 错误 .......................................................................................................................
45
46
46
46
46
46
5.11.2.1 常见的故障 ............................................................................................................................... 47
5.11.2.2 具体的错误 .............................................................................................................................. 49
5.11.2.3 HTTP 错误 ................................................................................................................................. 49
5.12 安全 ..........................................................................................................................................
50
5.12.1 基于用户访问控制 .......................................................................................................... 50
5.12.2 用户令牌配置文件 .......................................................................................................... 50
5.12.2.1 密码推导 ................................................................................................................................... 51
5.12.2.1.1 例子 ................................................................................................................................. 51
6 IP 配置 ........................................................................................................................................ 52
7 设备发现 ..................................................................................................................................... 52
7.1 概述 .............................................................................................................................................
7.2 操作模式 .....................................................................................................................................
7.3 发现定义 ....................................................................................................................................
7.3.1 终端参考 ............................................................................................................................
7.3.2 服务地址 ............................................................................................................................
..................................................................................................................................
7.3.3 Hello
52
52
53
53
53
53
7.3.3.1 类型 ............................................................................................................................................. 53
7.3.3.2 范围 ............................................................................................................................................. 53
7.3.3.2.1 例子 .................................................................................................................................... 54
7.3.3.3 地址 ............................................................................................................................................ 55
7.3.4 探头和探头匹配 ................................................................................................................
7.3.5 解决和解决匹配 ................................................................................................................
7.3.6 BYE ......................................................................................................................................
7.3.7 SOAP 错误信息 .................................................................................................................
7.4 远程发现扩展 ............................................................................................................................
7.4.1 网络情景 ............................................................................................................................
7.4.2 发现代理 ............................................................................................................................
55
55
55
55
56
56
58
7.4.2.1 直接的 DP地址配置 .................................................................................................................. 59
7.4.2.2 域名服务记录的查找 ................................................................................................................ 59
7.4.3 远程 hello 和探头行为 .................................................................................................... 59
7.4.4 客户端行为 ........................................................................................................................
60
第 2 页
ONVIF2.0中文协议原版
7.4.4.1 NVC 本地 DP配置 ...................................................................................................................... 60
7.4.5 安全 ....................................................................................................................................
61
7.4.5.1 本地发现 .................................................................................................................................... 61
7.4.5.2 远程发现 .................................................................................................................................... 61
8 设备管理 ...................................................................................................................................... 62
62
68
70
62
62
68
69
68
68
8.1 功能 .............................................................................................................................................
8.1.1 获取 WSDL的 URL................................................................................................................
8.1.2 交换的功能 .........................................................................................................................
8.2 网络 .............................................................................................................................................
8.2.1 获取主机 .............................................................................................................................
8.2.2 设置主机名 .........................................................................................................................
8.2.3 获取 DNS配置 ...................................................................................................................
8.2.4 设置 DNS..............................................................................................................................
8.2.5 获取 NTP配置信息 .............................................................................................................
8.2.6 对设备设置 NTP.................................................................................................................
70
8.2.7 获取动态的 DNS设置 ......................................................................................................... 71
8.2.8 设置设备动态 DNS..............................................................................................................
71
8.2.9 获取网络接口配置 ............................................................................................................
72
8.2.10 设置网络接口配置 .......................................................................................................... 72
8.2.11 获取网络协议 ..................................................................................................................
74
8.2.12 设置网络协议 ..................................................................................................................
8.2.13 获取默认的网关 ..............................................................................................................
8.2.14 设置默认网关 ..................................................................................................................
8.2.15 获取 0 配置 ......................................................................................................................
8.2.16 设置 0 配置 ......................................................................................................................
8.2.17 获取 IP 地址过滤 ............................................................................................................
76
8.2.18 对 IP 地址过滤进行配置 ................................................................................................ 77
8.2.19 增加 IP 地址过滤 ............................................................................................................
77
8.2.20 移除 IP 地址过滤 ............................................................................................................
78
8.2.21 IEEE 802.11 配置 ........................................................................................................... 79
8.2.21.1 SSID .......................................................................................................................................... 79
74
74
75
75
76
8.2.21.2 基站模式 .................................................................................................................................. 79
8.2.21.3 多种无线网络配置 .................................................................................................................. 79
8.2.21.4 安全配置 .................................................................................................................................. 80
8.2.21.4.1 None 模式 ....................................................................................................................... 80
8.2.21.4.2 PSK 模式 .......................................................................................................................... 80
8.2.21.4.3 IEEE 802.1X-2004
模式 ............................................................................................... 80
8.2.21.5 获取 DOT11的性能 .................................................................................................................. 80
8.2.21.6 GetIEEE802.11 状态 ............................................................................................................... 81
8.2.21.7 扫描可用的 IEEE802.11 网络 ................................................................................................ 82
8.3 系统 .............................................................................................................................................
8.3.1 设备信息 .............................................................................................................................
8.3.2 获取系统的 URL..................................................................................................................
8.3.3 备份 .....................................................................................................................................
83
83
83
84
第 3 页
ONVIF2.0中文协议原版
89
89
87
88
8.3.4 恢复 .....................................................................................................................................
84
8.3.5 开始恢复系统 .....................................................................................................................
85
8.3.6 获取系统日期以及时间 ..................................................................................................... 85
8.3.7 设置系统日期以及时间 ..................................................................................................... 86
8.3.8 出厂默认配置 ....................................................................................................................
87
8.3.9 固件升级 ............................................................................................................................
8.3.10 开始固件升级 ..................................................................................................................
8.3.11 获取系统日志 ..................................................................................................................
8.3.12 获取支持信息 ..................................................................................................................
8.3.13 重启 ..................................................................................................................................
8.3.14 获取范围参数 ..................................................................................................................
8.3.15 设置范围参数 ...................................................................................................................
8.3.16 添加范围参数 ..................................................................................................................
8.3.17 移除范围参数 ..................................................................................................................
8.3.18 获取发现模式 ..................................................................................................................
8.3.19 设置发现模式 ..................................................................................................................
92
8.3.20 获取远程发现方式 .......................................................................................................... 93
8.3.21 设置远程发现方式 .......................................................................................................... 93
8.3.22 获取远程 DP地址 ............................................................................................................
94
8.3.23 配置远程 DP地址 ............................................................................................................
8.4 安全 .............................................................................................................................................
8.4.1 获取访问策略 .....................................................................................................................
8.4.2 设置访问策略 ....................................................................................................................
8.4.3 获取用户 ............................................................................................................................
8.4.4 创建用户 ............................................................................................................................
8.4.5 删除用户 ............................................................................................................................
8.4.6 对用户进行配置 ................................................................................................................
97
8.4.7 IEEE 802.1X 配置 ........................................................................................................... 98
8.4.7.1 创建 IEEE802.1X 配置 ............................................................................................................... 99
90
91
91
92
94
95
95
95
96
97
90
91
94
8.4.7.2 对 IEEE802.1X 配置 ................................................................................................................... 99
8.4.7.3 获取 IEEE802.1X 配置 ............................................................................................................ 100
8.4.7.4 获取 IEEE802.1X 配置 ............................................................................................................. 100
8.4.7.5 删除 IEEE802.1X 配置 ............................................................................................................ 101
8.4.8 创建签名证书 .................................................................................................................. 101
8.4.9 获取证书 ..........................................................................................................................
102
8.4.10 获取 CA证书 .................................................................................................................. 103
8.4.11 获取证书状态 ................................................................................................................. 103
8.4.12 设置证书状态 .......................................................................................................................... 103
8.4.13 获取证书请求 ............................................................................................................................. 104
8.4.14 获取客户证书状态 ........................................................................................................ 104
8.4.15 设置客户认证状态 ........................................................................................................ 105
8.4.16 下载设备证书 ................................................................................................................
105
8.4.17 利用私有密钥来链接下载设备证书 ............................................................................ 106
8.4.18 获取证书信息请求 ........................................................................................................ 107
第 4 页
ONVIF2.0中文协议原版
8.4.19 下载 CA证书 .................................................................................................................. 107
8.4.20 删除证书 ........................................................................................................................
108
8.4.21 获取远程用户 ................................................................................................................
8.4.22 设置远程用户 ................................................................................................................
109
8.4.23 获取终端参数 ................................................................................................................. 110
110
8.5.1 获取继电器 输出 ............................................................................................................. 110
8.5.2 对继电器输出进行配置 .................................................................................................. 111
8.5.3 继电器触发输出 ............................................................................................................... 111
112
8.5.4 辅助操作 ..........................................................................................................................
8.5 输入与输出 .............................................................................................................................
108
8.6 与服务相关的错误代码 ........................................................................................................... 112
9 设备 IO 服务 ............................................................................................................................... 118
9.1 视频输出 ...................................................................................................................................
9.1.1 获取视频输出集 ............................................................................................................
9.2 视频输出配置 ...........................................................................................................................
118
118
9.5 音频输出 ...................................................................................................................................
119
9.2.1 获取视频输出配置 ........................................................................................................ 119
9.2.2 设置视频输出配置 ........................................................................................................ 120
9.2.3 获取视频输出配置选项集 ............................................................................................ 120
121
121
9.3 视频源 .......................................................................................................................................
9.3.1 获取视频源 ....................................................................................................................
9.4 视频源配置 ...............................................................................................................................
9.4.1 获取视频源配置 ............................................................................................................
122
9.4.2 设置视频源配置 ............................................................................................................
122
9.4.3 获取视频源多个配置选项 ............................................................................................ 123
124
9.5.1 获取多个音频输出 ........................................................................................................ 124
124
9.6.1 获取音频输出配置 ........................................................................................................ 124
9.6.2 设置音频输出配置 ........................................................................................................ 125
9.6.3 获取音频输出多个配置选项 ........................................................................................ 125
126
9.6 音频输出配置 ...........................................................................................................................
9.7 音频源 .......................................................................................................................................
9.7.1 获取音频源 ....................................................................................................................
9.8 音频源配置 ...............................................................................................................................
9.8.1 获取音频源配置 ............................................................................................................
9.8.2 设置音频源配置 ............................................................................................................
127
9.8.3 获取音频源多个配置选项 ............................................................................................ 128
129
9.9.1 获取多个继电器输出 .................................................................................................... 129
9.9.2 设置继电器输出设置 .................................................................................................... 129
9.9.3 触发继电器输出 ............................................................................................................
130
9.10 服务错误码 .........................................................................................................................
9.9 继电器输出 ...............................................................................................................................
126
127
127
122
131
10 图像配置 .................................................................................................................................. 132
10.1 图像设置 .................................................................................................................................
132
第 5 页
ONVIF2.0中文协议原版
10.1.1 获取图像设置 .............................................................................................................. 133
10.1.2 设置图像设置 .............................................................................................................. 134
10.1.3 获取选项 ......................................................................................................................
135
10.1.4 移动 ..............................................................................................................................
135
10.1.5 获取运行选项 .............................................................................................................. 136
10.1.6 停止 ..............................................................................................................................
137
10.1.7 获取图像状态 .............................................................................................................. 137
138
10.2 服务错误码 .............................................................................................................................
11 媒体配置 .................................................................................................................................. 139
11.1 音视频编解码器 .....................................................................................................................
139
11.2 媒体文件 .................................................................................................................................
140
11.2.1 创建媒体文件 .............................................................................................................. 140
11.2.2 获取多个媒体文件 ...................................................................................................... 141
11.2.3 获取媒体文件 .............................................................................................................. 141
11.2.4 添加视频源配置 .......................................................................................................... 142
11.2.5 添加视频编码器配置 .................................................................................................. 142
11.2.6 添加音频源配置 .......................................................................................................... 143
11.2.7 添加音频源编码器配置 .............................................................................................. 144
11.2.8 添加云台配置 .............................................................................................................. 144
11.2.9 添加视频分析配置 ...................................................................................................... 145
11.2.10 添加元数据配置 ........................................................................................................ 146
11.2.11 添加音频输出配置 .................................................................................................... 147
11.2.12 添加音频解码器配置 ................................................................................................ 147
11.2.13 移除视频源配置 ........................................................................................................ 148
11.2.14 移除视频源编码器配置 ............................................................................................ 148
11.2.15 移除音频源编码器配置 ............................................................................................ 149
11.2.16 移除音频编码器配置 ................................................................................................ 149
11.2.17 移除云台配置 ............................................................................................................
150
11.2.18 移除视频分析配置 .................................................................................................... 151
11.2.19 移除元数据配置 ........................................................................................................ 151
11.2.20 移除音频输出配置 .................................................................................................... 152
11.2.21 移除音频编码器配置 ................................................................................................ 152
11.2.22 删除媒体文件 ............................................................................................................
153
11.3 视频源 .....................................................................................................................................
11.4 视频源配置 .............................................................................................................................
153
11.3.1 获取视频源集 .............................................................................................................. 154
154
11.4.1 获取视频源配置集 ...................................................................................................... 154
11.4.2 获取视频源配置 .......................................................................................................... 154
11.4.3 获取多个兼容视频源配置 .......................................................................................... 155
11.4.4 获取视频源配置选项 .................................................................................................. 155
11.4.5 设置视频源配置 .......................................................................................................... 156
156
11.5.1 获取多个视频编码器配置 .......................................................................................... 157
11.5.2 获取视频编码器配置 .................................................................................................. 157
11.5 视频编码器配置 .....................................................................................................................
第 6 页
ONVIF2.0中文协议原版
11.5.3 获取多个兼容视频解码器配置 .................................................................................. 157
11.5.4 获取视频编码器配置选项集 ...................................................................................... 158
11.5.5 修改视频编码器配置 .................................................................................................. 159
11.5.6 获取有效的视频编码数量 .......................................................................................... 160
160
11.6.1 获取多个音频源 .......................................................................................................... 160
161
11.6 音频源 .....................................................................................................................................
11.7 音频源配置 .............................................................................................................................
11.9 视频分析配置 .........................................................................................................................
11.10 元数据配置 ...........................................................................................................................
11.8 音频编码器配置 .....................................................................................................................
11.7.1 获取多个音频源配置 .............................................................................................................. 161
11.7.2 获取音频源配置 .......................................................................................................... 161
11.7.3 获取兼容音频源配置集 .............................................................................................. 162
11.7.4 获取音频源配置选项集 .............................................................................................. 162
11.7.5 修改音频源配置 .......................................................................................................... 163
164
11.8.1 获取多个音频编码器配置 .......................................................................................... 164
11.8.2 获取音频源编码器配置 .............................................................................................. 164
11.8.3 获取多个兼容音频编码器配置 .................................................................................. 165
11.8.4 获取音频编码器配置选项集 ...................................................................................... 165
11.8.5 设置音频编码配置 ...................................................................................................... 166
167
11.9.1 获取多个视频分析配置 .............................................................................................. 167
11.9.2 获取视频分析配置 ...................................................................................................... 168
11.9.3 获取多个兼容视频分析配置 ...................................................................................... 168
11.9.4 修改视频分析配置 ...................................................................................................... 169
169
11.10.1 获取多个元数据配置 ................................................................................................ 170
11.10.2 获取元数据配置 ........................................................................................................ 170
11.10.3 获取多个兼容元数据配置 ........................................................................................ 170
11.10.4 获取元数据配置选项集 ............................................................................................ 171
11.10.5 修改元数据配置 ........................................................................................................ 171
172
11.11.1 获取音频输出集 ........................................................................................................ 172
173
11.12.1 获取多个音频输出配置 ............................................................................................ 173
11.12.2 获取音频输出配置 .................................................................................................... 173
11.12.3 获取多个兼容音频输出配置 .................................................................................... 174
11.12.4 获取音频输出配置选项集 ........................................................................................ 174
11.12.5 设置音频输出配置 .................................................................................................... 175
175
11.13.1 获取多个音频解码器配置 ........................................................................................ 176
11.13.2 获取音频解码器配置 ................................................................................................ 176
11.13.3 获取兼容音频解码器配置集 .................................................................................... 176
11.13.4 获取音频解码器配置选项集 .................................................................................... 177
11.13.5 设置音频解码器配置 ................................................................................................ 178
178
11.13 音频解码器配置 ...................................................................................................................
11.11 音频输出 ...............................................................................................................................
11.12 音频输出配置 .......................................................................................................................
11.14 音频通道模式 .......................................................................................................................
第 7 页
ONVIF2.0中文协议原版
11.15 URI 流 ...................................................................................................................................
11.15.1 获取 Uri 流 ................................................................................................................
11.16 快照 .......................................................................................................................................
11.16.1 获取 Uri 快照 ............................................................................................................
11.17 组播 .......................................................................................................................................
11.17.1 开始组播流 ................................................................................................................
11.17.2 停止组播流 ................................................................................................................
11.18 同步点 ...................................................................................................................................
11.18.1 设置同步点 ................................................................................................................
181
11.19 服务具体的错误码 ........................................................................................................... 182
179
179
180
180
180
180
181
181
12 实时流 ..................................................................................................................................... 184
12.1 流媒体协议 .............................................................................................................................
12.1.1 传输格式 .........................................................................................................................
184
184
12.1.1.1 通过 UDP的 RTP数据传输 ..................................................................................................... 184
12.1.1.2 通过 TCP传输 RTP数据 ........................................................................................................ 184
12.1.1.3 RTP/RTSP/TCP ........................................................................................................................ 184
12.1.1.4 RTP/RTSP/HTTP/TCP .............................................................................................................. 184
12.1.2 媒体传输 ........................................................................................................................
184
12.1.2.1 RTP ........................................................................................................................................ 184
12.1.2.1.1 RTP 元数据流 ................................................................................................................ 186
12.1.2.2 RTCP ........................................................................................................................................ 187
12.1.2.2.1 媒体同步 ........................................................................................................................ 187
12.1.3 同步点 ............................................................................................................................
188
12.1.4 通过 RTP传输 JPEG....................................................................................................... 188
12.1.4.1 所有包的结构 ......................................................................................................................... 188
12.1.4.2 逻辑解码规范 ........................................................................................................................ 189
12.1.4.3 支持的彩色空间和采样因素 ................................................................................................. 190
12.1.4.4 像素长宽比处理 ..................................................................................................................... 190
12.1.4.5 隔行扫描处理 ........................................................................................................................ 190
12.2 媒体控制协议 .........................................................................................................................
12.2.1 流控制 .............................................................................................................................
190
190
12.2.1.1 RTSP ........................................................................................................................................ 191
12.2.1.1.1 保持 RTSP会话的方法 ................................................................................................. 192
12.2.1.1.2 RTSP 音频和视频同步 .................................................................................................. 192
12.2.1.1.4 RTSP 消息的例子 .......................................................................................................... 193
12.2.1.2 通过 HTTP的 RSTP................................................................................................................. 194
12.3 往回通道连接 .........................................................................................................................
194
12.3.1 RTSP 协议请求的标签 ................................................................................................... 194
12.3.2 双向连接的连接设置 ..................................................................................................... 194
12.3.2.1 例一:没有往回支持的服务 ................................................................................................ 195
12.3.2.2 例二:使用 ONVIF往回通道支持的服务 ............................................................................ 195
12.3.3 组播流 .............................................................................................................................
197
12.3.3.1 例:多播设置 ......................................................................................................................... 197
12.4 错误处理 .................................................................................................................................
197
第 8 页