Rust屏幕截图库xcap的使用

XCap是一个用Rust编写的跨平台屏幕捕获库，支持Linux(X11, Wayland)、MacOS和Windows。XCap支持屏幕截图和视频录制功能(部分功能仍在开发中)。

功能特性

• 跨平台支持: 可在Linux(X11, Wayland)、MacOS和Windows系统上运行
• 多种截图模式: 支持全屏截图和窗口截图
• 视频录制功能: 支持屏幕和窗口录制(部分功能仍在开发)

平台支持情况

✅: 功能可用
⛔: 功能可用但可能有部分限制
🛠️: 开发中

完整示例代码

1. 屏幕捕获完整示例

use fs_extra::dir;
use std::time::Instant;
use xcap::Monitor;

// 处理文件名中的特殊字符
fn normalized(filename: String) -> String {
    filename.replace(['|', '\\', ':', '/'], "")
}

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 记录开始时间
    let start = Instant::now();
    
    // 获取所有显示器
    let monitors = Monitor::all()?;
    
    // 创建保存目录
    dir::create_all("screenshots", true)?;

    // 遍历所有显示器并截图
    for monitor in monitors {
        // 捕获当前显示器图像
        let image = monitor.capture_image()?;
        
        // 保存图像文件
        image.save(format!(
            "screenshots/monitor-{}.png",
            normalized(monitor.name()?)
        ))?;
    }

    // 输出运行耗时
    println!("截图完成，耗时: {:?}", start.elapsed());
    Ok(())
}

2. 窗口捕获完整示例

use fs_extra::dir;
use std::{time::Instant, path::Path};
use xcap::Window;

// 处理文件名特殊字符
fn sanitize_filename(filename: &str) -> String {
    filename.replace(['|', '\\', ':', '/', '*', '?', '"', '<', '>'], "")
}

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 确保输出目录存在
    let output_dir = "window_captures";
    if !Path::new(output_dir).exists() {
        dir::create_all(output_dir, true)?;
    }

    // 获取所有窗口
    let windows = Window::all()?;
    let start = Instant::now();

    // 遍历窗口并截图
    for (i, window) in windows.into_iter().enumerate() {
        // 跳过最小化窗口
        if window.is_minimized()? {
            continue;
        }

        // 获取窗口信息
        let title = window.title().unwrap_or_else(|_| "untitled".to_string());
        println!("正在捕获窗口 {}: {}", i, title);

        // 捕获窗口图像
        match window.capture_image() {
            Ok(image) => {
                // 保存图像文件
                let filename = format!(
                    "{}/window-{}-{}.png",
                    output_dir,
                    i,
                    sanitize_filename(&title)
                );
                image.save(filename)?;
            }
            Err(e) => eprintln!("无法捕获窗口 {}: {:?}", i, e),
        }
    }

    println!("窗口捕获完成，耗时: {:?}", start.elapsed());
    Ok(())
}

3. 屏幕录制完整示例

use std::{
    thread, 
    time::{Duration, Instant},
    path::Path,
    fs
};
use xcap::Monitor;
use image::ImageFormat;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 准备输出目录
    let output_dir = "screen_recordings";
    if !Path::new(output_dir).exists() {
        fs::create_dir(output_dir)?;
    }

    // 获取主显示器
    let monitor = Monitor::primary()?;
    println!("将在显示器 {} 上录制", monitor.name()?);

    // 创建录制器
    let (recorder, rx) = monitor.video_recorder()?;
    let recording_duration = Duration::from_secs(5);
    
    // 启动录制线程
    let handle = thread::spawn(move || {
        let mut frame_count = 0;
        let start_time = Instant::now();
        
        while let Ok(frame) = rx.recv() {
            // 保存帧为图像
            let filename = format!("{}/frame_{}.png", output_dir, frame_count);
            if let Err(e) = frame.save_with_format(filename, ImageFormat::Png) {
                eprintln!("保存帧 {} 失败: {:?}", frame_count, e);
            }
            frame_count += 1;
        }
        
        println!("录制线程结束，共捕获 {} 帧", frame_count);
        start_time.elapsed()
    });

    // 开始录制
    println!("开始录制...");
    recorder.start()?;
    thread::sleep(recording_duration);
    
    // 停止录制
    println!("停止录制...");
    recorder.stop()?;
    
    // 等待录制线程结束
    let elapsed = handle.join().unwrap();
    println!("实际录制时间: {:?}", elapsed);
    
    Ok(())
}

Linux系统依赖

在不同Linux发行版上需要安装以下依赖:

Debian/Ubuntu:

sudo apt-get install pkg-config libclang-dev libxcb1-dev libxrandr-dev libdbus-1-dev libpipewire-0.3-dev libwayland-dev libegl-dev

Alpine Linux:

sudo apk add pkgconf llvm19-dev clang19-dev libxcb-dev libxrandr-dev dbus-dev pipewire-dev wayland-dev mesa-dev

Arch Linux:

sudo pacman -S base-devel clang libxcb libxrandr dbus libpipewire

许可证信息

XCap库采用Apache License 2.0开源协议授权。