onvif相关的http api有哪些功能点

ONVIF 提供了一系列 HTTP API，用于访问和控制支持 ONVIF 的设备。这些 API 基于 SOAP 协议，通过 HTTP 协议传输。主要的 API 分为几个关键的服务类别，每个类别都有特定的操作。以下是 ONVIF 相关的 HTTP API 概述：

1. 设备管理服务 (Device Management Service)

设备管理服务用于获取和设置设备的基本信息和配置。

• GetCapabilities: 获取设备的能力，包括可用的服务类型。

• GetDeviceInformation: 获取设备的基本信息，如制造商、型号、固件版本等。

• GetSystemDateAndTime: 获取设备的当前系统时间和日期。

• SetSystemDateAndTime: 设置设备的系统时间和日期。

• GetNetworkInterfaces: 获取设备的网络接口信息。

• SetNetworkInterfaces: 配置设备的网络接口。

• Reboot: 重启设备。

2. 媒体服务 (Media Service)

媒体服务用于获取和配置设备的视频流和音频流。

• GetProfiles: 获取设备的所有媒体配置文件（Profiles）。

• GetStreamUri: 获取指定媒体配置文件的视频流 URI。

• GetSnapshotUri: 获取静态图片的 URI（快照）。

• StartMulticastStreaming: 开始多播流媒体传输。

• StopMulticastStreaming: 停止多播流媒体传输。

• SetVideoEncoderConfiguration: 配置视频编码设置。

3. PTZ 控制服务 (PTZ Service)

PTZ 服务用于控制设备的云台功能。

• GetConfigurations: 获取 PTZ 配置。

• GotoPreset: 移动摄像机到预设位置。

• ContinuousMove: 开始持续移动摄像机。

• RelativeMove: 相对移动摄像机。

• AbsoluteMove: 绝对移动摄像机。

• Stop: 停止摄像机的 PTZ 移动。

4. 事件服务 (Event Service)

事件服务用于管理和订阅设备的事件通知。

• GetEventProperties: 获取事件源、数据和触发条件的信息。

• CreatePullPointSubscription: 创建一个拉取式事件订阅。

• PullMessages: 从订阅的 PullPoint 中获取事件消息。

• Unsubscribe: 取消事件订阅。

5. 分析服务 (Analytics Service)

分析服务用于访问和配置设备的智能分析功能。

• GetAnalyticsModules: 获取设备上配置的分析模块。

• GetSupportedAnalyticsModules: 获取设备支持的分析模块类型。

• GetAnalyticsEngines: 获取设备上的分析引擎信息。

使用 SOAP 访问 ONVIF HTTP API

ONVIF API 使用 SOAP（Simple Object Access Protocol）消息传递格式。以下是一个访问 ONVIF API 的示例 SOAP 请求：

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:tds="http://www.onvif.org/ver10/device/wsdl">
   <soap:Header/>
   <soap:Body>
      <tds:GetDeviceInformation/>
   </soap:Body>
</soap:Envelope>

访问 ONVIF API 的步骤

1. 获取设备的 XAddr: 首先需要通过 WS-Discovery 获取设备的服务地址（XAddr），这通常是在设备的 IP 地址和端口上，例如 http://<device-ip>:<device-port>/onvif/device_service。

2. 发送 HTTP 请求: 使用 HTTP POST 方法发送 SOAP 消息到设备的服务地址。

3. 解析 SOAP 响应: 解析设备返回的 SOAP 消息，以获取请求的结果。

常用工具

• ONVIF Device Manager: 一个免费的 Windows 工具，用于发现和管理网络中的 ONVIF 设备。

• Postman: 可以用来手动发送和测试 SOAP 请求。

通过这些服务和 API，您可以远程管理和控制 ONVIF 兼容的设备，实现设备监控和集成。