SpriteKit中如何检测双击？touch.tapCount无法返回2的问题排查

这个问题我之前做iOS触摸交互时也碰到过，核心原因大多和UIKit的触摸事件处理机制有关，咱们一步步拆解：

可能的原因 #

• 触摸序列未完整结束：UIKit的触摸事件是一套完整的流程——touchesBegan → touchesEnded（或touchesCancelled）。如果你只重写了touchesBegan，却没实现另外两个方法，系统没法正确标记第一次触摸的结束，第二次点击会被当成新的触摸序列起点，tapCount重置为1；第三次点击又会叠加成3，自然只能看到奇数。
• 动画导致视图偏移：你在touchesBegan里调用的player.animatedPlayer()如果让当前视图的位置、大小发生了变化（比如跳跃动画），第二次点击的触摸点可能已经不在这个视图上了，自然收不到tapCount=2的事件。
• 点击间隔超过系统阈值：系统识别双击有时间限制（默认约0.2-0.3秒），如果两次点击太慢，系统会把第二次当成独立的单次点击，tapCount直接重置为1。

解决办法 #

1. 补全触摸事件生命周期方法 #

哪怕里面没自定义逻辑，也要把touchesEnded和touchesCancelled加上，保证触摸序列能正常闭环：

override func touchesEnded(_ touches: Set<UITouch>, with event: UIEvent?) {
    super.touchesEnded(touches, with: event)
}

override func touchesCancelled(_ touches: Set<UITouch>, with event: UIEvent?) {
    super.touchesCancelled(touches, with: event)
}

2. 检查视图交互状态与位置 #

• 确保动画过程中视图的userInteractionEnabled没有被设为false，否则触摸事件根本传不进来；
• 如果动画导致视图偏移，可以调整动画逻辑，或者在动画完成前暂时限制双击操作，保证第二次点击能落在视图范围内。

3. 换用UITapGestureRecognizer（更省心的方案） #

手动处理touches事件容易踩各种细节坑，UIKit自带的手势识别器已经封装好了双击判断逻辑，用起来更可靠：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 单击手势
    let singleTap = UITapGestureRecognizer(target: self, action: #selector(handleSingleTap))
    singleTap.numberOfTapsRequired = 1
    self.addGestureRecognizer(singleTap) // 若为ViewController，替换为view.addGestureRecognizer
    
    // 双击手势
    let doubleTap = UITapGestureRecognizer(target: self, action: #selector(handleDoubleTap))
    doubleTap.numberOfTapsRequired = 2
    // 设置双击优先级高于单击，避免双击触发两次单击
    singleTap.require(toFail: doubleTap)
    self.addGestureRecognizer(doubleTap)
}

@objc func handleSingleTap() {
    player.animatedPlayer()
    jump = true
}

@objc func handleDoubleTap() {
    // 此处编写双击逻辑
}

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