## 三、**SDK的使用** ## 开发空壳子程序解读 >1.” _启动子程序“&“_临时子程序”,这两个不需要去动它,易语言自动创建的 ___ >2.**初始化** >>[info]**info.置应用名** 本Api用于设置插件的名称,将你要的插件名以文本输入进去即可。 | 参数 | 类型 | | --- | --- | | 应用名 | 文本型 | >>[info]**info.置应用作者** 本Api用于设置插件的作者名字,将你要的作者以文本输入进去即可 | 参数 | 类型 | | --- | --- | | 作者名 | 文本型 | >>[info]**sb.添加&info.置应用说明** 这些Api用于设置插件的介绍,"sb.添加"可以添加任何类型的数据,并且可以多参数传入 | 参数 | 类型 | | --- | --- | | 欲添加的数据 | 通用型 | >>[info]**info.置应用版本 (“1.0.0”)** 此Api用于设置插件的版本,需要传入文本型数据,在这里可以填入您的插件的版本号。 | 参数 | 类型 | | --- | --- | | 版本号 | 文本型 | >>[info]**info.置应用权限申请** 此Api用于申请权限,在小栗子框架内,如果不申请权限,则无法使用相关功能,框架不会执行无权限的请求,所以使用Api必须申请相关的权限。 权限在模块内有常量,为“#权限_XX”,可以直接传入Api。 申请理由为必填项,但是可以传入“ ”空的数据。 | 参数 | 类型 | | --- | --- | | 权限 | 整数型 | |申请理由|文本型| >>[info]**info.置群消息处理函数** 此Api用于传入处理群消息的子程序,参数只有一个为“函数”,需要传入子程序指针(即引用符“&”+子程序名称) 例: ``` .版本 2 .支持库 commobj .子程序 初始化, 文本型, 公开, 初始化插件,其他语言的用户可以把函数名改为[apprun] .参数 apidata, 文本型 .参数 pluginkey, 文本型 .局部变量 info, 应用信息 .局部变量 sb, 快速文本对象 ...... //其他程序块 info.置群消息处理函数 (&收到群消息) //注意不要忘记 ...... //其他程序块 ``` ``` .版本 2 .子程序 收到群消息, 整数型, , 1后面的插件不再处理此消息,0后面的插件仍可处理此消息 .参数 数据指针, 整数型 .局部变量 数据, 群消息数据 ...... //省略其他程序块 ``` | 参数 | 类型 | | --- | --- | | 函数 | 子程序指针 | >>[info]**info.置私聊消息处理函数** 此Api用于传入处理私聊消息的子程序,参数只有一个为“函数”,需要传入子程序指针(即引用符“&”+子程序名称) 例程详见文档“**info.置群消息处理函数**” | 参数 | 类型 | | --- | --- | | 函数 | 子程序指针 | >>[info]**info.置事件消息处理函数** 此Api用于传入处理事件消息的子程序,参数只有一个为“函数”,需要传入子程序指针(即引用符“&”+子程序名称) 例程详见文档“**info.置群消息处理函数**” | 参数 | 类型 | | --- | --- | | 函数 | 子程序指针 | >>[info]**info.置插件被启用处理函数** 此Api用于传入处理启用插件的函数,参数只有一个为“函数”,需要传入子程序指针(即引用符“&”+子程序名称) 当用户选中插件并进行启用时,框架会调用此函数。 | 参数 | 类型 | | --- | --- | | 函数 | 子程序指针 | >>[info]**info.置插件被禁用处理函数** 此Api用于传入处理启用插件的函数,参数只有一个为“函数”,需要传入子程序指针(即引用符“&”+子程序名称) 当用户选中插件并进行禁用时,框架会调用此函数。 | 参数 | 类型 | | --- | --- | | 函数 | 子程序指针 | >>[info]**info.置将被卸载处理函数** 此Api用于传入处理卸载插件的函数,参数只有一个为“函数”,需要传入子程序指针(即引用符“&”+子程序名称) 当用户选中插件并进行卸载时,框架会调用此函数。 | 参数 | 类型 | | --- | --- | | 函数 | 子程序指针 | >>[info]**info.置点击插件设置处理函数** 此Api用于传入处理“菜单”软按钮被点击的函数,参数只有一个为“函数”,需要传入子程序指针(即引用符“&”+子程序名称) 当用户选中插件并进行菜单载入时,框架会调用此函数。 | 参数 | 类型 | | --- | --- | | 函数 | 子程序指针 | ___ >3.**群聊/私聊/事件处理函数** >>[danger]详见文档——消息子程序的解读 ___ >4.**菜单点击处理函数** >>[danger]详见文档——插件菜单的载入 ___ >5.**“被启用”解读** >>[danger]如果插件需要存放缓存之类的文件,不使用请把它注释掉,请使用此全局变量,请不要随意存放插件数据这样会造成用户困扰! 如果想拒绝被启用,返回#启用响应_拒绝。 默认返回值为“#启用响应_完成” 如果开发者对插件名字的要求或者别的要求,可以在这里进行检测,若不满足要求可以阻止插件的载入。 | 参数 | 类型 | | --- | --- | | 无 | * | | 返回值 | 类型 | | --- | --- | | #启用响应_拒绝 | 整数型(常量) | | #启用响应_完成 | 整数型(常量) | ___ >5.**“被禁用”解读** | 返回值 | 类型 | | --- | --- | | 0 | 整数型 | ___ >5.**“被卸载”解读** >>[danger]在这里关闭插件所有正在工作的线程,并释放内存 ### **本章完毕,感谢阅读!**