SceneBuilder创建的自定义几何体在AggregatedView中渲染优先级低问题咨询

问题根因 #

在AggregatedView模式下，Viewer会对大型模型执行渐进式重渲染操作，通过modelBuilder.addFragment添加的自定义片段默认和原生模型片段处于同一渲染队列，会被延迟处理；而Overlay是独立的渲染层，不受原生模型渐进渲染逻辑的影响，因此不会出现消失延迟的现象。

几种可行的解决办法 #

1. 直接移到Overlay场景（最省心）

既然Overlay没有这个问题，直接把自定义模型加到Overlay里即可：

// 创建自定义Overlay场景
const overlay = viewer.overlayScenes.addScene('custom-overlay');
// 生成网格并添加到Overlay
const sphereMesh = new THREE.Mesh(sphereGeometry, sphereMaterial);
sphereMesh.matrix.copy(sphereTransform);
sphereMesh.matrixAutoUpdate = false;
overlay.addMesh(sphereMesh);

如果需要实现自定义模型和原生模型的交互（比如拾取、高亮），自行补充对应的拾取判断逻辑即可。

2. 手动提升自定义片段的渲染优先级

Viewer的片段列表支持设置渲染优先级，数值越小优先级越高，原生模型片段默认优先级大概在100左右，你可以将自定义片段的优先级设得更低：

// 添加片段后获取对应的ID
const fragmentId = modelBuilder.addFragment(sphereGeometry, sphereMaterial, sphereTransform);
// 获取模型的片段列表
const fragList = viewer.model.getFragmentList();
// 设置高优先级，例如设为10
fragList.setPriority(fragmentId, 10);

注意：这个方法在AggregatedView模式下的效果可能受Viewer内部渲染策略影响，需要实际测试验证。

3. 移除自定义片段的渐进渲染标记

Viewer会给片段添加IS_PROGRESSIVE标记，带有该标记的片段会被纳入渐进渲染队列，移除这个标记就能让片段优先被渲染：

const fragmentId = modelBuilder.addFragment(sphereGeometry, sphereMaterial, sphereTransform);
const fragList = viewer.model.getFragmentList();
// 将IS_PROGRESSIVE设为false
fragList.setFragmentUserData(fragmentId, { IS_PROGRESSIVE: false });

这样Viewer在重渲染时会优先处理该自定义片段，不会被原生模型的渐进渲染流程阻塞。

4. 用CustomMeshProvider精细控制（适合多自定义模型场景）

如果有大量自定义模型需要处理，可以注册自定义网格提供者，直接控制渲染时机：

viewer.registerCustomMeshProvider({
    getMesh: (dbId, fragId, callback) => {
        // 仅处理目标自定义片段
        if (fragId === yourCustomFragmentId) {
            callback(null, sphereMesh);
        } else {
            callback(null, null);
        }
    }
});

这种方式可以绕过原生的渐进渲染队列，确保自定义模型优先被渲染。

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