Forge Viewer新版模型浏览器链接rvt文件未按模型分类展示

新版模型浏览器默认不会自动按多模型来源做顶层分组，你通过rootFilename加载链接RVT时默认会将所有构件层级合并展示，才会出现全量混杂无序的问题，按下面的方式配置即可解决：

方案1：初始化时直接开启原生分组配置 #

官方v7+版本的模型浏览器扩展原生支持按模型分组，初始化Viewer时直接传配置参数即可，不需要额外开发自定义面板：

const viewer = new Autodesk.Viewing.GuiViewer3D(document.getElementById('viewerContainer'), {
  extensions: [
    {
      name: 'Autodesk.ModelStructure',
      options: {
        groupByModel: true, // 核心开关：开启后自动按所属模型做顶层分组
        defaultExpandDepth: 2
      }
    }
  ]
});

开启后面板顶层会优先展示每个加载的RVT文件名，每个文件下对应展示自身的构件层级，不会跨模型混杂。

方案2：已初始化Viewer的场景动态更新配置 #

如果Viewer已经完成初始化不想重载，可以等所有模型加载完成后，动态更新面板配置并刷新结构树：

// 等所有模型几何加载完成后执行
viewer.addEventListener(Autodesk.Viewing.GEOMETRY_LOADED_EVENT, () => {
  const structurePanel = viewer.getPanel('modelStructurePanel');
  if (structurePanel) {
    structurePanel.setGroupByModel(true);
    structurePanel.rebuild(); // 重建结构树生效
  }
});

避坑说明 #

如果你的Model Derivative转译任务配置了generateMasterViews: true参数，会生成合并后的主视图，上述配置会失效，转译时去掉这个参数、保留你原有rootFilename配置即可。

问题效果参考：

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