iPad M1设备ARKit回放RealityComposer录制会话时应用冻结报错求助

错误分析 #

• Code=9 (CVAUserEvent元数据未知)：MOV文件的传感器元数据流无法被解析，通常是录制配置不匹配或文件损坏导致。
• Code=101 (传感器不可用)：元数据读取失败后，ARKit无法获取所需的传感器数据，触发会话失败。

具体修复步骤 #

• 验证MOV文件有效性

  • 用QuickTime打开录制的MOV，确认能正常播放；用MediaInfo工具查看文件是否包含完整的CVAUserEvent元数据流。
  • 确保录制时使用的ARKit配置与当前运行的配置完全一致（比如跟踪模式、平面检测、图像追踪等选项必须匹配）。

• 重置调试环境

  • 关闭Xcode，重启iPad设备；清理项目缓存（快捷键Command+Shift+K），重新构建并安装应用。
  • 进入iPad「设置-隐私与安全性」，确认应用的相机、定位权限已开启并设置为「始终允许」。

• 修正重放代码配置
  确保重放时未启用真实传感器相关功能，示例代码：

  let session = ARSession()
  let config = ARWorldTrackingConfiguration()
  
  guard let replayURL = Bundle.main.url(forResource: "test-recording", withExtension: "mov") else {
      fatalError("Replay file not found")
  }
  
  config.replayURL = replayURL
  // 禁用录制时未开启的功能，比如平面检测
  config.planeDetection = []
  session.run(config, options: [.resetTracking, .removeExistingAnchors])
  

• 重新录制测试影片
  使用当前版本的应用重新录制一段10秒内的简短影片，录制过程中保持设备稳定，完成后立即用该影片测试重放，排除旧文件的兼容性问题。

• 检查版本兼容性
  确认Xcode版本与iPadOS版本匹配（如Xcode 14对应iPadOS 16+），避免跨版本的元数据解析差异。

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