Autodesk Forge Viewer单模型多SVF文件加载与合并问题咨询

一、自动加载所有SVF文件的实现方式 #

当模型转换后生成多个SVF文件时，可通过以下步骤实现自动加载：

1. 解析Manifest获取所有SVF路径 #

调用Model Derivative API的GET /modelderivative/v2/designdata/{urn}/manifest接口，遍历返回的清单数据，提取所有类型为svf的衍生文件标识：

async function getAllSvfUris(urn, accessToken) {
    const manifest = await modelDerivativeClient.getManifest(urn, { accessToken });
    const svfUris = [];
    const traverse = (children) => {
        children.forEach(child => {
            if (child.type === 'resource' && child.role === 'viewable' && child.mime === 'application/autodesk-svf') {
                svfUris.push(child.urn);
            }
            child.children && traverse(child.children);
        });
    };
    traverse(manifest.derivatives);
    return svfUris;
}

2. 批量加载至Viewer实例 #

获取所有SVF路径后，在Viewer初始化完成后，依次加载每个SVF对应的视图节点，确保加载顺序和完成状态：

async function loadAllSvfs(viewer, documentId, svfUris) {
    const doc = await viewer.loadDocument(documentId);
    for (const uri of svfUris) {
        const viewableId = uri.split('/')[1]; // 提取GUID匹配视图节点
        const viewable = doc.getRoot().findByGuid(viewableId);
        await viewer.loadDocumentNode(doc, viewable);
    }
}

通过此方式，可实现基于URN初始化后自动加载所有关联SVF文件，无需手动操作。

二、合并为单个SVF文件的调整方案 #

部分Revit模型生成多SVF是APS为优化性能自动拆分的结果，可尝试调整转换参数强制生成单个文件：

修改转换请求参数 #

在转换代码的advanced配置中添加splitGeometry: false，禁用模型自动拆分：

service.translateObject = async (urn, rootFilename) => {
    const accessToken = await getInternalToken();
    const job = await modelDerivativeClient.startJob({
        input: {
            urn,
            compressedUrn: !!rootFilename,
            rootFilename
        },
        output: {
            formats: [{
                views: [View._2d, View._3d],
                type: OutputType.Svf,
                
            }],               
            advanced: {
                generateMasterViews: true,
                splitGeometry: false // 禁用模型拆分
              }

        }
    }, { accessToken });
    return job.result;
};

注意事项 #

• 禁用拆分后，大型模型的转换时长、SVF文件体积会显著增加，可能影响加载速度和渲染性能；
• 超大型模型即使设置该参数，APS仍可能自动拆分，这是平台的资源保护机制。

三、现有挑战的补充解决建议 #

• 模型对比问题：采用自动加载方案后，Diff工具可基于完整加载的模型进行对比；或通过转换阶段生成单个SVF从根源解决冲突；
• 加载不一致问题：批量加载时监听Viewer的GEOMETRY_LOADED_EVENT事件，确保前一个SVF几何数据完全加载后再启动下一个加载流程，避免显示异常。

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