如何使用Swift在macOS上模拟触控板缩放功能

核心逻辑说明 #

原生触控板的缩放交互不是直接传递手势总缩放值触发，而是通过持续上报增量缩放值+手势生命周期状态，由系统识别为标准捏合手势后响应，直接传输绝对scale值会出现缩放速度异常、手势不连贯、不支持系统级动画的问题。

iPhone端手势预处理 #

• 不要直接传递UIPinchGestureRecognizer的原始scale属性（该值是从手势起点到当前位置的总缩放比），需要计算每一次回调的增量缩放值
• 同步传递手势状态：began/changed/ended，和Mac端系统手势事件的生命周期对齐
• 额外采集捏合手势在iPhone屏幕上的中心点，映射到Mac屏幕坐标后作为缩放中心点，避免缩放始终固定在屏幕中心

// iOS端捏合手势处理代码
var lastPinchScale: CGFloat = 1.0
@objc func handlePinchGesture(_ gesture: UIPinchGestureRecognizer) {
    var payload: [String: Any] = ["gestureType": "magnify"]
    // 采集手势中心点，做跨设备坐标映射
    let rawCenter = gesture.location(in: view)
    payload["centerX"] = rawCenter.x / view.bounds.width
    payload["centerY"] = rawCenter.y / view.bounds.height
    
    switch gesture.state {
    case .began:
        payload["state"] = "began"
        lastPinchScale = 1.0
    case .changed:
        // 计算本次回调的增量缩放值
        let delta = gesture.scale / lastPinchScale
        payload["state"] = "changed"
        payload["deltaScale"] = delta
        lastPinchScale = gesture.scale
    case .ended, .cancelled, .failed:
        payload["state"] = "ended"
        lastPinchScale = 1.0
    default: return
    }
    // 通过本地局域网/USB等通道将payload发送到Mac端
    transmitToMac(payload: payload)
}

Mac端系统事件注入 #

Mac端不要使用滚轮事件模拟缩放，直接通过CoreGraphics框架构造系统原生识别的捏合手势事件，和实体触控板的触发逻辑完全一致，支持所有原生响应（包括Safari缩放、图片预览缩放、系统级缩放动画）。

// Mac端手势事件注入代码，依赖CoreGraphics框架
import CoreGraphics
import AppKit

func processReceivedPinchPayload(_ payload: [String: Any]) {
    guard let eventSource = CGEventSource(stateID: .hidSystemState),
          let state = payload["state"] as? String,
          let mainScreen = NSScreen.main else { return }
    
    // 归一化坐标转Mac屏幕实际坐标，注意Mac坐标系原点在左下角
    let normX = (payload["centerX"] as? CGFloat) ?? 0.5
    let normY = (payload["centerY"] as? CGFloat) ?? 0.5
    let position = CGPoint(
        x: normX * mainScreen.frame.width,
        y: (1 - normY) * mainScreen.frame.height
    )
    
    switch state {
    case "began":
        guard let event = CGEvent.gestureEvent(
            type: .magnifyBegin,
            position: position,
            magnification: 0
        ) else { return }
        event.post(tap: .cghidEventTap)
    case "changed":
        guard let delta = payload["deltaScale"] as? CGFloat,
              let event = CGEvent.gestureEvent(
                type: .magnifyChanged,
                position: position,
                // 增量值转自然对数，匹配系统原生缩放的加速度曲线，避免缩放速度过快
                magnification: log(delta)
              ) else { return }
        event.post(tap: .cghidEventTap)
    case "ended":
        guard let event = CGEvent.gestureEvent(
            type: .magnifyEnd,
            position: position,
            magnification: 0
        ) else { return }
        event.post(tap: .cghidEventTap)
    default: break
    }
}

手感调优要点 #

• 对单次传输的增量值做阈值截断，限制在0.7~1.3区间内，避免网络波动导致的异常值引发缩放跳变
• 手势结束后可追加3~5帧衰减动画，模拟原生触控板松手后的惯性缩放效果，不需要可省略
• 缩放灵敏度可在log(delta)后乘以0.8~1.2的系数调整，匹配个人使用习惯
• 如果需要实现双指点按智能缩放，构造类型为.smartMagnify的手势事件发送即可，逻辑和捏合缩放一致

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