跳到主要内容

快速入门

Voxel Kit 是围绕体素内容建立的开发工具集:VF 用于创作与交换,VFP 用于发布和运行时资产封装。Python 与 HarmonyOS Kit 都具备 VFP 读取能力;HarmonyOS Kit 还提供 ArkUI 内的体素预览能力。

先理解三层能力

层级解决的问题从哪里开始
格式体素内容如何表达、封装和验证VF 格式介绍VFP 格式介绍
Python Kit在服务端、CLI 与离线任务中读取、校验和导出 VFPVoxel 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
  • 如果你已有具体问题,请访问 开发者支持

推荐阅读顺序

  1. 了解 VFVFP 的职责边界。
  2. 根据运行环境选择 Python Kit 或 HarmonyOS Kit;两者都可以读取 VFP,HarmonyOS Kit 还可直接预览。
  3. 在接入前确认是否只需要预览,还是需要完整权威数据验证。
  4. 涉及编辑、发布或可信资产处理时,回到 VFP 技术标准中的 VOX0、Source Hash 和验证器规范。

文档约定

文档中的格式块和代码片段用于说明工作流。实际接入时,请以当前发布包内的类型声明和版本说明为准。