三维自定义模型检测与优化

适用场景：安装了「FineVis数据可视化」插件的用户，可参考本文了解 FineVis 的相关功能。

1.1 版本

1.2 功能简介

在上传三维自定义模型时，用户常因格式不符、模型过大或结构异常导致上传失败，且缺乏明确的错误提示，难以自行排查问题。

• V4.1.0 版本「模型管理」内新增模型检测功能，支持在上传前提示模型是否符合平台要求，并指出具体问题与优化建议，如格式不支持、模型未压缩等。

• V4.4.0 版本新增模型优化功能，支持用户在模型检测后对模型进行优化处理，如简化面数、清除无用节点，提升加载性能，以提高模型载入三维组件后的性能。

本文将以三维自定义场景组件为例，详细介绍三维自定义模型的检测与优化功能。

2.1 新建组件

1）点击设计器「文件>新建可视化看板」，创建一张空白看板。如下图所示：

2）点击组件区「3D>三维自定义场景」，即可将其添加到画布中，点击「编辑组件」，进入三维自定义场景编辑页面，生成一个空场景。如下图所示：

2.2 上传模型

本文提供模型资源可供用户试用，请点击下载解压后使用：智慧园区监控glb资源.zip

1）模型列表中未添加模型对象时，可点击「模型资源管理」或「添加模型」进入「模型管理」页面。如下图所示：

2）点击「上传模型」，选择需要的模型文件上传即可，支持多选模型批量上传。如下图所示：

注1：仅支持上传 .glb 格式模型文件，可通过  FineVis模型库 下载通用模型使用，更多模型相关问题可参考 三维模型相关文档快速引导 。

注2：glb 文件名称中不得包含【】中提到的字符 【 ? ! @ # $ ^ & % * + , : ; = ' \ " ` < > () [] {} / | 空格 】 。

3.1 正常模型

上传单个/多个模型时，若模型符合标准，直接上传成功，不弹出检测弹窗。

3.2 模型待处理

上传单个/多个模型时，若有模型可优化，弹出检测弹窗。支持显示优化提示和警示提示。

支持点击「继续上传」，上传后可在模型管理界面点击「查看」再次查看检测信息。

注：FVS V4.3.0 版本，对模型检测逻辑进行了优化，减少因检测规则过严而导致的上传受限情况。对于部分原本会判定为错误的模型，现在会处理为「待处理模型」的警示提示，用户可根据提示进行修复或优化，从而提升模型上传的成功率与使用体验。

1）模型上传前：在模型上传的界面上展示模型的优化提示或警示提示。

2）模型上传后：点击右下角「查看」，可在模型信息面板上展示出模型具体的检测信息。

3.3 错误模型

若模型不符合标准，「继续上传」按钮置灰，请修正模型后重新上传。

注：多模型同时上传时，弹出信息弹窗：有任一可上传模型时，可正常上传；所有模型都为错误模型时，「继续上传」按钮置灰。

V4.3.0 版本，对模型检测逻辑进行了优化，错误模型的错误提示分为以下两种：

1）错误提示中提供：错误码下载、错误信息说明

2）部分模型可能出现未知错误，系统无法提供错误码及说明信息。此类情况建议重新导出模型或联系帆软技术支持。

错误模型可上传至以下链接查看具体报错信息 ：https://sandbox.babylonjs.com/

上传模型后，「GLTF VALIDATION」中可看见错误数，点击「Report Details > Open」可打开查看具体错误信息。

注：Open 中打开的为 babylon 自带的默认校验逻辑结果，其中 severity 值为 0 的为具体错误。

注：与视频有出入的地方，以文档为准。

4.1 功能入口

若模型可进行优化，模型检测时或模型信息面板上会显示「模型待处理」以及具体优化提示。如下图所示：

点击面板上的「跳转到模型优化工具」按钮，即可进入模型优化界面。如下图所示：

在「模型优化工具」界面中点击上传按钮，或拖拽 glb 文件至上传区域，即可进行「自定义优化」操作或者「快捷优化」操作。

注：仅支持单次上传一个文件，建议单个文件大小不超过 500MB 。

• 点击「自定义优化」操作直接进入模型优化界面。

• 点击「快捷优化」操作，弹出优化操作窗口，提供多种的优化方案进行选择。

未清除浏览器缓存时重新打开模型优化工具页面，若检测到上次优化操作后的模型文件未下载，则弹出提示框。如下图所示：

点击确认后打开上一次模型优化的最新操作界面，点击取消则进入到模型上传界面。

4.2 快捷优化

点击「快捷优化」操作，弹出优化操作窗口。提供多种的优化方案，每种优化方案下方展示其优化步骤及参数。

在模型优化界面，也可在上方工具栏中点击「快捷优化」按钮重新进入快捷优化界面。默认选中上次的优化参数，点击新的优化参数类型并确认后，在上一次的模型优化结果上再次进行模型优化操作。

注1：快捷操作的合并 mesh 区别于手动操作，快捷操作的合并 mesh 是对所有的 mesh进行一次性优化。

注2：快捷优化里的操作为增量操作，将基于上次的优化结果进行优化。例如：首次选择低强度优化方案将模型质量压缩至 0.6，再次选择后，原始模型质量总压缩 0.36。

点击确认后进行快捷优化，点击取消后进入模型优化界面。

4.3 模型优化界面

点击「自定义优化」操作，即可进入模型优化界面。如下图所示：

4.4 模型优化

4.4.1 合并Mesh

将无需独立交互的部件合并为单一网格，减少 Mesh 数量以优化加载性能。

注：功能部件（如需旋转、选中交互的部件）建议保留独立结构，以便绑定数据。

支持自由选择模型节点进行合并操作，点击「合并」后即可执行合并操作。无可用合并内容时，按钮置灰。

4.4.2 删除无用节点

删除未包含有效信息的空节点，优化模型文件结构。

点击 「删除无用节点」 按钮，默认选中所有无用节点。支持按需手动选择待清除的模型节点，点击「删除」即可移除选中节点。

4.4.3 模型减面

适用于面数过多的模型，可在不影响外观的前提下降低模型复杂度。

注1：选择减面比例时需避免关键结构变形。

注2：模型减面后可能出现原点位置偏移，导致原符合标准的原点设置失效，重新设置原点即可恢复。

点击「模型减面」按钮，支持通过滑块拖动（步长 0.05）或文本输入（步长 0.01）调整倍数，取值范围为 0-1。数字越小，减面强度越高。

注：优化操作为增量操作，将基于上次优化的模型叠加进行。

4.4.4 Draco压缩

采用 Draco 扩展技术压缩模型文件体积，建议在最终导出前使用，可显著减小文件大小。

点击「Draco压缩」按钮即可执行压缩操作，执行成功后会提示「优化完成」。模型已执行过 Draco 压缩时，按钮置灰。

4.4.5 压缩贴图

适用于贴图分辨率过大（如 4K 贴图）的场景，可减少内存占用。支持自定义压缩参数，需平衡画质与性能。

点击「压缩贴图」按钮，支持进行分辨率压缩和质量压缩。

• 分辨率压缩：压缩纹理分辨率，支持选择 1/8、1/4、1/2。

• 质量压缩：压缩图片体积，支持滑块拖动（步长 0.05）或文本输入（步长 0.01），取值范围为 0-1。

注：优化操作为增量操作，将基于上次优化的模型叠加进行。

4.4.6 设置原点

自定义模型原点位置，便于后续对齐、旋转或放置操作。

注1：建议统一设置为模型底部中心或几何中心。

注2：优化操作为增量操作，将基于上次优化的模型叠加进行。

点击「设置原点」按钮，原点位置支持选择顶部、中心、底部。如下图所示：