Vision Pro上RealityKit平面检测的旋转异常问题

可能原因 #

• MeshResource.generatePlane生成的平面默认坐标系与PlaneAnchor水平平面的坐标系在垂直轴旋转上存在隐性偏移，尽管变换矩阵数值一致，但实际渲染的轴对齐逻辑存在差异。
• Vision Pro空间感知系统偶尔出现初始化校准偏差，导致水平平面锚点的旋转数据产生微小误差（重启后偶发恢复的现象也印证了这一点）。

修复方案 #

方案1：针对水平平面单独校准旋转 #

创建平面实体时，根据PlaneAnchor的alignment属性对水平平面做额外旋转修正：

private func createPlaneEntity(anchor: PlaneAnchor) -> Entity {
    let mesh = MeshResource.generatePlane(width: anchor.geometry.extent.width, depth: anchor.geometry.extent.height)
    let material = SimpleMaterial(color: .init(red: CGFloat.random(in: 0.0..<1.0), green: CGFloat.random(in: 0.0..<1.0), blue: CGFloat.random(in: 0.0..<1.0), alpha: 0.5), isMetallic: false)
    let planeEntity = ModelEntity(mesh: mesh, materials: [material])
    
    planeEntity.setTransformMatrix(anchor.originFromAnchorTransform, relativeTo: nil)
    
    // 针对水平平面校准垂直轴旋转，角度值根据实际偏差调整
    if anchor.alignment == .horizontal {
        let correctionAngle = Float(-.pi / 180 * 5) // 示例：修正5度偏差
        planeEntity.transform.rotation *= simd_quatf(angle: correctionAngle, axis: [0, 1, 0])
    }
    
    return planeEntity
}

方案2：手动构建变换矩阵替代直接赋值 #

拆解锚点的位置、旋转和缩放属性手动构建实体变换，确保坐标系完全对齐：

private func createPlaneEntity(anchor: PlaneAnchor) -> Entity {
    let mesh = MeshResource.generatePlane(width: anchor.geometry.extent.width, depth: anchor.geometry.extent.height)
    let material = SimpleMaterial(color: .init(red: CGFloat.random(in: 0.0..<1.0), green: CGFloat.random(in: 0.0..<1.0), blue: CGFloat.random(in: 0.0..<1.0), alpha: 0.5), isMetallic: false)
    let planeEntity = ModelEntity(mesh: mesh, materials: [material])
    
    // 手动映射锚点变换属性
    planeEntity.transform.translation = anchor.center
    planeEntity.transform.rotation = anchor.orientation
    planeEntity.transform.scale = [anchor.geometry.extent.width, 0.01, anchor.geometry.extent.height] // 添加微小厚度避免渲染异常
    
    return planeEntity
}

方案3：优化Session配置与校准 #

给空间感知系统预留初始化时间，避免启动后立即检测平面：

let planeDetection = PlaneDetectionConfiguration.Setting.horizontal
let planeData = PlaneDetectionConfiguration(setting: planeDetection)

// 延迟2秒启动平面检测
DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
    Task {
        try await session.run([planeData])
        isPlaneDetectionRunning = true
    }
}

验证建议 #

开启RealityKit调试选项，可视化锚点坐标系轴，对比实体与锚点的对齐情况：

arView.debugOptions = [.showAnchorOrigins, .showAnchorGeometry]

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