WindowsInput：轻松捕获与模拟键盘鼠标输入

最新推荐文章于 2025-02-14 00:15:00 发布

乔或婵

最新推荐文章于 2025-02-14 00:15:00 发布

阅读量691

点赞数 6

本文链接：https://blog.csdn.net/gitblog_00245/article/details/142238544

版权

WindowsInput：轻松捕获与模拟键盘鼠标输入

WindowsInput Capture and Simulate Keyboard and Mouse Input 项目地址: https://gitcode.com/gh_mirrors/wi/WindowsInput

项目介绍

WindowsInput 是一个强大的 .NET (C#) 库，旨在简化在 Windows 平台上捕获和模拟键盘及鼠标输入的过程。通过利用 Win32 API 的 SetWindowsHook 和 SendInput 函数，WindowsInput 提供了一套简洁易用的编程模型，使得开发者能够轻松实现复杂的输入操作。无论是自动化测试、游戏脚本编写，还是系统自动化任务，WindowsInput 都能为你提供强大的支持。

项目技术分析

WindowsInput 的核心技术基于 Win32 API 的底层调用，通过 SetWindowsHook 实现全局键盘和鼠标事件的捕获，而 SendInput 则用于模拟输入事件。项目内部已经完成了所有的互操作细节，开发者只需通过简单的 API 调用即可实现复杂的输入操作。

主要技术点：

全局钩子（Global Hooks）：通过 SetWindowsHook 实现全局键盘和鼠标事件的捕获，确保能够监听到系统中所有应用程序的输入事件。
输入模拟（Input Simulation）：利用 SendInput 函数模拟键盘和鼠标的输入事件，支持单键、组合键、文本输入等多种操作。
异步事件处理：支持异步事件处理，确保在捕获和模拟输入时不会阻塞主线程。

项目及技术应用场景

WindowsInput 的应用场景非常广泛，以下是一些典型的应用案例：

自动化测试：在自动化测试中，WindowsInput 可以模拟用户的键盘和鼠标操作，自动执行测试用例，提高测试效率。
游戏脚本：游戏开发者可以使用 WindowsInput 编写脚本，自动执行游戏中的某些操作，如自动打怪、自动采集等。
系统自动化：在系统管理中，WindowsInput 可以用于自动化执行某些重复性任务，如自动登录、自动填写表单等。
辅助工具：开发辅助工具时，WindowsInput 可以用于捕获用户的输入并进行处理，如屏蔽某些按键、替换特定文本等。

项目特点

简单易用：WindowsInput 提供了一套简洁的 API，开发者无需深入了解底层 Win32 API 即可轻松实现复杂的输入操作。
功能强大：支持全局键盘和鼠标事件的捕获与模拟，能够处理单键、组合键、文本输入等多种输入操作。
异步支持：支持异步事件处理，确保在捕获和模拟输入时不会阻塞主线程，提高应用的响应速度。
跨平台兼容：虽然项目名称中包含“Windows”，但其核心技术基于 .NET，理论上可以在支持 .NET 的平台上运行。

如何开始

你可以通过 NuGet 包管理器轻松安装 WindowsInput：

Install-Package WindowsInput

安装完成后，即可在项目中引入 WindowsInput 并开始使用。

示例代码

以下是一些简单的示例代码，展示了如何使用 WindowsInput 捕获和模拟键盘输入：

示例1：自动打开记事本并输入文本

public async Task RunNotepad() {
    await WindowsInput.Simulate.Events()
        // 按下 Win+R 组合键
        .ClickChord(KeyCode.LWin, KeyCode.R).Wait(1000)

        // 输入 "notepad"
        .Click("notepad").Wait(1000)

        // 按下 Enter 键
        .Click(KeyCode.Return).Wait(1000)

        // 输入文本
        .Click("These are your orders if you choose to accept them...")
        .Click("This message will self destruct in 5 seconds.").Wait(5000)

        // 按下 Alt+F4 组合键
        .ClickChord(KeyCode.Alt, KeyCode.F4).Wait(1000)

        // 按下 Tab 键，然后按下 Enter 键
        .Click(KeyCode.Tab, KeyCode.Return)

        // 执行操作
        .Invoke()
        ;
}

示例2：捕获键盘输入并禁用 'a' 键

public static void Main(){
    using (var Keyboard = WindowsInput.Capture.Global.KeyboardAsync()) {
        // 捕获所有键盘事件
        Keyboard.KeyEvent += Keyboard_KeyEvent;
        Console.ReadLine();
    }
}

private static void Keyboard_KeyEvent(object sender, EventSourceEventArgs<KeyboardEvent> e) {
    
    if(e.Data?.KeyDown?.Key == WindowsInput.Events.KeyCode.A || e.Data?.KeyUp?.Key == WindowsInput.Events.KeyCode.A) {
        e.Next_Hook_Enabled = false;
    }

}