visionOS中SwiftUI直接加载USDZ模型后如何访问其子实体？

方法1：递归遍历实体树查找子实体 #

直接加载USDZ模型后，子实体嵌套在主实体的children层级中，你可以通过递归遍历的方式定位到目标子实体。entity(named:)方法仅用于从bundle中加载独立的实体文件，无法查询已加载模型的内部子实体，所以需要手动遍历：

// 递归查找指定名称的子实体
func findChildEntity(named targetName: String, in parentEntity: Entity) -> Entity? {
    // 先检查当前实体是否是目标
    if parentEntity.name == targetName {
        return parentEntity
    }
    // 遍历所有子实体，递归查找
    for child in parentEntity.children {
        if let foundEntity = findChildEntity(named: targetName, in: child) {
            return foundEntity
        }
    }
    return nil
}

// 在RealityView中使用
RealityView { content in
    guard let mainModel = try? await Entity(named: "YourUSDZModel", in: realityKitContentBundle) else {
        print("模型加载失败")
        return
    }
    content.add(mainModel)
    
    // 查找目标子实体
    if let childEntity = findChildEntity(named: "TargetChild", in: mainModel) {
        // 示例操作：修改子实体位置和材质
        childEntity.position = [0, 0.3, 0]
        if var modelComp = childEntity.components[ModelComponent.self] {
            modelComp.materials = [SimpleMaterial(color: .blue, isMetallic: false)]
            childEntity.components[ModelComponent.self] = modelComp
        }
    }
}

小技巧 #

加载模型后可以先打印主实体的层级结构，确认子实体的名称和嵌套关系，避免拼写错误：

print(mainModel.children)

方法2：使用Reality Composer Pro预处理模型（推荐） #

这是更高效的方案，利用Reality Composer Pro保留实体命名和层级的特性：

1. 将USDZ模型导入Reality Composer Pro，在场景层级中给需要访问的子实体设置唯一且明确的名称
2. 将场景保存为.rcproject文件，添加到项目的RealityKit Content Bundle中
3. 在代码中加载整个场景，直接通过findEntity(named:)获取子实体：

RealityView { content in
    guard let composedScene = try? await Entity(named: "YourRCProjectScene", in: realityKitContentBundle) else {
        print("场景加载失败")
        return
    }
    content.add(composedScene)
    
    // 直接通过名称获取子实体
    if let targetChild = composedScene.findEntity(named: "TargetChild") {
        // 示例操作：缩放子实体
        targetChild.scale = [1.5, 1.5, 1.5]
    }
}

这种方式不需要手动遍历，代码更简洁，且实体名称在Reality Composer Pro中可视化管理，不易出错。

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