Golang 键盘输入捕获与处理 - xkg 库使用指南

xkg 是一个用于捕获和处理键盘输入的 Go 语言库，它提供了跨平台的键盘事件监听功能。下面我将详细介绍如何使用 xkg 库来捕获和处理键盘输入。

安装 xkg

首先需要安装 xkg 库：

go get github.com/jezek/xgb
go get github.com/jezek/xkg

基本使用方法

1. 初始化键盘监听

package main

import (
	"fmt"
	"log"
	"github.com/jezek/xkg"
)

func main() {
	// 初始化键盘监听
	keyboard, err := xkg.NewKeyboard()
	if err != nil {
		log.Fatal(err)
	}
	defer keyboard.Close()

	fmt.Println("键盘监听已启动，按ESC键退出...")

	// 开始监听键盘事件
	for key := range keyboard.KeyPress() {
		// 打印按键信息
		fmt.Printf("按键: %s (代码: %d)\n", key.String(), key.Code())
		
		// 检查是否是ESC键
		if key.Code() == xkg.KeyEscape {
			break
		}
	}
}

2. 监听特定按键组合

func listenForHotkeys() {
	keyboard, err := xkg.NewKeyboard()
	if err != nil {
		log.Fatal(err)
	}
	defer keyboard.Close()

	fmt.Println("监听Ctrl+Alt+L组合键...")

	ctrlPressed := false
	altPressed := false
	lPressed := false

	for key := range keyboard.KeyPress() {
		// 检查按键状态
		switch key.Code() {
		case xkg.KeyControlL, xkg.KeyControlR:
			ctrlPressed = key.State() == xkg.KeyStatePress
		case xkg.KeyAltL, xkg.KeyAltR:
			altPressed = key.State() == xkg.KeyStatePress
		case xkg.KeyL:
			lPressed = key.State() == xkg.KeyStatePress
		}

		// 检查组合键
		if ctrlPressed && altPressed && lPressed {
			fmt.Println("检测到Ctrl+Alt+L组合键!")
			// 重置状态
			ctrlPressed, altPressed, lPressed = false, false, false
		}
	}
}

3. 全局热键注册

func registerGlobalHotkey() {
	keyboard, err := xkg.NewKeyboard()
	if err != nil {
		log.Fatal(err)
	}
	defer keyboard.Close()

	// 注册全局热键 Ctrl+Shift+A
	hotkey := xkg.NewHotkey(xkg.KeyA, xkg.ModControl|xkg.ModShift)
	
	// 创建热键通道
	hotkeyChan := make(chan xkg.Hotkey)
	keyboard.RegisterHotkey(hotkey, hotkeyChan)

	fmt.Println("已注册Ctrl+Shift+A全局热键，等待触发...")

	// 监听热键事件
	for range hotkeyChan {
		fmt.Println("Ctrl+Shift+A热键被触发!")
		// 这里可以执行相应的操作
	}
}

高级功能

1. 按键重映射

func keyRemapping() {
	keyboard, err := xkg.NewKeyboard()
	if err != nil {
		log.Fatal(err)
	}
	defer keyboard.Close()

	// 创建按键事件通道
	keyChan := keyboard.KeyPress()

	fmt.Println("按键重映射示例: 将CapsLock映射为Ctrl")

	for key := range keyChan {
		// 将CapsLock映射为左Ctrl
		if key.Code() == xkg.KeyCapsLock {
			// 阻止原始CapsLock事件
			keyboard.SuppressKey(key)
			
			// 发送Ctrl键事件
			newEvent := xkg.NewKeyEvent(xkg.KeyControlL, key.State())
			keyboard.SendKey(newEvent)
			continue
		}
		
		fmt.Printf("按键: %s\n", key.String())
	}
}

2. 监听键盘布局变化

func monitorKeyboardLayout() {
	keyboard, err := xkg.NewKeyboard()
	if err != nil {
		log.Fatal(err)
	}
	defer keyboard.Close()

	// 获取当前键盘布局
	currentLayout := keyboard.Layout()
	fmt.Printf("当前键盘布局: %s\n", currentLayout)

	// 监听布局变化
	layoutChan := keyboard.LayoutChange()
	for newLayout := range layoutChan {
		fmt.Printf("键盘布局已更改为: %s\n", newLayout)
	}
}

注意事项

1. 权限问题：在Linux系统上，可能需要以root权限运行程序才能捕获全局键盘事件。

2. 跨平台兼容性：xkg库主要针对X11环境（Linux），在其他平台可能需要不同的实现。

3. 性能考虑：长时间运行的键盘监听程序应该合理处理资源释放。

4. 事件处理延迟：复杂的处理逻辑可能导致按键响应延迟。

完整示例

package main

import (
	"fmt"
	"log"
	"github.com/jezek/xkg"
)

func main() {
	// 初始化键盘监听
	kb, err := xkg.NewKeyboard()
	if err != nil {
		log.Fatal(err)
	}
	defer kb.Close()

	fmt.Println("键盘监听程序已启动")
	fmt.Println("按ESC退出，Ctrl+Alt+D显示消息")

	// 注册热键通道
	hotkey := xkg.NewHotkey(xkg.KeyD, xkg.ModControl|xkg.ModAlt)
	hotkeyChan := make(chan xkg.Hotkey)
	kb.RegisterHotkey(hotkey, hotkeyChan)

	// 监听普通按键和热键
	for {
		select {
		case key := <-kb.KeyPress():
			fmt.Printf("按键: %s\n", key.String())
			if key.Code() == xkg.KeyEscape {
				fmt.Println("程序退出")
				return
			}
		case <-hotkeyChan:
			fmt.Println("检测到Ctrl+Alt+D热键!")
		}
	}
}

xkg 库提供了强大的键盘事件处理能力，适合开发需要键盘监控的应用程序，如热键工具、键盘映射工具等。使用时请注意遵守相关法律法规，确保程序用途合法合规。