Apple Vision Pro：USDZ模型独立部件交互的层级问题求助

一、查看USDZ真实层级的准确方法 #

• 用USD官方命令行工具解析：USD提供的usdcat工具能直接输出USDZ的原始层级，这是最权威的方式。执行命令：

  usdcat -p yourModel.usdz
  

  输出结果会完整展示所有Prim（对应RealityKit的Entity）的名称、类型和父子关系，完全还原文件内部的层级结构，不会受第三方工具转换的影响。
• Blender中查看原始USD层级：导入USDZ后，在Outliner面板右上角的下拉菜单中选择USD视图层，这里显示的是模型原始的USD层级，而默认的Blender File视图层是Blender转换后的结构，别搞混了。
• Reality Composer Pro中查看原始层级：导入模型后，在Scene面板的层级树右键选择Show Original Hierarchy，就能看到未被软件自动调整的原始层级结构。

二、生成带正确独立部件层级的USDZ #

通过Blender导出 #

1. 导入模型后，先在USD视图层确认每个需要独立交互的部件都是单独的对象（Prim），没有被合并成单个Mesh。
2. 给每个部件设置清晰的名称（比如"Door"、"EngineCover"），避免默认的通用名称。
3. 导出时选择USD格式，在导出设置里：
   • 勾选Export USDZ直接生成目标格式；
   • 取消Merge Objects和Merge Materials选项；
   • 把Export Hierarchy设为Original；
   • 不要勾选Flatten Hierarchy，确保父子层级完全保留。

通过Reality Composer Pro调整导出 #

1. 导入原始USDZ后，如果发现部件被自动合并，右键点击合并的节点选择Unmerge拆分出独立部件。
2. 手动调整层级，把每个需要交互的部件放到合适的层级位置，确保每个都是单独的ModelEntity。
3. 导出时选择Export as USDZ，并勾选Preserve Hierarchy选项，防止软件优化层级结构。

三、优化层级调试代码，精准定位可交互部件 #

你现有的调试代码可以补充更多关键信息，帮你快速区分哪些是带模型的可交互实体：

func printEntityHierarchy(_ entity: Entity, level: Int = 0) {
    let prefix = String(repeating: "  ", count: level)
    let hasModel = entity.components.has(ModelComponent.self) ? "✅ 带模型组件" : "❌ 无模型组件"
    print("\(prefix)🔹 \(entity.name ?? "未命名实体") - \(type(of: entity)) | ID: \(entity.id) | \(hasModel)")
    
    for child in entity.children {
        printEntityHierarchy(child, level: level + 1)
    }
}

// 调用方式不变
if let modelEntity = modelEntity {
    printEntityHierarchy(modelEntity)
}

补充后能快速筛选出真正可交互的模型部件，避免把空容器实体当成目标。

四、确保部件能被点击检测的必要设置 #

每个独立部件要能被点击，必须添加碰撞组件：

func addCollisionToModelEntities(_ entity: Entity) {
    if var modelEntity = entity as? ModelEntity {
        // 自动生成适配模型的碰撞形状
        modelEntity.generateCollisionShapes(recursive: false)
    }
    for child in entity.children {
        addCollisionToModelEntities(child)
    }
}

然后添加点击手势监听，实现高亮逻辑：

let tapGesture = UITapGestureRecognizer(target: self, action: #selector(handleTap(_:)))
arView.addGestureRecognizer(tapGesture)

@objc func handleTap(_ gesture: UITapGestureRecognizer) {
    let location = gesture.location(in: arView)
    guard let tappedEntity = arView.entity(at: location) as? ModelEntity else { return }
    
    // 替换为高亮材质
    let highlightedMat = SimpleMaterial(color: .systemYellow, isMetallic: false)
    tappedEntity.model?.materials = [highlightedMat]
}

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