跳到主要内容

控制器插件

控制器插件结构

控制器插件包主要包含三个文件,插件.so 插件.lic 插件.json文件。
以只包含一个控制器插件的插件包为例:

插件包.zip  
  └──controller.zip
└──example
      ├──example.lic
      ├──example.so  
      └──example.json

controller.zip可包含多个控制器插件,每个控制器插件文件名和json,lic,so文件都必须一致。其中so文件json文件由用户生成,lic文件由珞石生成。
so文件的动态库是用户根据提供的API和编译环境生成的产物,json文件由用户填写,各字段含义如下:

{
    "controller_plugin":{//描述是一个控制器插件
        "example":{//插件名称
            "name": "example",//插件名称,需要一致
            "depend":["plugin1","plugin2"],//依赖的插件
            "enable":true,//是否启用,不启用不加载
            "min_controller_version":"3.0.2",//该插件运行最小控制器版本
            "must_controller_version":[],//该插件只在这些控制器版本运行,覆盖最小版本
            "version": "1.0.0",//用户自定义插件的版本号,建议包含插件使用的api版本
            "author": "rokae",//该插件的名称
            "description": "description info"//该插件的描述信息
        }
    }
}

控制器插件加载时候会先校验包的格式,不符合上述规则的不会加载。

编译运行环境

编程语言:c++11
珞石提供虚拟机开发环境,可在官网下载和运行控制器。
联系珞石获取虚拟机使用流程。