ONVIF2.0中文协议原版.docx

ONVIF2.0中文协议原版 1 范围162 引用标准173 术语与定义193.1 定义193.2缩写204 概述234.1 Web 服务234.2 IP配置244.3设备发现244.4设备类型244.5设备管理254.5.1 功能254.5.2 网络254.5.3 系统264.5.4 系统信息检索264.5.5 固件升级264.5.6 系统还原264.5.7 安全264.6 设备IO274.7 图像配置274.8 媒体配置284.8.1 媒体配置文件284.9 实时流304.10 事件处理314.11 PTZ控制314.12 视频分析324.13分析设备344.14 显示344.15接收器344.15.1 同步点344.16 存储354.16.1 存储模式354.16.2 记录364.16.3 查找364.16.4 回放374.17安全375 WEB服务框架385.1 服务概述385.1.1 服务要求385.2 WSDL概述395.3 命名空间405.4 类型425.5 消息435.6操作435.6.1 单向操作445.6.2 要求-应答操作类型445.7端口类型455.8 绑定455.9 端口465.10服务465.11错误处理465.11.1 协议错误465.11.2 SOAP错误4常见的故障4 具体的错误4 HTTP错误495.12 安全505.12.1 基于用户访问控制505.12.2 用户令牌配置文件50密码推导5.1 例子516 IP配置527 设备发现527.1概述527.2操作模式527.3 发现定义537.3.1 终端参考537.3.2 服务地址537.3.3 Hello5类型5范围5.1例子5 地址557.3.4 探头和探头匹配557.3.5 解决和解决匹配557.3.6 BYE557.3.7 SOAP错误信息557.4 远程发现扩展567.4.1 网络情景567.4.2 发现代理5 直接的DP地址配置5 域名服务记录的查找597.4.3 远程hello和探头行为597.4.4 客户端行为60 NVC 本地DP配置607.4.5 安全6 本地发现6 远程发现618设备管理628.1功能628.1.1获取WSDL的URL628.1.2交换的功能628.2网络688.2.1获取主机688.2.2设置主机名688.2.3 获取 DNS配置688.2.4设置DNS698.2.5获取NTP配置信息708.2.6 对设备设置NTP708.2.7获取动态的DNS设置718.2.8设置设备动态DNS718.2.9 获取网络接口配置728.2.10 设置网络接口配置728.2.11 获取网络协议748.2.12 设置网络协议748.2.13 获取默认的网关748.2.14 设置默认网关758.2.15 获取0配置758.2.16 设置0配置768.2.17 获取IP地址过滤768.2.18 对IP地址过滤进行配置778.2.19 增加IP地址过滤778.2.20 移除IP地址过滤788.2.21 IEEE 802.11配置7 SSID7 基站模式7 多种无线网络配置7 安全配置80.1 None 模式80.2 PSK模式80.3 IEEE 802.1X-2004 模式80 获取DOT11的性能80 GetIEEE802.11状态8 扫描可用的IEEE802.11网络828.3系统838.3.1设备信息838.3.2获取系统的URL838.3.3备份848.3.4恢复848.3.5开始恢复系统858.3.6获取系统日期以及时间858.3.7设置系统日期以及时间868.3.8 出厂默认配置878.3.9 固件升级878.3.10 开始固件升级888.3.11 获取系统日志898.3.12 获取支持信息898.3.13 重启908.3.14 获取范围参数908.3.15设置范围参数918.3.16 添加范围参数918.3.17 移除范围参数918.3.18 获取发现模式928.3.19 设置发现模式928.3.20 获取远程发现方式938.3.21 设置远程发现方式938.3.22 获取远程DP地址948.3.23 配置远程DP地址948.4安全948.4.1获取访问策略958.4.2 设置访问策略958.4.3 获取用户958.4.4 创建用户968.4.5 删除用户978.4.6 对用户进行配置978.4.7 IEEE 802.1X配置9创建IEEE802.1X配置9对IEEE802.1X配置9 获取IEEE802.1X配置100获取IEEE802.1X配置100 删除IEEE802.1X配置1018.4.8 创建签名证书1018.4.9 获取证书1028.4.10 获取CA证书1038.4.11获取证书状态1038.4.12 设置证书状态1038.4.13获取证书请求1048.4.14 获取客户证书状态1048.4.15 设置客户认证状态1058.4.16 下载设备证书1058.4.17 利用私有密钥来链接下载设备证书1068.4.18 获取证书信息请求1078.4.19 下载CA证书1078.4.20 删除证书1088.4.21 获取远程用户1088.4.22 设置远程用户1098.4.23获取终端参数1108.5 输入与输出1108.5.1获取继电器 输出1108.5.2 对继电器输出进行配置1118.5.3继电器触发输出1118.5.4 辅助操作1128.6与服务相关的错误代码1129设备IO服务1189.1视频输出1189.1.1 获取视频输出集1189.2视频输出配置1199.2.1 获取视频输出配置1199.2.2 设置视频输出配置1209.2.3 获取视频输出配置选项集1209.3视频源1219.3.1 获取视频源1219.4视频源配置1229.4.1 获取视频源配置1229.4.2 设置视频源配置1229.4.3 获取视频源多个配置选项1239.5音频输出1249.5.1 获取多个音频输出1249.6音频输出配置1249.6.1 获取音频输出配置1249.6.2 设置音频输出配置1259.6.3 获取音频输出多个配置选项1259.7音频源1269.7.1 获取音频源1269.8音频源配置1279.8.1 获取音频源配置1279.8.2 设置音频源配置1279.8.3 获取音频源多个配置选项1289.9继电器输出1299.9.1 获取多个继电器输出1299.9.2 设置继电器输出设置1299.9.3 触发继电器输出1309.10服务错误码13110图像配置13210.1图像设置13210.1.1 获取图像设置13310.1.2 设置图像设置13410.1.3 获取选项13510.1.4 移动13510.1.5 获取运行选项13610.1.6 停止13710.1.7 获取图像状态13710.2服务错误码13811媒体配置13911.1音视频编解码器13911.2媒体文件14011.2.1 创建媒体文件14011.2.2 获取多个媒体文件14111.2.3 获取媒体文件14111.2.4 添加视频源配置14211.2.5 添加视频编码器配置14211.2.6 添加音频源配置14311.2.7 添加音频源编码器配置14411.2.8 添加云台配置14411.2.9 添加视频分析配置14511.2.10 添加元数据配置14611.2.11 添加音频输出配置14711.2.12 添加音频解码器配置14711.2.13 移除视频源配置14811.2.14 移除视频源编码器配置14811.2.15 移除音频源编码器配置14911.2.16 移除音频编码器配置14911.2.17 移除云台配置15011.2.18 移除视频分析配置15111.2.19 移除元数据配置15111.2.20 移除音频输出配置15211.2.21 移除音频编码器配置15211.2.22 删除媒体文件15311.3视频源15311.3.1 获取视频源集15411.4视频源配置15411.4.1 获取视频源配置集15411.4.2 获取视频源配置15411.4.3 获取多个兼容视频源配置15511.4.4 获取视频源配置选项15511.4.5 设置视频源配置15611.5视频编码器配置15611.5.1 获取多个视频编码器配置15711.5.2 获取视频编码器配置15711.5.3 获取多个兼容视频解码器配置15711.5.4 获取视频编码器配置选项集15811.5.5 修改视频编码器配置15911.5.6 获取有效的视频编码数量16011.6音频源16011.6.1 获取多个音频源16011.7音频源配置16111.7.1 获取多个音频源配置16111.7.2 获取音频源配置16111.7.3 获取兼容音频源配置集16211.7.4 获取音频源配置选项集16211.7.5 修改音频源配置16311.8音频编码器配置16411.8.1 获取多个音频编码器配置16411.8.2 获取音频源编码器配置16411.8.3 获取多个兼容音频编码器配置16511.8.4 获取音频编码器配置选项集16511.8.5 设置音频编码配置16611.9视频分析配置16711.9.1 获取多个视频分析配置16711.9.2 获取视频分析配置16811.9.3 获取多个兼容视频分析配置16811.9.4 修改视频分析配置16911.10元数据配置16911.10.1 获取多个元数据配置17011.10.2 获取元数据配置17011.10.3 获取多个兼容元数据配置17011.10.4 获取元数据配置选项集17111.10.5 修改元数据配置17111.11音频输出17211.11.1 获取音频输出集17211.12音频输出配置17311.12.1 获取多个音频输出配置17311.12.2 获取音频输出配置17311.12.3 获取多个兼容音频输出配置17411.12.4 获取音频输出配置选项集17411.12.5 设置音频输出配置17511.13音频解码器配置17511.13.1 获取多个音频解码器配置17611.13.2 获取音频解码器配置17611.13.3 获取兼容音频解码器配置集17611.13.4 获取音频解码器配置选项集17711.13.5 设置音频解码器配置17811.14音频通道模式17811.15 URI流17911.15.1 获取Uri流17911.16快照18011.16.1 获取Uri快照18011.17组播18011.17.1 开始组播流18011.17.2 停止组播流18111.18同步点18111.18.1 设置同步点18111.19服务具体的错误码18212 实时流18412.1流媒体协议18412.1.1传输格式184通过UDP的RTP数据传输184 通过TCP传输RTP数据184 RTP/RTSP/TCP184 RTP/RTSP/HTTP/TCP18412.1.2 媒体传输184 RTP184.1 RTP元数据流186 RTCP187.1媒体同步18712.1.3 同步点18812.1.4 通过RTP传输JPEG188所有包的结构188 逻辑解码规范189支持的彩色空间和采样因素190像素长宽比处理190 隔行扫描处理19012.2媒体控制协议19012.2.1流控制190 RTSP19.1 保持RTSP会话的方法19.2 RTSP音频和视频同步19.4 RTSP消息的例子193 通过HTTP的RSTP19412.3往回通道连接19412.3.1 RTSP协议请求的标签19412.3.2双向连接的连接设置194 例一：没有往回支持的服务195 例二：使用ONVIF往回通道支持的服务19512.3.3组播流197例：多播设置19712.4错误处理19713 接收端配置19713.1 持久性19713.2 接收端模式19713.3 接收命令19813.3.1 获得多个接收器19813.3.2 获得单个接收器19813.3.3 创建接收器19813.3.4 删除接收器19913.3.5 配置接收器19913.3.6 设计接收器模式20013.3.7 获取接收机状态20013.4 事件20013.4.1 改变状态20013.4.2 连接失败20113.5 服务器错误码20114 显示服务20214.1 窗格20214.1.1 获得多个窗格配置20314.1.2 获得单个窗格配置20314.1.3 设置多个窗格配置20414.1.4 设置单个窗格配置20414.1.5 创建窗格配置20514.1.6 删除窗格配置20614.2 布局20614.2.1 获得布局20614.2.2 设置布局20714.3 显示选项20714.3.1 获取显示选项20814.4 事件20814.4.1 解码错误事件20814.5 服务错误码20915 事件处理21015.1 基本通知接口21015.1.1 介绍21015.1.2 要求21115.2 实时拉点通知接口21215.2.1 创建 pull point subscription21315.2.2 pull 消息21315.3 通知流接口21415.4 属性21415.4.1 属性举例21415.5 通知结构21515.5.1 通知消息215 事件例子21615.5.2 消息格式21615.5.3 属性举例，持续21815.5.4 信息描述语言219 消息描述举例22015.5.5 消息内容过滤器22115.6 同步点22215.7 主题结构22215.7.1 ONVIF主题名字空间22215.7.2 主题类型信息22315.7.3 主题过滤器22415.8 获取事件属性22515.9 SOAP错误消息22615.10 通知例子22615.10.1 获取事件属性请求22615.10.2 获取事件属性应答22715.10.3 创建PULLPOIT订阅22815.10.4 创建PULLPOIT订阅应答22915.10.5 拉消息请求23015.10.6 拉消息应答23015.10.7 退订请求23215.10.8 退订应答23215.11 服务错误码23316 PTZ控制23316.1 PTZ模型23416.2 PTZ节点23416.2.1 获取所有节点（GetNodes）23516.2.2 获取节点（GetNode）23516.3 PTZ配置23616.3.1 读取所有配置命令（GetConfigurations）23716.3.2 读取配置命令（GetConfiguration）23716.3.3 读取配置选项（GetConfigurationOptions）23716.3.4 设置配置（SetConfiguration）23816.4 移动操作23916.4.1 绝对的移动（AbsoluteMove）23916.4.2 相对移动（RelativeMove）24016.4.3 连续移动（ContinuousMove）24116.4.4 停止（Stop）24216.4.5 读取状态（GetStatus）24216.5 起始位置操作24316.5.1 设置预设值（SetPreset）24316.5.2 读取所有预设值（GetPresets）24416.5.3 返回预设24516.5.4 移除预设（RemovePreset）24616.6 归位点操作24616.6.1 转到归位点（GotoHomePosition）24616.6.2 设置归位点（SetHomePosition）24716.7 辅助操作24816.7.1 发送辅助命令（SendAuxiliaryCommand）24816.8 预定PTZ空间24816.8.1 绝对的位置空间249 泛化的全方位移动空间249 泛化的变焦位置空间24916.8.2 相对的转换空间249 泛化的方位转换空间250 泛化的变焦转换空间25016.8.3 连续的速率空间250 泛化的方位速率空间250 泛化的变焦速率空间25116.8.4 速度空间25 泛化的方位速度空间25 泛化的变焦速度空间25216.9 服务错误码25217 视频分析25517.1 场景描述接口25517.1.1 概述25517.1.2 画面相关内容255时间关系256 空间关系25617.1.3 场景元素258 对象258 对象树260 形状描述符26217.2 规则接口26317.2.1 规则陈述26317.2.2 规则描述语言26417.2.3 规则标准265 线性检测器265 域检测器26617.2.4 规则操作266 读取支持的操作（GetSupportedRules）267 读取规则（GetRules）267 创建规则（CreateRules）267 修改规则（ModifyRules）268 删除规则（DeleteRules）26917.3 分析模块接口26917.3.1 分析模块配置26917.3.2 分析模块描述语言27017.3.3 分析模块操作27 读取支持的分析模块（GetSupportedAnalysticsModule）27 读取模块分析（GetAnalyticsModules）27 创建分析模块（CreateAnalyticsModules）27 修改分析模块（ModifyAnalyticsModules）27 删除分析模块（DeleteAnalyticsModules）27317.4 服务错误码27318分析设备27518.1概述27518.2分析引擎输入27518.2.1获取分析引擎输入27618.2.2获取分析引擎的输入27618.2.3设置分析引擎的输入27718.2.4 创建分析引擎输入27718.2.5删除分析引擎输入27818.3 视频分析配置27818.3.1 获取视频分析配置27818.3.2 设置视频分析配置27918.4 分析引擎27918.4.1获取分析引擎28018.4.2 获取分析引擎28018.5 分析引擎控制28018.5.1 GetAnalyticsEngineControls28118.5.2 获取分析引擎控制28118.5.3设置分析引擎控制28218.5.4 CreateAnalyticsEngineControl28218.5.5删除分析引擎控制28318.6获取分析状态28418.7输出流配置28418.7.1 请求流的URL28419录制控制28519.1介绍28519.2一般要求28719.3数据结构28719.3.1 录制设置28719.3.2 轨迹设置28719.3.3 录制任务设置28719.4创建录制28819.5删除录制28919.6获取录制集28919.7设置录制配置29019.8获取录制配置29019.9创建轨道29019.10删除轨道29119.11获取轨道配置29219.12设置轨道配置29219.13创建录制任务29319.14删除录制任务29319.15获取录制任务集29419.16设置录制任务配置29419.17获取录制任务配置29519.18设置录制模式29519.19获取录制任务状态29619.20事件29719.20.1 录制任务状态变化29719.20.2 设置变化29719.20.3 删除数据29819.20.4 录制和轨道的建立与删除29819.21示例29919.21.1 例1：单摄像头的安装录制29919.21.2 例2：从一台摄像机录制多个流到一个单录制30020 记录搜索30120.1 介绍30120.2 概念30120.2.1 搜索方向30120.2.2 记录事件30120.2.3 查找对话30220.2.4 查找范围30 包括的数据30 记录信息滤波器30220.2.5 搜索过滤器30220.3数据结构30220.3.1 记录信息结构30220.3.2 记录源信息结构30320.3.3 跟踪信息结构30320.3.4 列举查找状态30320.3.5 媒体属性结构30320.3.6 找事件结果结构30420.3.7 找PTZ位置结果结构30420.3.8 PTZ位置过滤结构30420.3.9 元数据过滤结果30420.3.10 找元数据结果结构30420.4 获取记录概要（GetRecordingSummary）30420.5 读取记录信息（GetRecordingInformation）30520.6 读取媒体属性（GetMediaAttributes）30520.7 找记录（FindRecordings）30620.8 获取记录搜索结果（GetRecordingSearchResults）30620.9 找事件（FindEvents）30720.10 读取事件搜索结果（GetEventSearchResults）30820.11 查找PTZ位置（FindPTZPosition）30920.12读取PTZ位置搜索结果（GetPTZPositionSearchResults）31020.13查找元数据（FindMetadata）31020.14 读取元数据搜索结果（GetMetadataSearchResults）31120.15 获取搜索状态（GetSearchState）31220.16 结束搜索（EndSearch）31320.17 记录事件说明31320.18 XPath习惯用法31421 重放控制31621.1使用RTSP协议31621.1.1 RTSP描述31621.2 RTP协议头部扩展31621.2.1 NTP时间戳31721.2.2 压缩JEPG头扩展的兼容31721.3 RTSP特性标签31821.4 启动播放31821.4.1 领域范围31921.4.2 速度控制头领域31921.4.3 帧头字段31921.4.4 同步点32021.5 回放32021.5.1 数据包传输顺序32021.5.2 RTP传输顺序号32021.5.3 RTP时间戳32121.6 RTSP长连接32121.7 当前记录片段32121.8 结束片段32121.9 拖放32121.10 使用RTCP协议32221.11 重放命令32221.11.1 重放命令32221.11.2 重播配置32321.11.3 设置重播配置32321.11.4 获取重播配置32321.11.5 服务指定的误码32422 安全32422.1 传输层安全32522.1.1 支持密码套32522.1.2 服务器身份验证32522.1.3 客户端认证32522.2 消息安全32522.3 IEEE802.1X326介绍 ONVIF的目标是为了实现完全标准化的、可互操作性的网络视频服务，即使是由不同的网络视频供应商组成的产品。规范描述了网络视频模型，接口，数据类型和数据交换模式。规范使用了那些已经存在的的相关标准，并同时根据视频网络服务添加制定了一些必要的新规范。这是ONVIF的核心规范，另外，ONVIF已经发布了以下规范：ONVIF架构 ONVIF 架构ONVIF分析服务WSDL ONVIF 分析服务 WSDLONVIF解析设备服务 ONVIF 解析设备服务 WSDLONVIF设备服务WSDL ONVIF 设备 WSDLONVIF设备IO服务WSDL ONVIF 设备IO WSDLONVIF显示服务WSDL ONVIF 显示 WSDLONVIF事件服务WSDL ONVIF 事件 WSDLONVIF图像服务WSDL ONVIF 图像 WSDLONVIF媒体服务WSDL ONVIF 媒体 WSDLONVIF PTZ服务WSDL ONVIF PTZ WSDLONVIF记录服务WSDL ONVIF 记录 WSDLONVIF远程发现WSDL ONVIF 远程发现 WSDLONVIF重放服务WSDL ONVIF 重放 WSDLONVIF检索服务WSDL ONVIF 检索 WSDLONVIF主题XML命名空间ONVIF 主题命名空间文档是按照ONVIF的规范框架所编写的，ONVIF文档被分为以下几个部分：规范的综述：把规范的各个部分给出一个概要，以及它们之间的关联性网络服务框架：对网络服务和基于ONVIF的网络服务规范给出一个简要的介绍IP配置：规定ONVIF网络视频服务的IP配置要求设备发现：描述设备怎样被发现，在当地或远程的网络中设备管理：定义网络视频发射器管理命令设备IO：定义处理物理层的输入输出命令图形和媒体：定义与图像和媒体设置相关的配置命令实时流：为音视频流和元数据流提供需要事件处理:定义怎样同意和接收数据从网络视频事件（通知）PTZ控制:提供命令控制云台全方位（上下、左右）移动及镜头变倍、变焦视频分析：定义了ONVIF分析模式，分析对象描述和解析规则配置视频解析设备：定义命令处理视频解析设备记录控制：定义记录配置机制检索和重播控制：提供用于记录的包括元数据的检索命令安全章节：定义在ONVIF中数据的传输安全级别 1 范围本标准定义的是网络视频客户端和视频传输设备的通信规范。这个新的规范使不同的厂商提供的产品均可以通过一种统一的接口进行通信成为了可能。这些接口包括功能如：设备管理、实时的音视频流、事件处理，PTZ控制（云台全方位（上下、左右）移动及镜头变倍、变焦控制），视频分析及控制，搜索与回放。ONVIF规范中设备管理和控制部分所定义的接口均以Web Services的形式提供。为了引进网络视频服务，ONVIF规范包含了所有的XML及WSDL（Wed Service Description Language）的定义。为了达到完全的即插即用的操作性能,该标准定义了设备发现的规范。ONVIF中设备发现机制可看作是WS-Discovery的延伸。因为网络视频发现机制的需要，关于WS-Discovery的延伸也会在后面被讲到。ONVIF规范不仅具有设备的发现，配置和控制功能，而且在IP网络方面，ONVIF也为媒体和元数据流定义了严格的格式，此外，还在ONVIF中对规范做了一定的扩展，为了就是让制造商给客户提供一个完整的网络视频传输解决方案。2 引用标准ISO/IEC 14496-3:2005, Information technology - Coding of audio-visual objects - Part 3: AudioISO/IEC 14496-2:2004, Information technology - Coding of audio-visual objects - Part 2: VisualISO/IEC 14496-10:2008, Information technology - Coding of audio-visual objects - Part 10: Advanced Video CodingITU-T G.711, Pulse code modulation (PCM) of voice frequenciesITU-T G.726, 40, 32, 24, 16 kbit/s Adaptive Differential Pulse Code Modulation (ADPCM)RSA Laboratories, PKCS #10 v1.7: Certification Request Syntax Standard, RSA LaboratoriesFIPS 180-2, SECURE HASH STANDARDIETF RFC 2131, Dynamic Host Configuration ProtocolIETF RFC 2136, Dynamic Updates in the Domain Name System (DNS UPDATE)IETF RFC 2246, The TLS Protocol Version 1.0IETF RFC 2326, Real Time Streaming Protocol (RTSP)IETF RFC 2435, RFC2435 - RTP Payload Format for JPEG-compressed VideoIETF RFC 2616, Hypertext Transfer Protocol - HTTP/1.1IETF RFC 2617, HTTP Authentication: Basic and Digest Access AuthenticationIETF RFC 2782, A DNS RR for specifying the location of services (DNS SRV)IETF RFC 2818, HTTP over TLSIETF RFC 3268, Advanced Encryption Standard (AES) Cipher suites for Transport Layer Security (TLS)IETF RFC 3315, Dynamic Host Configuration Protocol for IPv6 (DHCPv6)IETF RFC 3548, The Base16, Base32, and Base64 Data EncodingsIETF RFC 3550, RTP: A Transport Protocol for Real-Time ApplicationsIETF RFC 3551, RTP Profile for Audio and Video Conferences with Minimal ControlIETF RFC 3927, Dynamic Configuration of IPv4 Link-Local AddressesIETF RFC 3984, RTP Payload Format for H.264 Video/rfc/rfc3984Universally Unique IDentifier (UUID) URN NamespaceIETF RFC 4346, The Transport Layer Security (TLS) Protocol Version 1.1IETF RFC 4566, SDP: Session Description ProtocolIETF RFC 4571, Framing Real-time Transport Protocol (RTP) and RTP Control Protocol (RTCP) Packets overConnection-Oriented TransportIETF RFC 4585, Extended RTP Profile for Real-time Transport Control Protocol (RTCP)-Based Feedback(RTP/AVPF)IETF 4702, The Dynamic Host Configuration Protocol (DHCP) Client Fully Qualified Domain Name (FQDN) OptionIETF 4861, Neighbor Discovery for IP version 6 (IPv6)IETF 4862, IPv6 Stateless Address Auto configurationIETF 5104, Codec Control Messages in the RTP Audio-Visual Profile with Feedback (AVPF)IETF 5246, The Transport Layer Security (TLS) Protocol Version 1.2W3C SOAP Message Transmission Optimization Mechanism,W3C SOAP 1.2, Part 1, Messaging FrameworkW3C SOAP Version 1.2 Part 2: Adjuncts (Second Edition)W3C Web Services Add