快速入门
Voxel Kit 是围绕体素内容建立的开发工具集:VF 用于创作与交换,VFP 用于发布和运行时资产封装。Python 与 HarmonyOS Kit 都具备 VFP 读取能力;HarmonyOS Kit 还提供 ArkUI 内的体素预览能力。
先理解三层能力
| 层级 | 解决的问题 | 从哪里开始 |
|---|---|---|
| 格式 | 体素内容如何表达、封装和验证 | VF 格式介绍 与 VFP 格式介绍 |
| Python Kit | 在服务端、CLI 与离线任务中读取、校验和导出 VFP | Voxel Kit for Python |
| HarmonyOS Kit | 在 ArkUI 中读取 VFP,并将 JSON / VFP 交给 VoxelViewer 预览 | Voxel Kit for HarmonyOS |
按任务选择入口
- 如果你正在设计资产链路,请从 VFP 格式 开始,并继续阅读技术标准。
- 如果你要在 Python 服务、CLI 或离线任务中读取 VFP,请阅读 Voxel Kit for Python。
- 如果你要在 HarmonyOS 应用中读取 VFP 或展示模型,请阅读 Voxel Kit for HarmonyOS。
- 如果你已有具体问题,请访问 开发者支持。
推荐阅读顺序
- 了解 VF 与 VFP 的职责边界。
- 根据运行环境选择 Python Kit 或 HarmonyOS Kit;两者都可以读取 VFP,HarmonyOS Kit 还可直接预览。
- 在接入前确认是否只需要预览,还是需要完整权威数据验证。
- 涉及编辑、发布或可信资产处理时,回到 VFP 技术标准中的
VOX0、Source Hash 和验证器规范。
文档约定
文档中的格式块和代码片段用于说明工作流。实际接入时,请以当前发布包内的类型声明和版本说明为准。