XTestFakeKeyEvent与Unicode在Qt应用中的兼容问题

首先，我来拆解下你遇到的两个核心问题：Qt应用（Telegram、qtransmission）不兼容你的按键模拟逻辑，以及0xD7FF以上的Unicode字符（比如表情）无法插入。结合你的代码和场景，原因和解决方案如下：

问题根源分析 #

1. Qt与GTK的输入处理差异
   GTK应用和Chrome对临时修改X11键盘映射的方式兼容性较好，但Qt应用通常使用独立的输入框架（Qt Input Framework），它可能会缓存键盘布局，不会实时读取你临时修改的键盘映射，导致你的按键模拟失效。

2. 高码位Unicode字符的编码特性
   0xD7FF以上的字符属于Unicode补充平面（比如大部分表情符号），这类字符无法用单个UTF-16编码单元表示，需要拆分为代理对（由一个高代理码元和一个低代理码元组成）。你的代码目前只处理单个Unicode码点，没有做代理对分解，所以这类字符无法被正确识别输入。

可行的解决方案 #

方案1：针对高码位字符，补充代理对分解逻辑 #

先实现一个函数，把补充平面的字符拆分为UTF-16代理对，然后分别发送对应的按键事件：

// 将补充平面字符分解为UTF-16代理对
void decompose_to_surrogates(unichar c, out unichar high_surrogate, out unichar low_surrogate) {
    ulong code_point = c;
    code_point -= 0x10000;
    high_surrogate = (unichar)(0xD800 | (code_point >> 10));
    low_surrogate = (unichar)(0xDC00 | (code_point & 0x3FF));
}

// 提取重复的按键发送逻辑为单独函数
void send_keysym(X.Display display, int keycode, ulong keysym) {
    ulong new_keysyms[] = {keysym};
    XChangeKeyboardMapping(display, keycode, 1, new_keysyms, 1);
    XTest.fake_key_event(display, keycode, true, 0);
    XTest.fake_key_event(display, keycode, false, 100);
    display.flush();
}

然后修改你的Insert函数，判断字符是否属于补充平面，分别处理：

void Insert(unichar symbol) {
    unowned X.Display display = Gdk.X11.get_default_xdisplay();
    int max = 0, min = 0;
    display.keycodes(ref min, ref max);
    int keycode = min;
    unichar[] symbols = new unichar[4];
    ulong size = symbol.fully_decompose(true, symbols);

    for (ulong i = 0; i < size; ++i) {
        unichar c = symbols[i];
        if (c > 0xFFFF) {
            // 处理补充平面字符，分解为代理对
            unichar high, low;
            decompose_to_surrogates(c, out high, out low);
            string high_code = "U%04x".printf(high);
            string low_code = "U%04x".printf(low);
            send_keysym(display, keycode, X.string_to_keysym(high_code));
            send_keysym(display, keycode, X.string_to_keysym(low_code));
        } else {
            // 处理BMP内的字符，沿用原逻辑
            string code = "U%04x".printf(c);
            send_keysym(display, keycode, X.string_to_keysym(code));
        }
    }

    // 恢复原键盘映射
    ulong original[] = {0};
    XChangeKeyboardMapping(display, keycode, 1, original, 1);
    display.flush();
}

不过这个方案只能解决高码位字符的输入问题，Qt应用的兼容性问题可能依然存在——因为Qt的输入框架可能还是不会识别你临时修改的键盘映射。

方案2：改用剪贴板粘贴模拟输入（兼容性最优） #

既然你提到复制粘贴可以正常插入所有字符，那我们可以直接模拟“复制+粘贴”的流程，这种方法对所有应用（包括Qt、GTK、Chrome）都完全兼容：

void insert_via_clipboard(unichar symbol) {
    // 获取系统剪贴板
    var clipboard = Gtk.Clipboard.get(Gdk.SELECTION_CLIPBOARD);
    // 保存原有剪贴板内容，用完恢复（可选但友好）
    string original_content = clipboard.wait_for_text();

    // 将目标字符设置到剪贴板
    clipboard.set_text(symbol.to_string(), -1);

    // 模拟Ctrl+V按键事件
    unowned X.Display display = Gdk.X11.get_default_xdisplay();
    int ctrl_keycode = XKeysymToKeycode(display, X.string_to_keysym("Control_L"));
    int v_keycode = XKeysymToKeycode(display, X.string_to_keysym("v"));

    // 按下Ctrl
    XTest.fake_key_event(display, ctrl_keycode, true, 0);
    // 按下并松开V
    XTest.fake_key_event(display, v_keycode, true, 0);
    XTest.fake_key_event(display, v_keycode, false, 0);
    // 松开Ctrl
    XTest.fake_key_event(display, ctrl_keycode, false, 0);
    display.flush();

    // 恢复原有剪贴板内容
    if (original_content != null) {
        clipboard.set_text(original_content, -1);
    }
}

这个方法虽然不是直接模拟按键输入，但胜在兼容性拉满，完全避开了不同应用输入框架的差异问题。

方案3：使用X11标准Unicode输入接口（进阶） #

如果你想坚持直接模拟输入，可以尝试使用X11的Xutf8SendEvent函数（需要链接libXutf8库），它可以直接发送UTF-8编码的字符事件，不需要修改键盘映射，对Qt应用的兼容性更好。不过Vala中可能需要手动绑定这个函数，或者通过C语言封装调用。

总结 #

• 如果你优先追求兼容性，**方案2（剪贴板粘贴）**是最稳妥的选择；
• 如果你必须用原生按键模拟，方案1可以解决高码位字符问题，但Qt应用的兼容性可能需要额外测试；
• 进阶场景可以尝试方案3，使用X11的Unicode输入标准接口。

内容的提问来源于stack exchange，提问作者dm33tri