MacOS下如何用IOKit阻止特定键盘按键事件传播？

你基于IOKit.hid的技术路径是完全正确的——IOKit是MacOS上直接访问底层HID设备的官方框架，能获取原始输入事件，且优先级高于Cocoa应用级别的事件处理，刚好适配你「区分输入设备+优先拦截事件」的需求。

仅靠IOHIDValueCallback只能获取HID事件，但无法直接阻止事件传递到前台应用，需要结合CGEventTap（底层事件拦截机制）实现：

1. 先通过IOKit记录目标键盘的唯一设备ID（可通过IOHIDDeviceGetProperty(device, kIOHIDUniqueIDKey)获取）；
2. 创建cghidEventTap类型的事件拦截器（这是最底层的HID事件tap，优先于应用处理），在回调中判断事件来源设备ID：
   • 匹配目标键盘：执行MIDI发送逻辑，返回nil丢弃事件，阻止传播；
   • 不匹配：返回原事件，允许正常传播。

Swift 代码示例 #

import Cocoa

class MIDIKeyInterceptor {
    var eventTap: CFMachPort?
    var runLoopSource: CFRunLoopSource?
    var targetDeviceIDs: Set<UInt64> = [] // 存储目标键盘的唯一ID

    // 初始化时传入已识别的目标设备ID
    init(targetDeviceIDs: Set<UInt64>) {
        self.targetDeviceIDs = targetDeviceIDs
    }

    func startInterception() {
        // 监听按键按下/抬起事件
        let eventMask = CGEventMask(1 << CGEventType.keyDown.rawValue) | CGEventMask(1 << CGEventType.keyUp.rawValue)
        
        // 创建底层HID事件tap，插入到事件队列头部优先处理
        eventTap = CGEventTapCreate(
            .cghidEventTap,
            .headInsertEventTap,
            .defaultTap,
            eventMask,
            { proxy, eventType, event, refcon in
                let interceptor = unsafeBitCast(refcon, to: MIDIKeyInterceptor.self)
                let sourceID = CGEventGetIntegerValueField(event, .eventSourceID)
                
                if interceptor.targetDeviceIDs.contains(sourceID) {
                    // 执行你的MIDI发送逻辑
                    interceptor.sendMIDIEvent(event: event, type: eventType)
                    // 返回nil，阻止事件传递到前台应用
                    return nil
                } else {
                    // 返回原事件，允许正常传播
                    return event
                }
            },
            unsafeBitCast(self, to: UnsafeMutableRawPointer.self)
        )

        guard let tap = eventTap else {
            print("Failed to create event tap - check accessibility permissions")
            return
        }

        runLoopSource = CFMachPortCreateRunLoopSource(kCFAllocatorDefault, tap, 0)
        CFRunLoopAddSource(CFRunLoopGetCurrent(), runLoopSource, .commonModes)
        CGEventTapEnable(tap, true)
    }

    func stopInterception() {
        if let tap = eventTap {
            CGEventTapEnable(tap, false)
        }
        if let source = runLoopSource {
            CFRunLoopRemoveSource(CFRunLoopGetCurrent(), source, .commonModes)
        }
    }

    private func sendMIDIEvent(event: CGEvent, type: CGEventType) {
        // 你的MIDI指令发送逻辑
    }
}

关键注意事项 #

• 权限：程序必须添加到「系统设置-隐私与安全性-辅助功能」列表中，否则无法创建事件tap；
• 设备ID匹配：确保IOKit获取的设备ID与CGEvent中的eventSourceID一致，部分复合设备可能存在多个ID，需测试验证。

Python没有原生API直接区分输入设备，但可以通过pyobjc绑定MacOS底层框架实现，步骤与Swift类似：

1. 用IOKit.hid识别目标键盘并记录设备ID；
2. 用Quartz框架创建CGEventTap拦截事件，判断设备ID后决定是否阻止传播。

Python 代码示例 #

import Quartz
import IOKit.hid

class MIDIKeyInterceptor:
    def __init__(self):
        self.target_device_ids = set()
        self.event_tap = None

    def _fetch_target_devices(self):
        # 识别所有键盘设备，筛选目标设备并记录ID
        manager = IOKit.hid.IOHIDManagerCreate(None, 0)
        # 匹配键盘设备（Usage Page 1，Usage 6）
        IOKit.hid.IOHIDManagerSetDeviceMatching(manager, {
            IOKit.hid.kIOHIDDeviceUsagePageKey: 1,
            IOKit.hid.kIOHIDDeviceUsageKey: 6
        })
        devices = IOKit.hid.IOHIDManagerCopyDevices(manager)
        for dev in devices:
            uid = IOKit.hid.IOHIDDeviceGetProperty(dev, IOKit.hid.kIOHIDUniqueIDKey)
            if uid:
                # 替换为你的目标键盘ID判断逻辑
                if "你的目标键盘名称" in str(IOKit.hid.IOHIDDeviceGetProperty(dev, IOKit.hid.kIOHIDProductNameKey)):
                    self.target_device_ids.add(uid)

    def _event_tap_callback(self, proxy, event_type, event, refcon):
        source_id = Quartz.CGEventGetIntegerValueField(event, Quartz.kCGEventSourceID)
        if source_id in self.target_device_ids:
            # 执行MIDI发送逻辑
            self._send_midi(event, event_type)
            # 返回None阻止事件传播
            return None
        return event

    def start(self):
        self._fetch_target_devices()
        event_mask = (1 << Quartz.kCGEventKeyDown) | (1 << Quartz.kCGEventKeyUp)
        self.event_tap = Quartz.CGEventTapCreate(
            Quartz.kCGHIDEventTap,
            Quartz.kCGHeadInsertEventTap,
            Quartz.kCGEventTapOptionDefault,
            event_mask,
            self._event_tap_callback,
            None
        )
        if not self.event_tap:
            print("Failed to create event tap - check accessibility permissions")
            return
        run_loop_source = Quartz.CFMachPortCreateRunLoopSource(None, self.event_tap, 0)
        Quartz.CFRunLoopAddSource(Quartz.CFRunLoopGetCurrent(), run_loop_source, Quartz.kCFRunLoopCommonModes)
        Quartz.CGEventTapEnable(self.event_tap, True)
        Quartz.CFRunLoopRun()

    def _send_midi(self, event, event_type):
        # 你的MIDI指令发送逻辑
        pass

if __name__ == "__main__":
    interceptor = MIDIKeyInterceptor()
    interceptor.start()

依赖安装 #

执行pip install pyobjc-framework-Quartz pyobjc-framework-IOKit安装所需绑定库，同样需要开启辅助功能权限。

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