Rust设备输入监听库device_query的使用指南

device_query是一个跨平台的Rust库，用于监听和查询键盘鼠标输入事件。它支持Windows、Linux和macOS系统，可以方便地获取全局键盘和鼠标状态。

主要功能

• 监听键盘按键状态
• 监听鼠标按键和位置
• 跨平台支持
• 简单易用的API

基本使用方法

添加依赖

首先在Cargo.toml中添加依赖：

[dependencies]
device_query = "0.3.0"

监听键盘输入

use device_query::{DeviceQuery, DeviceState, Keycode};

fn main() {
    let device_state = DeviceState::new();
    
    loop {
        let keys: Vec<Keycode> = device_state.get_keys();
        if !keys.is_empty() {
            println!("当前按下的键: {:?}", keys);
        }
    }
}

监听鼠标输入

use device_query::{DeviceQuery, DeviceState};

fn main() {
    let device_state = DeviceState::new();
    
    loop {
        let mouse = device_state.get_mouse();
        println!("鼠标位置: {:?}, 按键: {:?}", mouse.coords, mouse.button_pressed);
    }
}

高级用法

组合键检测

use device_query::{DeviceQuery, DeviceState, Keycode};

fn main() {
    let device_state = DeviceState::new();
    
    loop {
        let keys = device_state.get_keys();
        if keys.contains(&Keycode::LControl) && keys.contains(&Keycode::C) {
            println!("检测到Ctrl+C组合键");
        }
    }
}

鼠标移动监听

use device_query::{DeviceQuery, DeviceState};

fn main() {
    let device_state = DeviceState::new();
    let mut last_position = (0, 0);
    
    loop {
        let mouse = device_state.get_mouse();
        if mouse.coords != last_position {
            println!("鼠标移动到: {:?}", mouse.coords);
            last_position = mouse.coords;
        }
    }
}

实际应用示例

简单的热键程序

use device_query::{DeviceQuery, DeviceState, Keycode};
use std::{thread, time::Duration};

fn main() {
    let device_state = DeviceState::new();
    
    println!("按下F1键退出程序...");
    
    loop {
        let keys = device_state.get_keys();
        if keys.contains(&Keycode::F1) {
            println!("检测到F1键，退出程序");
            break;
        }
        
        if keys.contains(&Keycode::LShift) && keys.contains(&Keycode::A) {
            println!("检测到Shift+A组合键");
        }
        
        thread::sleep(Duration::from_millis(50));
    }
}

鼠标点击计数器

use device_query::{DeviceQuery, DeviceState, MouseButton};
use std::{thread, time::Duration};

fn main() {
    let device_state = DeviceState::new();
    let mut click_count = 0;
    
    println!("鼠标点击计数器 (右键退出)...");
    
    loop {
        let mouse = device_state.get_mouse();
        
        if mouse.button_pressed.contains(&MouseButton::Left) {
            click_count += 1;
            println!("左键点击次数: {}", click_count);
            thread::sleep(Duration::from_millis(200)); // 防抖动
        }
        
        if mouse.button_pressed.contains(&MouseButton::Right) {
            println!("检测到右键点击，退出程序");
            break;
        }
        
        thread::sleep(Duration::from_millis(50));
    }
}

完整示例代码

use device_query::{DeviceQuery, DeviceState, Keycode, MouseButton};
use std::{thread, time::Duration};

fn main() {
    println!("设备输入监听程序启动");
    println!("功能列表:");
    println!("1. 按下F1键退出程序");
    println!("2. 按下Ctrl+C显示特殊提示");
    println!("3. 左键点击计数");
    println!("4. 右键点击退出");
    
    let device_state = DeviceState::new();
    let mut click_count = 0;
    let mut last_position = (0, 0);
    
    loop {
        // 监听键盘输入
        let keys = device_state.get_keys();
        if !keys.is_empty() {
            println!("当前按下的键: {:?}", keys);
            
            // 检测F1键退出
            if keys.contains(&Keycode::F1) {
                println!("检测到F1键，退出程序");
                break;
            }
            
            // 检测Ctrl+C组合键
            if keys.contains(&Keycode::LControl) && keys.contains(&Keycode::C) {
                println!("检测到Ctrl+C组合键 - 这是一个特殊操作");
            }
        }
        
        // 监听鼠标输入
        let mouse = device_state.get_mouse();
        
        // 检测鼠标移动
        if mouse.coords != last_position {
            println!("鼠标移动到: {:?}", mouse.coords);
            last_position = mouse.coords;
        }
        
        // 检测鼠标点击
        if mouse.button_pressed.contains(&MouseButton::Left) {
            click_count += 1;
            println!("左键点击次数: {}", click_count);
            thread::sleep(Duration::from_millis(200)); // 防抖动
        }
        
        if mouse.button_pressed.contains(&MouseButton::Right) {
            println!("检测到右键点击，退出程序");
            break;
        }
        
        // 降低CPU使用率
        thread::sleep(Duration::from_millis(50));
    }
}

注意事项

1. 在Linux上可能需要权限才能监听全局输入
2. 长时间运行的监听循环应该包含适当的延迟(thread::sleep)以减少CPU使用率
3. 某些特殊键可能在不同平台上表现不同

device_query库提供了简单直观的方式来监听输入设备，适合需要处理键盘鼠标输入的各种应用场景。