SwiftUI中SimultaneousGesture组合旋转缩放手势单触发失效问题

问题描述 #

我在SwiftUI视图中使用SimultaneousGesture组合RotateGesture与MagnifyGesture，实现图片的同时旋转和缩放功能，但遇到了以下问题：当仅触发其中一个手势（如缩放）且未触发另一个（旋转）时，未触发的手势会被判定为“失败”，后续两个手势的.onChanged或.onEnded回调均不再触发，直到用户抬手重新操作。

简化代码如下：

struct ImageDragView: View {
    @State private var scale: CGFloat = 1.0
    @State private var lastScale: CGFloat = 1.0
    @State private var angle: Angle = .zero
    @State private var lastAngle: Angle = .zero
    
    var body: some View {
        Image("Stickers3")
            .resizable()
            .aspectRatio(contentMode: .fit)
            .frame(height: 100)
            .rotationEffect(angle, anchor: .center)
            .scaleEffect(scale)
            .gesture(combinedGesture)
    }

    var combinedGesture: some Gesture {
        SimultaneousGesture(
            RotateGesture(minimumAngleDelta: .degrees(8)), 
            MagnifyGesture()
        )
        .onChanged { combinedValue in
            if let magnification = combinedValue.second?.magnification {
                let minScale = 0.2
                let maxScale = 5.0
                let newScale = magnification * lastScale
                scale = max(min(newScale, maxScale), minScale)
            }
            if let rotation = combinedValue.first?.rotation {
                angle = rotation + lastAngle
            }
        }
        .onEnded { _ in
            lastScale = scale
            lastAngle = angle
        }
    }
}

现象说明 #

• 同时进行捏合缩放和旋转操作（或仅旋转）时，两个手势均正常工作；
• 但仅进行捏合缩放（或旋转幅度未达到minimumAngleDelta）时，后续手势的回调不再触发，仿佛整个手势序列被取消。

我发现将minimumAngleDelta设为.degrees(0)可缓解问题，但想了解问题成因及更合理的解决方案。

问题成因 #

SimultaneousGesture的核心逻辑是：只有当组合内所有手势都处于活跃状态时，整个组合手势才会持续触发回调。如果其中一个手势因未满足触发条件（如旋转的角度未达到minimumAngleDelta）被系统判定为“失败”，整个组合手势会直接终止，后续的手势事件无法传递到回调中。

推荐解决方案 #

放弃直接使用SimultaneousGesture组合，改为给视图分别添加两个独立的手势，通过.simultaneousGesture()修饰符允许它们同时响应。这种方式下，每个手势的生命周期完全独立，不会因一个手势失败而影响另一个。

修改后的代码如下：

struct ImageDragView: View {
    @State private var scale: CGFloat = 1.0
    @State private var lastScale: CGFloat = 1.0
    @State private var angle: Angle = .zero
    @State private var lastAngle: Angle = .zero
    
    var body: some View {
        Image("Stickers3")
            .resizable()
            .aspectRatio(contentMode: .fit)
            .frame(height: 100)
            .rotationEffect(angle, anchor: .center)
            .scaleEffect(scale)
            // 添加缩放手势
            .gesture(magnifyGesture)
            // 添加旋转手势，允许与缩放手势同时响应
            .simultaneousGesture(rotateGesture)
    }
    
    private var rotateGesture: some Gesture {
        RotateGesture(minimumAngleDelta: .degrees(8))
            .onChanged { value in
                angle = value.rotation + lastAngle
            }
            .onEnded { _ in
                lastAngle = angle
            }
    }
    
    private var magnifyGesture: some Gesture {
        MagnifyGesture()
            .onChanged { value in
                let minScale = 0.2
                let maxScale = 5.0
                let newScale = value.magnification * lastScale
                scale = max(min(newScale, maxScale), minScale)
            }
            .onEnded { _ in
                lastScale = scale
            }
    }
}

方案优势 #

• 两个手势完全独立，各自的触发条件（如旋转的minimumAngleDelta）不会互相干扰；
• 单独触发缩放或旋转时，另一个手势不会被判定为失败，后续操作依然能正常触发回调；
• 支持同时进行缩放和旋转操作，效果与SimultaneousGesture一致，但稳定性更强。

若需要更精细的手势冲突处理，可使用.highPriorityGesture()或.exclusiveGesture()调整手势优先级，但本场景下.simultaneousGesture()已能满足需求。

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