(一)了解 CLI 控制台
进入 “CLI控制台” 应用后,可以看到:
CLI控制台的形式非常简明,由五个部分构成,分别是:
- A. Block列表
- B. 接口命令列表
- C. 命令发生
- D. 命令响应(测试返回结果)
- E. 帮助
“CLI控制台” 应用的使用顺序很简单:
我们先做一个试一下,直观了解一下 “CLI控制台”。假设,我们现在正在开发自己的定制需求,正好需要查询“调度控制”的“调度项目”这个接口:
通过这个查询可以知道,这个命令的格式是 {“action”:”get_system_list”},返回的结果是:
(二)MixIOT Block
Block是MixIOT体系里面非常重要的概念。简单地说,MixIOT Block就是MixIOT体系内,以独立形式存在的“应用服务”。也就是说,“应用服务”是“应用,以及支撑这个应用的 MixIOT 服务”,或者是 “MixIOT服务”。
我们都知道,MixIOT 应用的形式是独立的。绝大多数的 MixIOT 应用,与该应用对应的服务,是一一对应的。从这个意义上说,应用跟Block实际上是一回事。
但 MixIOT 里面实际上还有大量的的独立服务组件,但这些服务组件并没有直接形成独立的应用。
(三)了解CLI控制面板
如果要编写 “调度控制” 的调度程序,编写 “任务管理” 的任务,或者去开发自己的 MixIOT 的应用,都需要用到CLI控制面板应用。
我们以Block adaps(特征检测)为例,来讲解每个Block的接口命令的构成,以及接口命令正确的使用方法。
使用顺序前面说过:
- 选择Block;
- 选择该Block的命令,可以通过查询找到我们想要的命令;
- 看一下该命令的帮助,了解一下这个命令是做什么的,基本格式是什么,返回格式是什么,以及使用这个命令可能会有什么异常,如何处置这些异常;
- 可以试一下,把这个命令发送出去,这里要注意的是,也要看这条命令格式中,还需要补充什么参数;
- 看一下,这个发出去的接口命令会有什么样的一个响应返回。
按步骤,在 Block 列表里面选择 adaps,这个就是 “特征检测” 应用,这个 Block 的命令:
这些命令有两部分:
第一部分是基础命令,无论什么Block,都有这些基础的接口命令。这些命令包括测试接口服务本身有没有正确响应的、接口安全的、接口信息、接口配置以及接口状态;关于接口命令查询和描述;关于接口调试模式、接口使用统计、日志;还有跟Block有关的系统事件、用户事件和事件处理。
另一部分是跟这个Adaps Block“特征检测”应用的两个板块有关的内容,比如特征检查项目的创建、编辑、删除,特征项目详情,启动和停止项目,以及查询特征检测结果。
其实不难看出,在 “特征检测” 应用上,人机交互能看到、能做到的,接口命令实际上都能做到。看一个具体的接口命令,这个接口命令 “get_version” 的返回,内容非常丰富。
再看—下接口使用统计的接口:
把这个结果翻译成容易看得懂的样子:
通过这个命令,我们可以了解到这个接口命令的使用情况。