如何为3D .USDZ模型创建精准适配的CollisionShape？

数据老陈

2026-8-15

高精度贴合CollisionShape的实现方案

问题根源

你当前使用ShapeResource.generateConvex(from:)生成的是凸碰撞体，这类碰撞体为了优化性能会简化模型轮廓，对于带有凹面或分层结构的模型（比如你这个上下分层的模型），凸碰撞体可能会覆盖整个模型的外接范围，导致底部的可点击区域被顶部的碰撞体遮挡。

方法1：代码生成凹碰撞体（完美贴合模型）

直接使用模型原始网格生成凹碰撞体，能1:1贴合模型轮廓，解决遮挡问题。修改代码如下：

@objc private func placeObject() {
    let entity = try! Entity.load(named: "Laryngeal")
    let geom = entity.findEntity(named: "Geom")
    
    for children in geom!.children {
        guard let childModelEntity = children as? ModelEntity,
              let mesh = childModelEntity.model?.mesh else { continue }
        // 用原始网格生成凹碰撞体，完全贴合模型
        childModelEntity.collision = CollisionComponent(shapes: [ShapeResource(mesh: mesh)])
        // 触发碰撞体生成，确保交互检测生效
        childModelEntity.generateCollisionShapes(recursive: false)
    }
    
    let modelEntity = ModelEntity()
    modelEntity.addChild(entity)
    
    let anchorEntity = AnchorEntity(plane: .horizontal)
    anchorEntity.addChild(modelEntity)
    
    arView.installGestures([.all], for: modelEntity)
    arView.scene.addAnchor(anchorEntity)
}

方法2：建模软件手动制作碰撞体（最高精度）

如果模型结构复杂，代码生成的碰撞体仍有偏差，建议在Blender、Maya等建模工具中，为模型的每个交互区域（比如底部圆形）单独绘制精简的碰撞网格，导出时将碰撞网格标记为碰撞体（例如Blender中可将碰撞网格放入Collision集合），导入RealityKit后会自动识别为碰撞组件，完全精准控制可交互区域。