RealityKit Entity旋转动画无法超过180度？如何实现360度旋转？

问题背景 #

你当前使用move(to:relativeTo:duration:)方法为Entity制作旋转动画，代码如下：

let transform = Transform(scale: .one, 
                       rotation: simd_quatf(angle: .pi, axis: [0,0,1]), 
                      translate: .zero)

myEntity.move(to: transform, relativeTo: myEntity, duration: 1)

当旋转角度不超过π（180度）时动画表现正常，但尝试设置超过180度的旋转目标时，动画会出现停滞现象。

问题原因 #

这是因为simd_quatf（四元数）默认采用最短路径旋转的特性：它会自动计算从当前姿态到目标姿态的最短旋转路径。当你设置的目标旋转角度超过π时，四元数会选择反向旋转更短的角度来达到目标姿态，视觉上就会呈现出动画停滞的效果。

解决方案 #

方案1：拆分多阶段连续动画

将360度旋转拆分为两个180度的连续动画，通过动作序列依次执行，强制走完整的旋转路径：

// 第一阶段：旋转180度
let first180Transform = Transform(scale: .one,
                                  rotation: simd_quatf(angle: .pi, axis: [0,0,1]),
                                  translate: .zero)
// 第二阶段：基于第一阶段的姿态再旋转180度
let second180Transform = Transform(scale: .one,
                                   rotation: simd_quatf(angle: .pi, axis: [0,0,1]),
                                   translate: .zero)

// 执行连续动作序列
myEntity.runAction(.sequence([
    .move(to: first180Transform, relativeTo: myEntity, duration: 1),
    .move(to: second180Transform, relativeTo: myEntity, duration: 1)
]))

方案2：使用关键帧动画（适用于SceneKit/ARKit环境）

直接操作Entity关联节点的旋转属性，通过关键帧动画明确指定完整的旋转路径，绕开四元数的最短路径限制：

let fullRotationAnim = CAKeyframeAnimation(keyPath: "rotation")
// 定义旋转路径的关键帧：0° → 180° → 360°
fullRotationAnim.values = [
    simd_quatf(angle: 0, axis: [0,0,1]),
    simd_quatf(angle: .pi, axis: [0,0,1]),
    simd_quatf(angle: 2 * .pi, axis: [0,0,1])
]
fullRotationAnim.duration = 2 // 总时长2秒
fullRotationAnim.isRemovedOnCompletion = false
fullRotationAnim.fillMode = .forwards

// 为Entity的场景节点添加动画
myEntity.scene?.addAnimation(fullRotationAnim, forKey: "full360Rotation")

方案3：逐帧手动控制旋转

通过自定义更新循环逐帧修改Entity的旋转角度，完全掌控旋转方向和路径：

var currentRotationAngle: Float = 0
let rotationSpeed: Float = .pi * 2 // 每秒旋转360度

// 在场景的每一帧更新回调中调用此方法
func updateRotation(deltaTime: TimeInterval) {
    // 根据时间增量更新当前角度
    currentRotationAngle += rotationSpeed * Float(deltaTime)
    // 可选：将角度限制在0-2π范围内，避免数值过大
    currentRotationAngle = fmod(currentRotationAngle, 2 * .pi)
    
    // 生成新的Transform并赋值给Entity
    let newTransform = Transform(
        scale: myEntity.transform.scale,
        rotation: simd_quatf(angle: currentRotationAngle, axis: [0,0,1]),
        translation: myEntity.transform.translation
    )
    myEntity.transform = newTransform
}

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