如何利用iOS AVFoundation LiDAR获取真实距离及解决数据异常

针对你遇到的「将设备平行放置在0.3米墙前，但所有深度数据均大于0.3米」的问题，从代码逻辑和设备特性角度给出以下排查方向：

• 修复像素缓冲区的内存访问逻辑
  你的代码直接用 y * depthMapWidth + x 计算像素索引，但CVPixelBuffer的行内存存在**字节对齐（stride）**机制，实际每行的字节数（bytesPerRow）可能大于 width * 元素字节数，直接用宽度计算会导致索引偏移，读取到错误位置的深度值。
  修正后的内存访问代码示例：

  let bytesPerRow = CVPixelBufferGetBytesPerRowOfPlane(depthData.depthDataMap, 0)
  let elementsPerRow = bytesPerRow / MemoryLayout<Float16>.stride
  for y in 0..<depthMapHeight {
      let rowStart = rowData.advanced(by: y * elementsPerRow)
      for x in 0..<depthMapWidth {
          let distanceAtXYPoint = rowStart[x]
          // ... 后续逻辑
      }
  }
  

• 验证深度数据的有效性与质量
  观察你打印的 depthDataQuality 和 depthDataAccuracy：

  • 如果 depthDataQuality 不是 .high，说明LiDAR采集的数据质量不足（比如环境光线过暗、墙面反射率极低）；
  • 如果 depthDataAccuracy 是 .relative，数据仅能用于相对距离比较，无法提供绝对精度的米级数值；
    同时建议增加对数据有效性的判断：if depthData.isValid { ... }，避免处理无效的深度帧。

• 检查LiDAR的有效测距范围
  iPhone 14 Pro的LiDAR有效测距下限约为0.2米，但在极近距离（0.2-0.3米）可能存在精度波动，你可以尝试将设备移至0.5米左右测试，看数据是否回归正常，以此排除近距精度问题。

• 过滤无效深度值
  部分像素可能因遮挡、超出测距范围返回无效值（如NaN、极大值），你的代码直接取最小值可能包含这些无效数据。建议在读取时过滤：

  let distanceAtXYPoint = rowStart[x]
  guard !distanceAtXYPoint.isNaN, distanceAtXYPoint > 0.1, distanceAtXYPoint < 10 else {
      continue // 跳过无效值
  }
  

• 确认深度数据的单位与坐标系
  Apple官方文档明确，转换为 kCVPixelFormatType_DepthFloat16 后的深度值单位是米，坐标系以相机光学中心为原点，沿光轴向前为正。但需确保你没有误将其他坐标系的数据混入，比如未转换的原始深度数据。

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