用途:在 macOS 上实现系统级键盘快捷键注册,适用于需要全局热键的 Swift 应用。
主要能力:提供两条实现路径。NSEvent 监视器方式较简单,需同时注册 addGlobalMonitorForEvents 与 addLocalMonitorForEvents,因为全局监视器在自身应用获得焦点时不会触发;Carbon RegisterEventHotKey 方式更可靠,适合系统级与沙盒(App Store)应用。另含 SwiftUI 应用内快捷键(.keyboardShortcut、.onKeyPress)与辅助功能权限检查。
使用方式:按决策树选择——仅应用内用 SwiftUI;系统级非沙盒可选 NSEvent 或 Carbon;系统级沙盒用 Carbon 加辅助功能授权。Carbon 注册示例:register(keyCode: 49, modifiers: UInt32(cmdKey) | UInt32(shiftKey))。权限检查用 AXIsProcessTrusted() 或 AXIsProcessTrustedWithOptions。
限制与注意:全局事件监视需要辅助功能权限;比较修饰键前须用 .deviceIndependentFlagsMask 掩码;热键重复触发可用时间戳去抖(约 0.3 秒);首次启动可能因未授权而失效。资料未提供安装命令、收费与平台支持范围等信息。