ONVIF WS-Discovery 发现服务介绍
ONVIF WS-Discovery 是 ONVIF（Open Network Video Interface Forum，开放式网络视频接口论坛）标准中用于在局域网内自动发现网络视频设备（如 IP 摄像机、NVR 等）的核心机制。它基于 OASIS 制定的WS-Discovery（Web Services Dynamic Discovery）协议规范，让客户端无需预先知道设备的 IP 地址就能找到网络上的 ONVIF 兼容设备。
一、基本原理
WS-Discovery 是一种多播发现协议，工作在 UDP 之上，通过向特定的多播地址发送 SOAP 格式的探测消息来发现设备。
关键参数：
| 项目 | 值 |
|---|---|
| 多播地址 (IPv4) | 239.255.255.250 |
| 多播地址 (IPv6) | FF02::C |
| UDP 端口 | 3702 |
| 消息格式 | SOAP 1.2 over UDP |
| XML 命名空间 | http://schemas.xmlsoap.org/ws/2005/04/discovery |
二、工作模式
WS-Discovery 定义了两种运行模式：
1. Ad-hoc 模式（无中心模式）
这是 ONVIF 最常用的方式。客户端直接向多播地址发送 Probe 消息，网络中的所有 ONVIF 设备监听该地址并做出响应。适用于局域网内的即插即用场景。
2. Managed 模式（托管模式）
需要一个 Discovery Proxy（发现代理）作为中心节点，设备向其注册，客户端向代理查询。适用于跨子网或大规模网络环境。
三、核心消息类型
WS-Discovery 定义了四种主要的 SOAP 消息：
Hello：设备上线时主动发送的多播通知，告知网络"我来了"，包含设备的 EndpointReference（唯一标识符）、Types（设备类型）、Scopes（作用域）和 XAddrs（服务地址）。
Bye：设备下线前发送的多播通知，告知网络"我要走了"。
Probe：客户端发送的多播探测请求，用于查找符合特定条件（Types 和 Scopes 过滤）的设备。
ProbeMatch：设备收到 Probe 后，若匹配过滤条件，则以单播 UDP 方式回复客户端，包含自身的服务访问地址（XAddrs）。
此外还有Resolve和ResolveMatch，用于通过 EndpointReference 查询具体的传输地址。
四、ONVIF 中的具体应用
在 ONVIF 规范中，WS-Discovery 用于设备发现阶段，是 ONVIF 交互流程的第一步。
典型发现流程时序图：
┌──────────────┐ ┌──────────────┐ │ 客户端软件 │ │ ONVIF 摄像头 │ │ (NVR/VMS) │ │ (IPC) │ └──────┬───────┘ └──────┬───────┘ │ │ │ ① Probe 探测请求 (多播到 239.255.255.250:3702) │─────────────────────────────────────────> │ │ │ ② ProbeMatch 响应 (单播返回给客户端) │ 包含: XAddrs (设备服务地址URL) │ <───────────────────────────────────────│ │ │ │ ③ 通过 XAddrs 获取设备能力 (GetCapabilities) │─────────────────────────────────────────> │ │ │ ④ 获取媒体地址、RTSP流地址等 │ <───────────────────────────────────────│流程步骤详解：
① Probe 探测：客户端（如 VMS 软件）构造一个 Probe SOAP 消息，Types 字段通常设为
dn:NetworkVideoTransmitter（网络视频发射器，即 IP 摄像机）或tds:Device，通过 UDP 多播发送到239.255.255.250:3702。② ProbeMatch 响应：网络内所有 ONVIF 设备接收该消息，匹配条件的设备以单播方式回复 ProbeMatch。响应中的XAddrs字段包含设备的 Device Service 地址，通常形如
http://192.168.1.100/onvif/device_service。③ GetCapabilities 能力查询：客户端拿到 XAddrs 后，通过 HTTP/SOAP 调用
GetCapabilities接口，获取设备支持的服务能力（Media、PTZ、Imaging、Events 等）及各自的服务地址。此阶段通常需要通过 WS-UsernameToken 进行认证。④ 获取媒体流信息：客户端再调用 Media Service 的
GetProfiles、GetStreamUri等接口，最终获取到 RTSP 播放地址（如rtsp://192.168.1.100:554/Streaming/Channels/101），从而开始拉取实时视频流。
五、Scopes 作用域机制
ONVIF 对 WS-Discovery 的 Scopes 字段做了扩展定义，用于描述设备的属性。常见 Scopes 包括：
onvif://www.onvif.org/type/video_encoder— 设备类型onvif://www.onvif.org/hardware/<model>— 硬件型号onvif://www.onvif.org/name/<name>— 设备名称onvif://www.onvif.org/location/<location>— 安装位置onvif://www.onvif.org/Profile/Streaming— 支持的 Profile
客户端可以在 Probe 中指定 Scopes 过滤条件，只发现符合特定属性的设备。
六、实现要点与注意事项
网络要求：由于依赖多播，WS-Discovery 通常只能在同一广播域（子网）内工作。跨路由器的场景需路由器支持多播转发或使用 Discovery Proxy。
MessageID 与 RelatesTo：每条 SOAP 消息带有唯一的 MessageID（UUID 形式），响应消息通过 RelatesTo 字段关联到请求，用于去重和匹配。
响应延迟：为避免大量设备同时回复造成网络风暴，规范要求设备在 0 到 APP_MAX_DELAY（默认 500ms）之间的随机时间后再回复。
安全性：WS-Discovery 本身不做认证，任何设备都可回复。因此发现后必须通过 ONVIF 的 WS-Security（用户名令牌）进行认证才能访问设备功能。
防火墙：需要放行 UDP 3702 端口以及多播流量。
七、常用开发库
实现 ONVIF WS-Discovery 时，常用的库和工具包括：
- gSOAP（C/C++）— ONVIF 官方推荐的 SOAP 框架，含 wsdd 插件
- python-ws-discovery / onvif-zeep（Python）
- onvif-java、onvif-nvc（Java）
- ONVIF Device Manager、ONVIF Device Test Tool— 常用测试工具
