29 lines
1.7 KiB
Markdown
29 lines
1.7 KiB
Markdown
# 设计：Cesium 语义资产检查
|
||
|
||
## 边界
|
||
|
||
Blender 场景已按集合组织要素。Cesium 导出器在不修改作者场景的前提下，复用现有导出材质处理，先生成完整主 GLB，再按集合筛选对象生成道路、建筑、植被和水体四份辅助 GLB。主 GLB 继续是默认资产和兼容基线。
|
||
|
||
## 资产契约
|
||
|
||
metadata 保持现有 `asset` 字段指向主 GLB，并将 `assets` 扩展为：
|
||
|
||
- `main`：完整场景，默认启用；
|
||
- `roads`、`buildings`、`vegetation`、`water`：语义检查资产，默认关闭。
|
||
|
||
每个资产提供稳定的 `id`、中文 `label`、`type: model`、相对 `url` 与 `enabled`。旧 metadata 缺少这些额外资产时，预览按现有单资产回退路径加载。
|
||
|
||
## 预览交互
|
||
|
||
主场景模式只显示主 GLB，并保留现有 `Scene` 总开关。切入分类检查模式时隐藏主 GLB、显示四个类别复选项；选择类别时加载并显隐对应资产。离开分类模式后恢复主场景，避免完整模型和类别模型重叠渲染。
|
||
|
||
控制面板继续是贴边的紧凑工具面，不添加嵌套卡片。模式切换使用分段控件，类别开关按一行标签排列；窄屏时自然换行。颜色只用于状态和可访问性反馈，不做大面积装饰。
|
||
|
||
## 兼容与回滚
|
||
|
||
主 GLB、主 metadata 和既有预览文件名均不变。任意辅助 GLB 缺失时，预览记录该资产失败但完整场景仍可加载。回滚只需恢复旧 exporter/runtime，主产物仍可使用。
|
||
|
||
## 风险
|
||
|
||
多次导出会增加 Cesium 阶段耗时与磁盘占用，但只影响验证辅助产物，不改变主 GLB。导出时需确保每份辅助资产保留与主 GLB 相同的局部 ENU 坐标和材质处理。
|