1.7 KiB
1.7 KiB
设计: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 坐标和材质处理。