ASHPD

ASHPD，全称为Aperture Science Handheld Portal Device，是一个基于Rust和zbus的XDG portals DBus接口封装。该库旨在提供一种简单的方式来与规范中定义的各种portals进行交互。它是C语言库https://github.com/flatpak/libportal的替代方案。

示例

请求窗口管理器选择一个颜色

use ashpd::desktop::Color;

async fn run() -> ashpd::Result<()> {
    let color = Color::pick().send().await?.response()?;
    println!("({}, {}, {})", color.red(), color.green(), color.blue());
    Ok(())
}

从用户的摄像头启动PipeWire流

use ashpd::desktop::camera::Camera;

pub async fn run() -> ashpd::Result<()> {
    let camera = Camera::new().await?;
    if camera.is_present().await? {
        camera.request_access().await?;
        let remote_fd = camera.open_pipe_wire_remote().await?;
        // 将remote_fd传递给GStreamer等
    }
    Ok(())
}

可选功能

功能	描述	默认
tracing	使用`tracing`库记录各种调试信息	否
tokio	在zbus依赖中启用tokio运行时	是
async-std	启用async-std运行时	否
backend	不稳定启用用于编写portals实现的API	否
glib	使所有枚举派生`glib::Enum`。标志目前不支持	否
gtk4	为`gdk4::RGBA`实现`From<Color>`。提供`WindowIdentifier::from_native`，接受`IsA<gtk4::Native>`	否
gtk4_wayland	提供`WindowIdentifier::from_native`，仅支持Wayland后端，接受`IsA<gtk4::Native>`	否
gtk4_x11	提供`WindowIdentifier::from_native`，仅支持X11后端，接受`IsA<gtk4::Native>`	否
pipewire	提供`ashpd::desktop::camera::pipewire_streams`，帮助您获取与检索到的文件描述符相关的各种摄像头流	否
raw_handle	为raw-window-handlecrate提供`WindowIdentifier::from_raw_handle`和`WindowIdentifier::as_raw_handle`	否
wayland	为wayland-clientcrate提供`WindowIdentifier::from_wayland`	否