RealityKit中同时交互多个ModelEntities的简易实现方案咨询

RealityKit 没有内置“同一手势直接驱动多个 ModelEntity 同步完成旋转、缩放、位移”的开箱即用方法，但完全可以基于系统原生的手势能力低成本实现。整个实现不需要写自定义渲染管线的复杂逻辑，几十行代码就能完成两个实体的多点触控旋转联动。

核心实现思路 #

• 不要走单实体绑定手势的默认交互流程：RealityKit 默认的交互逻辑是通过射线检测把手势命中的单个实体作为响应者，直接把手势产生的变换赋值给该实体。要实现多实体联动，需要跳过这个自动绑定步骤，手动维护需要同步响应的实体集合。
• 把手势识别层从实体碰撞回调上移到整个 ARView 的视图层级上：不要在实体的碰撞事件监听里逐个添加手势，直接在承载场景的 ARView 视图上挂载全局的旋转、缩放手势识别器，让手势本身不直接和单个实体绑定。

多点触控旋转联动的简易实现步骤 #

• 提前把需要同步响应的两个（或多个）ModelEntity 存入一个全局的实体列表，不需要为每个实体单独配置手势交互逻辑。
• 在 ARView 上添加全局旋转手势识别，在手势的状态更新回调里，读取当前手势帧的旋转角度增量，遍历维护的实体列表，对每个实体逐次应用旋转变换即可。
  核心逻辑的代码片段：

  // 记录手势上一帧的角度，用来计算相邻帧的增量
  var lastRotationAngle: Float = 0
  // 手势更新回调
  func handleRotationGesture(currentAngle: Float) {
      let delta = currentAngle - lastRotationAngle
      lastRotationAngle = currentAngle
      // 遍历所有需要联动的实体
      for targetEntity in linkedEntitySet {
          // 计算绕Y轴的旋转增量
          let rotationDelta = simd_quatf(angle: delta, axis: [0, 1, 0])
          targetEntity.transform.rotation = rotationDelta * targetEntity.transform.rotation
      }
  }
  

• 如果需要区分“单实体独立操作”和“多实体联动操作”的场景，可以在手势触发的初始阶段，通过射线检测判断当前触控点是否落在预设联动组的实体碰撞体上，命中就触发整组实体的同步变换，未命中就走默认的单实体交互逻辑。

实现时的常见踩坑点 #

• 不要给每个联动实体单独添加手势识别器，否则会触发系统的手势冲突拦截，还会出现旋转角度被重复计算、实体跳变的问题，所有联动变换逻辑必须收敛到同一个全局手势的回调里处理。
• 旋转计算一定要基于相邻帧的角度增量，不要直接把手势识别返回的总旋转角度赋值给实体的 transform，否则会出现实体角度跳变、无法连续旋转的问题。
• 实体的旋转默认是基于自身坐标系完成的，不需要额外调整实体的 pivot 点，就能实现每个实体绕自身几何中心同步旋转的效果。

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