MacOS下模拟Home键后Fn键粘连的技术问题求助

问题现象 #

在MacOS平台通过Core Graphics模拟Home键后，出现Fn键"粘连"的异常现象：后续模拟普通按键（如h键）时，实际效果等同于按下Fn+h，而非单独的h键。调试发现事件的kCGEventFlagMaskSecondaryFn标志被持续设置。

原因分析 #

Mac键盘上的Home键通常需要配合Fn键触发，系统在创建Home键的模拟事件时，会自动添加kCGEventFlagMaskSecondaryFn标志。如果该标志未被正确清除，会被后续的按键事件继承，导致出现Fn键粘连的假象。

解决方案 #

在创建Home键的模拟事件时，手动清除kCGEventFlagMaskSecondaryFn标志，确保事件不携带Fn相关的状态。可以通过两种方式实现：

方式1：清除所有事件标志 #

直接将事件的标志位重置为0，适用于不需要保留其他修饰键的场景：

void simulate_key(CGEventSourceRef source, CGKeyCode key, bool key_down)
{
    CGEventRef event = CGEventCreateKeyboardEvent(source, key, key_down);
    // 重置所有事件标志，清除SecondaryFn
    CGEventSetFlags(event, 0);
    CGEventPost(kCGSessionEventTap, event);
    CFRelease(event);
    sleep(1);
}

方式2：精确清除SecondaryFn标志 #

如果需要保留其他修饰键的状态（如Shift、Command等），可以仅清除kCGEventFlagMaskSecondaryFn位：

void simulate_key(CGEventSourceRef source, CGKeyCode key, bool key_down)
{
    CGEventRef event = CGEventCreateKeyboardEvent(source, key, key_down);
    CGEventFlags currentFlags = CGEventGetFlags(event);
    // 仅清除SecondaryFn标志，保留其他标志
    currentFlags &= ~kCGEventFlagMaskSecondaryFn;
    CGEventSetFlags(event, currentFlags);
    CGEventPost(kCGSessionEventTap, event);
    CFRelease(event);
    sleep(1);
}

修改后的完整代码示例 #

将上述修改应用到原代码中，即可解决Fn粘连问题：

#include <stdio.h>
#include <Carbon/Carbon.h>

void simulate_key(CGEventSourceRef source, CGKeyCode key, bool key_down)
{
    CGEventRef event = CGEventCreateKeyboardEvent(source, key, key_down);
    // 清除SecondaryFn标志
    CGEventFlags currentFlags = CGEventGetFlags(event);
    currentFlags &= ~kCGEventFlagMaskSecondaryFn;
    CGEventSetFlags(event, currentFlags);
    
    CGEventPost(kCGSessionEventTap, event);
    CFRelease(event);
    sleep(1);
}

void print33(void) {
    CGEventSourceRef source = CGEventSourceCreate(kCGEventSourceStatePrivate);
    
    printf("simulate #: ");
    fflush(stdout);
    simulate_key(source, kVK_Shift, true);
    simulate_key(source, kVK_ANSI_3, true);
    simulate_key(source, kVK_ANSI_3, false);
    simulate_key(source, kVK_Shift, false);
    
    // 模拟Home键，不会再留下Fn标志
    simulate_key(source, kVK_Home, true);
    simulate_key(source, kVK_Home, false);
    
    printf("\nSimulate h after Home.\n");
    fflush(stdout);
    
    // 模拟h键，效果为单独的h键
    simulate_key(source, kVK_ANSI_H, true);
    simulate_key(source, kVK_ANSI_H, false);
    
    CFRelease(source);
}

int main(int argc, const char * argv[]) {
    print33();
    return 0;
}

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