Swift中开启全键盘访问时如何捕获外接键盘按键事件？

当iOS开启「全键盘访问」后，系统会优先拦截空格、Tab等按键用于控件导航（如激活按钮、切换焦点），导致常规的pressesBegan或UIKeyCommand无法捕获。可以通过以下方案解决：

1. 确保ViewController成为第一响应者 #

系统只会向第一响应者传递按键事件，因此需要让你的ViewController获取第一响应者状态：

class ViewController: UIViewController {
    override var canBecomeFirstResponder: Bool {
        return true
    }
    
    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        becomeFirstResponder()
    }
    
    override func viewWillDisappear(_ animated: Bool) {
        super.viewWillDisappear(animated)
        resignFirstResponder()
    }
    
    // 其他代码...
}

2. 使用系统常量定义UIKeyCommand输入 #

直接使用字符串（如" "）匹配按键在全键盘访问下可能失效，改用系统提供的输入常量，并设置wantsPriorityOverSystemBehavior（iOS15+）抢占系统优先级：

override var keyCommands: [UIKeyCommand]? {
    var commands = [UIKeyCommand]()
    
    // 捕获空格键
    let spaceCmd = UIKeyCommand(input: UIKeyCommand.inputSpace,
                                modifierFlags: [],
                                action: #selector(handleSpace))
    if #available(iOS 15.0, *) {
        spaceCmd.wantsPriorityOverSystemBehavior = true
    }
    commands.append(spaceCmd)
    
    // 捕获Tab键
    let tabCmd = UIKeyCommand(input: UIKeyCommand.inputTab,
                              modifierFlags: [],
                              action: #selector(handleTab))
    if #available(iOS 15.0, *) {
        tabCmd.wantsPriorityOverSystemBehavior = true
    }
    commands.append(tabCmd)
    
    return commands
}

@objc private func handleSpace() {
    print("空格键已捕获（全键盘访问开启状态）")
}

@objc private func handleTab() {
    print("Tab键已捕获（全键盘访问开启状态）")
}

3. 通过pressesBegan拦截并标记事件为已处理 #

如果需要使用pressesBegan捕获事件，处理目标按键后标记事件已处理，阻止系统继续拦截：

override func pressesBegan(_ presses: Set<UIPress>, with event: UIPressesEvent?) {
    guard let key = presses.first?.key else {
        super.pressesBegan(presses, with: event)
        return
    }
    
    let keyCode = key.keyCode.rawValue
    print("按键HID值：\(keyCode)")
    
    // 拦截系统优先处理的按键
    switch key.keyCode {
    case .keyboardSpacebar, .keyboardTab, .keyboardEscape:
        event?.handled = true // 标记事件已处理，阻止系统导航逻辑
        // 这里添加你的自定义处理逻辑
    default:
        super.pressesBegan(presses, with: event)
    }
}

注意事项 #

• 若你的应用需要支持iOS15以下版本，wantsPriorityOverSystemBehavior无法使用，此时只能通过pressesBegan结合event?.handled = true的方式拦截。
• 部分特殊按键（如VoiceOver相关快捷键）无法被应用拦截，这是系统级别的限制。

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