通过代码添加的Reality Composer Pro材质无法正常渲染

在RealityView中通过代码直接加载Reality Composer Pro创建的ShaderGraphMaterial时，常出现纹理丢失的情况，但将材质预先绑定到模型再导入RealityView却能正常渲染，调整UV_Scale也无法解决。这是因为单独加载材质时，系统无法正确解析材质内部的纹理引用路径，导致纹理资源未被加载。

解决方案 #

方法1：从完整资产中提取材质 #

先加载包含目标材质的USDZ资产，再从资产内的模型中提取材质，系统会自动处理纹理的关联引用：

RealityView { content in
    // 加载包含材质的USDZ资产
    guard let asset = try? await Entity(named: "BrownLeather", in: realityKitContentBundle) else { return }
    // 从资产的子实体中提取材质
    if let targetMaterial = asset.children.compactMap({ $0.model?.materials.first }).first as? ShaderGraphMaterial {
        let sphere = ModelEntity(mesh: .generateSphere(radius: 0.1), materials: [targetMaterial])
        content.add(sphere)
    }
}

方法2：手动绑定纹理资源 #

如果必须单独加载材质，可手动加载纹理并赋值给材质的对应参数（需确认材质中纹理参数的名称，比如baseColorTexture）：

RealityView { content in
    guard var material = try? await ShaderGraphMaterial(named: "/BrownLeather", from: "BrownLeather.usdz", in: realityKitContentBundle) else { return }
    
    // 加载对应纹理资源（替换为你的纹理文件名）
    if let albedoTexture = try? await TextureResource(named: "BrownLeather_Albedo", in: realityKitContentBundle) {
        material.setParameter(name: "baseColorTexture", value: .texture(albedoTexture))
    }
    // 若有其他纹理（如法线、粗糙度），同理绑定
    if let normalTexture = try? await TextureResource(named: "BrownLeather_Normal", in: realityKitContentBundle) {
        material.setParameter(name: "normalTexture", value: .texture(normalTexture))
    }
    
    let sphere = ModelEntity(mesh: .generateSphere(radius: 0.1), materials: [material])
    content.add(sphere)
}

注意事项 #

• 确保纹理文件名与材质中引用的名称完全一致（区分大小写）
• 所有资源（USDZ文件、纹理图）需正确添加到Xcode项目，并勾选对应Target
• 优先使用方法1，避免手动绑定纹理可能出现的参数名称不匹配问题

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