mouce

Mouce 是一个用 Rust 编写的库，旨在帮助在不同平台间模拟和监听鼠标动作。

支持的平台

• Windows ✅
  • 在 Windows 10 上进行测试
  • 使用 User32 系统库
• MacOS ✅
  • 在安装了 Big Sur 的 MacBook Pro (Retina, 13-inch, Mid 2014) 上进行测试
  • 使用 CoreGraphics 和 CoreFoundation 框架
• 类 Unix 系统
  • X11 ✅
    • 在 i3wm Arch Linux 上进行测试
    • 使用 X11 和 XTest 库
  • 其他（部分支持） ❌
    • 对于其他系统，库默认使用 uinput
    • 在使用 uinput 时，库有一些限制
      • get_position 函数未实现，因为 uinput 不提供此功能
      • 其余动作在 KDE Wayland 和 sway 上工作并经过测试

库接口

/// Move the mouse to the given `x`, `y` coordinates
fn move_to(&self, x: usize, y: usize) -> Result<(), Error>;
/// Move the mouse relative to the current position
fn move_relative(&self, x_offset: i32, y_offset: i32) -> Result<(), Error>;
/// Get the current position of the mouse
fn get_position(&self) -> Result<(i32, i32), Error>;
/// Press down the given mouse button
fn press_button(&self, button: &MouseButton) -> Result<(), Error>;
/// Release the given mouse button
fn release_button(&self, button: &MouseButton) -> Result<(), Error>;
/// Click the given mouse button
fn click_button(&self, button: &MouseButton) -> Result<(), Error>;
/// Scroll the mouse wheel towards to the given direction
fn scroll_wheel(&self, direction: &ScrollDirection) -> Result<(), Error>;
/// Attach a callback function to mouse events
fn hook(&mut self, callback: Box<dyn Fn(&MouseEvent) + Send>) -> Result<CallbackId, Error>;
/// Remove the callback function with the given `CallbackId`
fn unhook(&mut self, callback_id: CallbackId) -> Result<(), Error>;
/// Remove all callback functions
fn unhook_all(&mut self) -> Result<(), Error>;

示例

此示例程序将鼠标从左向右移动；

use std::thread;
use std::time::Duration;

use mouce::Mouse;

fn main() {
    let mouse_manager = Mouse::new();

    let mut x = 0;
    while x < 1920 {
        mouse_manager.move_to(x, 540);
        x += 1;
        thread::sleep(Duration::from_millis(2));
    }
}

要查看更多示例，您可以通过运行查看文档；

cargo doc --open

CLI 二进制文件

mouce 随附一个示例 CLI 程序，该程序使用 mouce 库函数。您可以使用以下命令安装二进制文件；

cargo install mouce --features="cli"

并使用 mouce --help 获取更多详细信息。