ios/安卓脚本工具按键精灵新手教程—插件和命令库开发指南

对于按键精灵新手来说，掌握 Lua 插件和命令库是提升脚本编写效率的关键。本文将详细讲解这两个核心概念，帮助你理解它们的作用、区别以及如何实际应用。

在按键精灵的 Lua 编程环境中，插件和命令库都是代码复用的重要方式，但它们的定位和使用场景有所不同：

插件（Plugins）：通常是一个独立的.lua文件，包含一组相关功能的封装，用于实现特定业务逻辑

命令库（Command Libraries）：更偏向于基础功能集合，提供通用操作接口，类似 SDK（软件开发工具包）

简单来说，插件更偏向于 "业务功能"，命令库更偏向于 "基础工具"。

LUA 插件介绍：

按键精灵支持使用 Lua 编写插件扩展功能。在 Lua 中，只需按照以下格式定义函数，即可将其导出供按键精灵调用：

function QMPlugin.FuncName(par1, par2, par3, ...)
    -- 函数实现
end

插件使用步骤

在按键精灵安装目录下的 Plugin 文件夹中创建一个新的 .lua 文件；
使用常见的代码编辑器（如 VS Code）打开并编写 Lua 插件代码；
编写完成后，在按键精灵左侧的【全部命令】中，右键点击【插件命令】，选择【刷新】；
创建一个新脚本，在开头使用 Import 命令导入插件文件（例如 Import xx.lua，其中 xx 是插件文件名）；
在代码中通过 xx. 前缀调用插件中定义的函数。

注意事项

所有定义在 QMPlugin 命名空间下的函数会自动导出供按键调用（仅支持导出函数）；
Lua 插件函数支持多个参数，且在按键中支持可选参数；
插件函数名不支持中文；
函数外的代码不会被执行（定义变量除外）；
插件中的 print 语句无法在按键界面输出，如需调试，请使用 LuaAuxLib.TracePrint，其效果与按键中的 TracePrint 命令一致。

示例说明：

-- 此代码在函数外，按键运行时不会执行
local debug = true
if debug then
    print('debug mode')
end

-- 正确的写法应将代码封装在函数中，才能被按键执行
function QMPlugin.FuncName(par1, par2, par3, ...)
    -- 函数实现
end