自定义功能单元开发规范

ModelBox功能单元作为ModelBox调度的最小单元，可以构建成图的形式利用图编排引擎进行运行，也可以单独作为API形式提供功能。ModelBox提供一套功能单元框架，用户可以开发自定义功能单元。

开发流程如图1所示。

图 1 开发流程

1. 创建样例

   ModelBox 提供功能单元的基础样例工程，输入功能单元名称即可自动化创建对应文件，包含功能单元定义、接口、及测试框架。考虑到用户易用性，ModelBox功能单元支持多语言开发，支持C++ 和Python。

2. 功能单元属性

   设置当前功能单元的属性，包含名称、版本号、运行设备类型，参数列表等。

3. 功能单元接口

   根据需要实现的功能单元业务逻辑，实现功能单元对应接口。主要提供如下接口：

   接口	接口类型	接口功能	是否必须
   功能单元打开	功能单元初始化接口	创建功能单元时调用	否
   功能单元关闭	功能单元初始化接口	功能单元销毁时调用	否
   功能单元处理	数据处理接口	数据产生时调用	是
   流数据开始	数据处理接口	流数据开始时触发	否
   流数据结束	数据处理接口	流数据结束时触发	否
   流数据合并开始	数据处理接口	流数据合并时，流开始点触发	否
   流数据合并结束	数据处理接口	流数据合并时，流结束点触发	否

4. 运行测试

   功能单元样例工程提供测试框架，用户根据业务场景，构造的功能单元数据，增加功能单元的输出数据校验，即可实现功能单元的本地调试，也可将多个功能单元构建成一个完整的图进行调试。