visionOS RealityKit物理模拟因实体缩放值异常失效问题问询

问题核心 #

在visionOS 2.0（Xcode 16.0模拟器）环境下，当带物理组件的父实体（board）缩放因子小于0.91时，其子实体（box）的动态物理模拟完全失效——box直接静止在board表面，无重力下落过程；但缩放因子≥0.91时，物理表现符合预期。

可能原因 #

RealityKit物理引擎处理实体缩放时，大概率存在以下逻辑异常：

• 碰撞形状自动生成未正确同步实体缩放变换，导致缩放后的碰撞体精度丢失或碰撞检测逻辑异常
• 物理体组件内部计算依赖实体本地缩放，当缩放因子接近1但低于阈值时，触发引擎精度判定bug，动态实体被错误判定为静止状态
• 父实体的缩放未正确传递给子实体的物理模拟上下文，子实体物理计算基于未缩放的父空间

验证与解决方案 #

方案1：直接缩放网格而非实体（推荐） #

避免对带物理组件的实体进行缩放操作，改为生成网格时直接使用目标尺寸，确保物理系统基于原始比例计算：

func makeBoard() -> ModelEntity {
    let scale: Float = 0.9 // 任意缩放因子都可正常工作
    // 直接生成缩放后的网格，实体scale保持默认(1,1,1)
    let mesh = MeshResource.generateBox(width: 1.0 * scale, height: 0.05 * scale, depth: 1.0 * scale)
    var material = UnlitMaterial(); material.color.tint = .red
    let boardEntity = ModelEntity(mesh: mesh, materials: [material])
    
    boardEntity.transform.translation = [0, 0, -3]
    
    boardEntity.generateCollisionShapes(recursive: false)
    
    boardEntity.physicsBody = PhysicsBodyComponent(massProperties: .default, 
                                                   material: PhysicsMaterialResource.generate(friction: .infinity, restitution: 0.8), 
                                                   mode: .static)

    return boardEntity
}

方案2：缩放后重新生成碰撞形状 #

若必须缩放实体，需在设置缩放后重新生成碰撞形状，确保碰撞体与实体视觉尺寸匹配：

func makeBoard() -> ModelEntity {
    let mesh = MeshResource.generateBox(width: 1.0, height: 0.05, depth: 1.0)
    var material = UnlitMaterial(); material.color.tint = .red
    let boardEntity = ModelEntity(mesh: mesh, materials: [material])
    
    let scale: Float = 0.9 
    boardEntity.scale = [scale, scale, scale]
    
    boardEntity.transform.translation = [0, 0, -3]
    
    // 先设置缩放，再生成碰撞形状
    boardEntity.generateCollisionShapes(recursive: false)
    
    boardEntity.physicsBody = PhysicsBodyComponent(massProperties: .default, 
                                                   material: PhysicsMaterialResource.generate(friction: .infinity, restitution: 0.8), 
                                                   mode: .static)

    return boardEntity
}

方案3：分离视觉与物理实体 #

将实体的视觉表现和物理模拟分离，视觉实体可自由缩放，物理实体保持原始尺寸并与视觉实体同步位置：

func makeBoard() -> Entity {
    let scale: Float = 0.9
    // 视觉实体（可缩放）
    let visualMesh = MeshResource.generateBox(width: 1.0, height: 0.05, depth: 1.0)
    var visualMaterial = UnlitMaterial(); visualMaterial.color.tint = .red
    let visualEntity = ModelEntity(mesh: visualMesh, materials: [visualMaterial])
    visualEntity.scale = [scale, scale, scale]
    
    // 物理实体（不可缩放，负责物理模拟）
    let physicsMesh = MeshResource.generateBox(width: 1.0 * scale, height: 0.05 * scale, depth: 1.0 * scale)
    let physicsEntity = ModelEntity(mesh: physicsMesh, materials: [UnlitMaterial(color: .clear)])
    physicsEntity.generateCollisionShapes(recursive: false)
    physicsEntity.physicsBody = PhysicsBodyComponent(massProperties: .default, 
                                                     material: PhysicsMaterialResource.generate(friction: .infinity, restitution: 0.8), 
                                                     mode: .static)
    
    // 将视觉实体作为物理实体的子节点
    physicsEntity.addChild(visualEntity)
    physicsEntity.transform.translation = [0, 0, -3]
    
    return physicsEntity
}

Bug确认建议 #

上述方案可规避问题，但原现象符合引擎bug特征。建议通过以下步骤确认后提交Bug报告：

1. 在visionOS 2.0真机上复现问题，排除模拟器特有异常
2. 测试0.8、0.5等不同缩放值，确认是否存在固定阈值（0.91）
3. 使用自定义碰撞形状替代自动生成，验证问题是否依然存在

内容的提问来源于stack exchange，提问作者Reinhard Männer