当前位置：首页 > news >正文

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

news 2025/9/1 9:57:38

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 的步骤

获取设备的 XAddr: 首先需要通过 WS-Discovery 获取设备的服务地址（XAddr），这通常是在设备的 IP 地址和端口上，例如 http://<device-ip>:<device-port>/onvif/device_service。
发送 HTTP 请求: 使用 HTTP POST 方法发送 SOAP 消息到设备的服务地址。
解析 SOAP 响应: 解析设备返回的 SOAP 消息，以获取请求的结果。