如何使用RealityKit实现3D USDZ模型沿点击方向动态旋转

核心实现逻辑 #

你已经可以通过屏幕点位光线投射拿到世界空间变换信息，只需要按以下步骤计算旋转量即可，不需要额外依赖其他追踪数据：

• 预存初始朝向修正值
  图像锚点加载的USDZ初始朝向反转是坐标系对齐问题，模型首次加载到识别图锚点上后，先记录固定偏移旋转量：如果模型正面完全背对识别图的默认前向，直接存一个绕本地Y轴旋转180度的四元数作为fixedOffsetRotation，后续所有动态旋转计算都叠加这个固定偏移，不用每次重复处理初始反转问题。
• 提取光线投射有效参数
  每次用户点击触发光线投射时，过滤命中结果，只保留和当前识别图所在平面的命中项，提取两个关键坐标：
  • 光线命中识别图平面的世界坐标hitWorldPos
  • USDZ模型根节点当前的世界坐标modelWorldPos
• 计算水平面目标朝向向量
  为了避免点击点和模型存在高度差导致模型出现俯仰偏转，只保留XZ平面（也就是识别图所在平面）的方向分量，归一化得到从模型指向点击点的目标方向向量：

  let targetDir = simd_normalize(simd_float3(
      hitWorldPos.x - modelWorldPos.x,
      0,
      hitWorldPos.z - modelWorldPos.z
  ))
  

• 计算动态旋转四元数
  取模型当前在XZ平面的前向单位向量currentForward，通过向量运算得到从当前前向转到目标方向的旋转量：
  1. 用点积计算两个向量的夹角余弦值，通过反余弦得到旋转角度
  2. 用叉积的Y轴分量正负判断旋转方向，避免旋转角度取反
  3. 把得到的动态旋转量和预存的fixedOffsetRotation相乘，得到最终的目标旋转值
• 平滑应用旋转
  不要直接给模型transform赋值目标旋转，用球面线性插值做过渡，避免朝向跳变：

  // 每帧调用直到旋转完成，0.15为单帧插值比例，数值越小过渡越慢
  model.transform.rotation = simd_slerp(
      model.transform.rotation,
      finalTargetRotation,
      0.15
  )
  

避坑提示：不要直接使用光线投射返回的射线方向向量计算旋转，射线方向是从相机指向场景，和“模型指向点击点”的向量方向完全相反，直接使用会导致朝向始终偏差180度。

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