前言
在现代Linux桌面开发中，高效、低延迟的输入事件处理至关重要。XCB作为X11协议的现代化接口，不仅提供更优的性能，还通过其无状态、异步的设计为输入监听带来了革命性的改进。
本文将深入探讨如何使用XCB实现高性能的全局键盘鼠标输入监听，构建响应灵敏的桌面应用。
X11输入事件系统架构
略
基础键鼠事件监听
XCB原生事件同样不支持键盘鼠标的全局监听，因此，同样选择通过额外的扩展来实现监听。
2.1 键码解析
由于XCB库没有提供完整的键盘映射函数，而事件KeyCode和修饰符状态，与X11完全一样，因此直接使用X11的转换函数即可。
高级键鼠事件监听
3.1 XInput扩展
cpp
int main()
{
xcb_connection_t* conn = xcb_connect(NULL, NULL);
if (xcb_connection_has_error(conn)) {
fprintf(stderr, "XCB连接失败\n");
return -1;
}
xcb_prefetch_extension_data(conn, &xcb_input_id);
auto record_ext = xcb_get_extension_data(conn, &xcb_input_id);
if (!record_ext || !record_ext->present) {
fprintf(stderr, "XInput 扩展不可用\n");
return -1;
}
auto root = xcb_setup_roots_iterator(xcb_get_setup(conn)).data->root;
struct xcb_input_event_mask_extend {
xcb_input_event_mask_t header;
unsigned mask;
} event_mask = {XCB_INPUT_DEVICE_ALL,
1,
XCB_INPUT_XI_EVENT_MASK_KEY_PRESS | XCB_INPUT_XI_EVENT_MASK_BUTTON_PRESS};
xcb_input_xi_select_events(conn, root, 1, (const xcb_input_event_mask_t*)&event_mask);
xcb_flush(conn);
while (1) {
std::unique_ptr<xcb_generic_event_t> event(
xcb_wait_for_event(conn));
if (event->response_type != XCB_GE_GENERIC) {
continue;
}
switch (((xcb_ge_generic_event_t*)event.get())->event_type) {
case XCB_KEY_PRESS: {
auto key_event = (xcb_input_key_press_event_t*)event.get();
printf("=== Mouse Button Press ===\n");
printf(" Button: %d\n", key_event->detail);
printf(" Root Coordinates: (%f, %f)\n", key_event->root_x >> 16,
key_event->root_y >> 16);
} break;
case XCB_BUTTON_PRESS: {
auto btn_event = (xcb_input_button_press_event_t*)event.get();
printf("=== Key Press ===\n");
printf(" Key: %d\n", btn_event->detail);
printf(" Mask: %d\n", btn_event->mods.effective);
} break;
}
}
xcb_disconnect(conn);
return 0;
}3.2 Record扩展
cpp
int main() {
xcb_connection_t* connection = xcb_connect(NULL, NULL);
if (xcb_connection_has_error(connection)) {
fprintf(stderr, "XCB连接失败\n");
return -1;
}
xcb_prefetch_extension_data(connection, &xcb_record_id);
const xcb_query_extension_reply_t* record_ext =
xcb_get_extension_data(connection, &xcb_record_id);
if (!record_ext || !record_ext->present) {
fprintf(stderr, "RECORD 扩展不可用\n");
return -1;
}
xcb_record_client_spec_t clients = XCB_RECORD_CS_ALL_CLIENTS;
xcb_record_context_t context = xcb_generate_id(connection);
xcb_record_range_t range;
memset(&range, 0, sizeof(range));
range.device_events.first = XCB_KEY_PRESS;
range.device_events.last = XCB_BUTTON_PRESS;
xcb_void_cookie_t create_cookie = xcb_record_create_context(
connection, context, 0, 1, 1, &clients, &range);
xcb_flush(connection);
xcb_record_enable_context_cookie_t enable_cookie =
xcb_record_enable_context(connection, context);
std::unique_ptr<xcb_record_enable_context_reply_t> reply;
while (1) {
reply.reset(xcb_record_enable_context_reply(connection,
enable_cookie, NULL));
uint8_t* data = xcb_record_enable_context_data(reply.get());
int len = xcb_record_enable_context_data_length(reply.get());
xcb_generic_event_t* event = (xcb_generic_event_t*)data;
while ((uint8_t*)event < data + len) {
switch (event->response_type & ~0x80) {
case XCB_BUTTON_PRESS: {
auto btn_event = (xcb_button_press_event_t*)event;
printf("=== Mouse Button Press ===\n");
printf(" Button: %d\n", btn_event->detail);
printf(" Root Coordinates: (%f, %f)\n", btn_event->root_x, btn_event->root_y);
} break;
case XCB_KEY_PRESS: {
auto key_event = (xcb_key_press_event_t*)event;
printf("=== Key Press ===\n");
printf(" Key: %d\n", key_event->detail);
printf(" Mask: %d\n", key_event->state);
} break;
}
event += 1;
}
}
xcb_disconnect(connection);
return 0;
}结语
虽然XInput和Record都是同步阻塞的，但是XInput直接调用xcb_wait_for_event等待事件到来，而Record则依赖底层的xcb_wait_for_reply响应请求。
由于XInput可以通过xcb_send_event模拟事件来唤醒xcb_wait_for_event，而xcb_wait_for_reply目前暂未找到合适的方法，因此更推荐使用XInput。