按键精灵手机版插件的开发标准草案与简易教程

2022-03-16 23:22栏目:编程
TAG:

什么是按键精灵手机版插件?
按键精灵手机版可以通过Lua编程语言实现更加高级的功能扩展,例如大家熟知的紫猫插件就是通过Lua编程语言实现的。

为什么要制定插件开发标准草案?
一个优秀健壮的插件应该在不影响他人插件,不影响脚本自身等情况下提供可靠的功能扩展。
紫猫插件手机版在多年开发的过程中,踩过各种各样的坑,深知一个优秀插件开发的不易。
故本贴主旨是为了帮助大家少走弯路,通过统一的插件开发标准实现稳健的功能扩展。

本帖子适合哪些人阅读?

本帖子并非Lua编程教学,不适合对Lua编程语言完全不懂的人阅读。

如果你想要学习Lua编程,可以报名我们Lua课程学习,也可以查阅各种Lua文档资料学习。

本帖子主要以插件开发标准规范为主,适合已经会写一些Lua代码实现插件制作的人阅读。

如无特殊说明,本帖子中的代码均为Lua代码。

1. 按键精灵手机版插件开发简易教程

通过一个table类型的QMPlugin变量实现按键精灵调用Lua函数,例如

将以上代码保存成.lua文件,例如test.lua后,放入按键精灵手机助手的plugin文件夹内。

再重启按键精灵手机助手或者刷新插件列表,即可看到自己写的test插件了。

在按键精灵中调用代码如下

2. 函数作用域的标准草案

所有变量与函数均使用local关键字定义成局部作用域(除了自带的QMPlugin外)。

因为多个插件是共用同一个全局作用域,假如插件A定义了一个全局函数Add,然后插件B也定义了同名但不同功能的全局函数Add,当脚本里同时加载这两个插件时,有一定概率会造成某一个插件内部Add函数被覆盖,导致该插件功能异常。例如紫猫插件V1版时期与山海师插件就造成过函数覆盖冲突,当然,现在的紫猫插件是不会与任何插件冲突了,因为插件内部全是局部作用域的函数。

一个简易的冲突例子演示,一个是相加功能的add,一个是返回第一个参数的add,但是由于全局冲突原因,导致有一定概率只返回一个功能。如果两个add函数前面加上local关键字即可完美解决该问题。

按键精灵调用出现异常的截图。


3. 函数定义的标准草案

定义两个局部作用域的table数据,一个用来存放对外公开函数,一个用来存放对内私有函数,注意不要跟插件文件同名。

例如以下插件源码

尽可能的减少其他多余的插件级局部变量,这里的插件级局部变量是指与以上源码中_zimao和zimao相同作用域的变量。因为同级局部变量最多只能存放200个,这是紫猫插件命令功能首次超过200个时,遇到了错误:too many local variables (limit is 200) in main function near =后,查阅资料得知,Lua使用一个栈存放它的寄存器,每个运行中的函数都有各自的一份活动记录,这些活动记录保存在栈中,内部存放每一个函数对应的寄存器。每条指令中只有8个bit用来标志寄存器,所以每个函数最多能够使用250个寄存器。为了空间与执行效率,Lua在lpaser.c源文件中定义了默认最多200个局部变量。但通过借助table数据类型,可以突破整个限制,减少局部变量总数。

所以这里我们推荐通过两个table变量来存放数据,适当的减少局部变量。当然,function函数内部的局部变量一般不会超过200个,所以函数中不用担心这个问题。

4. 函数结构的标准草案

为了避免插件内部各种意外错误导致脚本终止运行,推荐使用保护运行模式执行函数代码。这里提供一份Lua版的自定义try...catch...finally函数,利用这三个函数可以实现异常捕获处理,下面是这3个函数的用法,可以单独只用try,也可以使用try+catch,也可以try+catch+finally。

代码截图:


我们把这个保护执行加到我们的插件代码中,以下是一个完整的插件例子。

更多插件Lua源码例子可以参考按键精灵手机助手Plugin目录下的zmFile.lua文件。

代码截图:


按键精灵执行效果截图:

本期感谢作者的分享,想要获取源码素材,推荐玩家关注按键精灵论坛,知乎账号,“按键精灵”获取!!有任何问题也可以在底部留言或者私信小编。


本篇详细内容可点击:按键精灵手机版插件的开发标准草案与简易教程 _ 【集结令●英雄归来】教程比武大赛 - 按键精灵论坛

本文来自网络,不代表山斋月平台立场,转载请注明出处: https://www.shanzhaiyue.top