RealityKit中为Entity组合不同时长的两个动作的问题

问题背景 #

需要控制玩家Entity完成以下动作：

• 并行执行90度旋转（2秒时长）与向前移动（10秒时长）
• 要求旋转在移动初期完成，之后保持朝向继续移动

初始实现中，旋转动作完成后，移动动作会将实体旋转还原为初始值，导致剩余移动阶段变成侧向平移。

问题根源 #

RealityKit的FromToByAction是基于固定起始/目标Transform的关键帧动画，当两个动画都绑定到.transform完整属性时：

• 旋转动画仅在前2秒修改实体旋转，结束后保持最终旋转值
• 移动动画在整个10秒内，会持续将实体的旋转从初始值插值到目标移动Transform的初始旋转值（即未修改的初始旋转）
• 2秒后旋转动画停止，移动动画的旋转插值逻辑会“覆盖”旋转结果，导致实体旋转被还原

临时方案原理 #

你修改后的代码中，将移动动画的fromTransform旋转值设置为目标旋转值，这样：

• 移动动画的旋转部分插值是从目标旋转到目标旋转（无变化），仅平移部分正常执行
• 旋转动画在前2秒将实体从初始旋转过渡到目标旋转，两者并行时，前2秒旋转动画修改旋转，移动动画不干扰旋转属性
• 2秒后旋转动画结束，移动动画继续执行平移，旋转保持目标值，视觉效果符合预期

更优雅的实现方式：拆分Transform子属性动画 #

直接将旋转和平移动画绑定到Transform的不同子属性，避免属性冲突，这是最清晰且符合RealityKit动画设计的方案：

var groupActions: [AnimationResource] = []

// 1. 创建旋转动画：仅修改transform的rotation属性
let targetRotation = simd_quatf(angle: newDirection, axis: SIMD3<Float>(0.0, 1.0, 0.0))
let turnAction = FromToByAction(from: currentPlayerTransform.rotation, to: targetRotation)
groupActions.append(try AnimationResource.makeActionAnimation(for: turnAction,
                                                              duration: 2.0,
                                                              bindTarget: .transform.rotation))

// 2. 创建移动动画：仅修改transform的translation属性
let targetTranslation = currentPlayerTransform.translation + distanceAsVector
let moveAction = FromToByAction(from: currentPlayerTransform.translation, to: targetTranslation)
groupActions.append(try AnimationResource.makeActionAnimation(for: moveAction,
                                                              duration: 10.0,
                                                              bindTarget: .transform.translation))

// 更新当前Transform用于后续逻辑
currentPlayerTransform.rotation = targetRotation
currentPlayerTransform.translation = targetTranslation

优势 #

• 两个动画独立操作不同的Transform子属性，完全避免冲突
• 无需手动构造“假的起始Transform”，代码逻辑更直观
• 符合RealityKit动画系统的设计思路，后续扩展其他动作（比如缩放）也不会出现类似冲突

补充：SceneKit与RealityKit的动画差异 #

SceneKit的动作会基于实体的实时当前状态计算动画帧，而RealityKit的FromToByAction是预先定义好起始/目标值的关键帧动画，不会自动感知其他动画对属性的修改。这就是为什么SceneKit中无需手动跟踪Transform，而RealityKit需要明确控制动画的作用范围或起始/目标值。

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