为何RotateGesture3D交互后RealityView方向重置，位置却可保留？

我尝试用RotateGesture3D在RealityView中实现3D模型旋转，代码能完成单次旋转，但每次重新触发旋转手势时，模型方向都会重置为初始角度：

import SwiftUI
import RealityKit
import RealityKitContent

struct ContentView: View {
    
    @State var entity = Entity()
    
    var body: some View {
        VStack {
            RealityView { content in
                if let scene = try? await Entity(named: "Scene", in: realityKitContentBundle) {
                    entity = scene
                    content.add(scene)
                }
            }
            .gesture(RotateGesture3D().targetedToAnyEntity().onChanged{ value in
                value.entity.orientation = value.convert(value.gestureValue.rotation, from: .local, to: entity.parent!)
            })
        }
    }
}

而我实现3D平移的代码却能在手势交互间保留对象位置：

import SwiftUI
import RealityKit
import RealityKitContent

struct TranslateView: View {
    
    @State var entity = Entity()
    var body: some View {
        VStack {
            RealityView { content in
                if let scene = try? await Entity(named: "Scene", in: realityKitContentBundle) {
                    entity = scene
                    content.add(scene)
                }
            }
            .gesture(DragGesture().targetedToAnyEntity().onChanged{value in
                var vectorDouble = value.translation3D
                let vectorFloat = SIMD3<Float>(Float(vectorDouble.x/10000), Float(vectorDouble.y/10000), Float(vectorDouble.z/10000))
                value.entity.position = value.convert(value.location3D, from: .local, to: entity.parent!)
            })
        }
    }
}

为什么position能保留状态，orientation却不行？

问题根源 #

平移代码里，value.location3D代表手势在父坐标系中的累计绝对位置——每次手势更新时，这个值是从初始原点到当前手势位置的总位移，直接赋值给实体position自然能保留之前的移动结果。

但旋转逻辑中，value.gestureValue.rotation是当前手势周期内的相对旋转增量：每次新手势触发时，这个值会从0开始计算，代表从手势开始到当前时刻的旋转变化量。你直接用这个增量覆盖实体的orientation，相当于每次新手势都把旋转状态重置为当前手势的增量，之前的旋转自然丢失了。

修复代码 #

要保留旋转状态，需要将实体当前的已有旋转与手势的增量旋转叠加（RealityKit中四元数旋转通过乘法实现叠加）。修改旋转手势的onChanged闭包：

.gesture(RotateGesture3D().targetedToAnyEntity().onChanged{ value in
    // 将当前实体旋转与手势增量旋转叠加，再转换到父坐标系
    let newRotation = value.entity.orientation * value.gestureValue.rotation
    value.entity.orientation = value.convert(newRotation, from: .local, to: entity.parent!)
})

补充说明 #

如果模型有复杂层级结构，需要确保坐标系转换的正确性。也可以直接使用value.gestureValue.cumulativeRotation（API支持情况下）获取累计旋转量，但叠加已有旋转的方式更可靠，能避免手势中断后的状态丢失。

内容的提问来源于stack exchange，提问作者Code on the Rocks