三维自定义模型检测

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

1.1 版本

1.2 功能简介

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

V4.1.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 的为具体错误。