展开本页目录
开始前准备什么
- 可编辑作者网格与glTF JSON；使用目标查看器时记录版本及扩展支持。
- 作者网格不是TRELLIS.2或Magnific已经生成的结果；目标推理保持not_run。
- 选定稳定业务身份
- 写入extras
- 登记碰撞意图
- 导出后读回
- 测试属性丢失负例
- 检查消费方契约
- 交付映射与限制
1. 选定稳定业务身份
作者模型使用SKU LT-03、部件IDbody/cap，另附来源标记author-mesh。节点name可读但不是唯一业务ID，不能按显示顺序识别。
2. 写入extras
在节点extras放product_id、part_id、source_identity等应用自定义字段。glTF允许自定义数据，但字段含义由你的应用契约定义。
3. 登记碰撞意图
作者标记collider_hint=box仅表示建议，不是glTF核心碰撞功能。目标引擎须有显式导入逻辑才会建立物理组件。
4. 导出后读回
用JSON或GLB解包读回节点extras，检查重复SKU是否符合部件层级。不能只在DCC界面看到自定义属性就当文件保留。
5. 测试属性丢失负例
另存一个移除extras的作者副本，查看应用是否报告缺ID。不要用节点数组索引偷偷补回，以免下次重排错配。
6. 检查消费方契约
在应用侧按part_id定位，不按node.name或导入顺序；无法识别字段时明确忽略/报错规则。碰撞体是否创建单独检查。
7. 交付映射与限制
附业务ID表、原生文件和消费方字段说明，标注这不代表模型真实尺寸、许可或物理稳定性自动通过。
下载本课材料并开始操作
练习包包含本课的具体输入、可编辑数据、正反样例与七步说明。index.html 可离线查看原件和验收参考，actual-results.csv 用于记录你实际操作后的结果。
怎样确认已经完成
- 原始参数、正确设置与错误对照来源一致，实际文件重新读取。
- 作者源和目标云端结果明确标记，未执行不填写生成ID或成功效果。
- 按本课具体数值或字段核对，不用通用流程图代替操作图。
常见问题
glTF extras 自定义属性 SKU怎么检查？
为节点在 extras 保存稳定 product_id、part_id 与来源标记，导出后独立读回并测试下游保留。collider_hint 只是应用约定，目标引擎需明确解析才会创建物理碰撞组件。
AI模型交接丢SKU，直接重新生成有用吗？
用JSON或GLB解包读回节点extras，检查重复SKU是否符合部件层级。不能只在DCC界面看到自定义属性就当文件保留。 先隔离参数与输入，再决定是否需要目标模型重新生成，不能把显示链路错误都归为AI生成失败。