macOS开发：远程光标无法向应用外窗口投递鼠标事件的问题

核心问题诊断 #

你的远程光标模拟点击无效，主要源于以下几个关键问题：

• 事件投递Tap类型错误：.cgSessionEventTap会被系统安全机制过滤，无法有效触发跨应用的鼠标事件。
• 事件时序缺失间隔：鼠标按下与抬起事件连续投递时，系统可能来不及识别完整的点击序列。
• 权限与属性配置不完整：即使开启了辅助功能，缺少必要的权限描述和事件属性也会导致事件被拦截。

修复步骤 #

1. 更换事件投递的Tap类型 #

将.cgSessionEventTap替换为.cghidEventTap，直接投递到HID硬件层，绕过会话级限制：

func click(at point: CGPoint) {
    guard let mouseDown = CGEvent(mouseEventSource: nil, mouseType: .leftMouseDown, mouseCursorPosition: point, mouseButton: .left),
          let mouseUp = CGEvent(mouseEventSource: nil, mouseType: .leftMouseUp, mouseCursorPosition: point, mouseButton: .left) else {
        return
    }
    // 投递到HID层
    mouseDown.post(tap: .cghidEventTap)
    // 添加10ms延迟，确保系统识别完整点击序列
    usleep(10000)
    mouseUp.post(tap: .cghidEventTap)
}

2. 验证坐标转换正确性 #

CGEvent使用的全局坐标y轴从屏幕底部开始计算，你的转换逻辑是正确的，可添加打印验证：

// 在moveRemoteCursor的坐标转换后添加打印
let cgScreenPoint = CGPoint(x: screenPoint.x, y: screenHeight - screenPoint.y)
print("CGEvent目标坐标: \(cgScreenPoint)")
click(at: cgScreenPoint)

3. 完善权限配置 #

• 确保应用已加入系统辅助功能列表：系统偏好设置 → 安全性与隐私 → 隐私 → 辅助功能，勾选你的应用。
• 在Info.plist中添加权限描述：

<key>NSAppleEventsUsageDescription</key>
<string>需要权限模拟鼠标输入，实现远程控制功能</string>
<key>NSAccessibilityUsageDescription</key>
<string>需要辅助功能权限操控系统光标与模拟输入</string>

4. 针对特定应用投递事件（可选） #

如果需要精准控制目标应用，可使用postToPid方法：

func click(at point: CGPoint, targetPid: pid_t) {
    guard let mouseDown = CGEvent(mouseEventSource: nil, mouseType: .leftMouseDown, mouseCursorPosition: point, mouseButton: .left),
          let mouseUp = CGEvent(mouseEventSource: nil, mouseType: .leftMouseUp, mouseCursorPosition: point, mouseButton: .left) else {
        return
    }
    mouseDown.postToPid(targetPid)
    usleep(10000)
    mouseUp.postToPid(targetPid)
}

// 使用示例：针对当前前台应用点击
if let pid = NSWorkspace.shared.frontmostApplication?.processIdentifier {
    click(at: cgScreenPoint, targetPid: pid)
}

测试建议 #

先在系统自带应用（如TextEdit、Finder）上验证点击功能，避免第三方应用的自定义防护机制干扰。

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