ONVIF-rs 开源项目教程

最新推荐文章于 2025-04-19 09:08:02 发布

司莹嫣Maude

最新推荐文章于 2025-04-19 09:08:02 发布

阅读量527

点赞数 5

本文链接：https://blog.csdn.net/gitblog_00002/article/details/141740506

版权

ONVIF-rs 开源项目教程

onvif-rsA native Rust ONVIF client library.项目地址:https://gitcode.com/gh_mirrors/on/onvif-rs

项目介绍

ONVIF-rs 是一个用 Rust 编写的 ONVIF 客户端库，实现了 ONVIF 规范。ONVIF 是一个广泛应用于 IP 摄像机和其他视频监控设备的标准协议。该项目的主要特点包括：

所有 ONVIF 类型和操作都是从官方模式生成的。
操作是异步的，目前仅支持 tokio 运行时。
支持本地网络上的设备发现（使用 WS-Discovery）。

项目快速启动

安装依赖

首先，确保你已经安装了 Rust 和 Cargo。然后，在 Cargo.toml 文件中添加以下依赖：

[dependencies]
onvif = { git = "https://github.com/lumeohq/onvif-rs" }

示例代码

以下是一个简单的示例，展示如何在本地网络上发现 ONVIF 设备并获取其 RTSP 流 URL：

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 发现本地网络上的所有 ONVIF 设备
    let mut devices = onvif_cam_rs::client::discover().await?;
    let mut cameras: Vec<onvif_cam_rs::device::camera::Camera> = Vec::new();

    // 枚举所有发现的摄像机设备
    for device in devices {
        let mut camera = onvif_cam_rs::device::camera::Camera::new(device);
        camera.build_all().await?;
        cameras.push(camera);
    }

    // 获取第一个摄像机的 RTSP 流 URL
    match &cameras[0].stream_uri {
        Some(url) => println!("Stream uri: {}", url),
        None => panic!("Ooops"),
    }

    Ok(())
}

应用案例和最佳实践

设备发现

ONVIF-rs 库支持通过 WS-Discovery 协议在本地网络上发现 ONVIF 设备。以下是一个简单的设备发现示例：

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let devices = onvif_cam_rs::client::discover().await?;
    for device in devices {
        println!("Found device: {:?}", device);
    }
    Ok(())
}

设备控制

你可以使用 ONVIF-rs 库来控制和查询 ONVIF 设备的各种功能，例如获取系统日期和时间、设置主机名等。以下是一个示例：

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let uri = "http://192.168.0.2:8000";
    let camera = onvif_cam_rs::device::camera::Camera::new(uri.to_string());
    let system_date_and_time = camera.get_system_date_and_time().await?;
    println!("System date and time: {:?}", system_date_and_time);
    Ok(())
}