第二章:用户手册

本章面向应用开发者,介绍如何使用 robonix 提供的接口编写具身智能应用。

本章内容

本章重点介绍 robonix 为应用开发者提供的编程接口和工具:

核心编程模型

  • Virtual Entity Graph (VEG):虚拟实体图模型,统一抽象机器人、传感器、物体等实体及其关系
  • Capability API:系统提供的原子能力接口(硬件抽象层)
  • Skill API:组合多个 Capability 的复合技能接口
  • Action 编程:声明式的任务编排和执行模型

数据与协议

  • 数据格式规范:传感器数据、控制指令等标准格式
  • 坐标系约定:统一的空间坐标系定义
  • 时间戳规范:时间同步和时间戳管理

学习路径

  1. 新手入门:从 Virtual Entity Graph 开始,理解 robonix 的实体抽象模型
  2. 掌握能力系统:学习 Capability APISkill API
  3. 编写应用:通过 Action 编程 编排任务
  4. 深入实践:查看 编程示例编程指南

设计理念

robonix 的用户接口设计遵循以下原则:

  1. 软硬解耦:智能算法与硬件实现分离,应用代码与具体硬件无关
  2. 分层抽象:Capability-Skill-Action 三层抽象,逐步提升编程层次
  3. 声明式编程:描述"做什么"而非"怎么做",降低编程复杂度
  4. 类型安全:完整的类型系统保证接口正确性

注意:本章只讲接口如何使用,不涉及系统内部实现细节。如需了解架构设计和实现原理,请参阅第三章:开发文档