1、DecryptGUIminiknife 2017-09-27 18:51 字数 119624 阅读 480798触动精灵脚本开发手册开发手册 触动精灵Windows 平台按 Ctrl + F 打开快捷搜索Mac 平台按 command + F 打开快捷搜索右侧文本列表可以找到全部手册目录触动精灵脚本开发手册目录前言学习前的准备越狱及 root 常识Lua 基础简明教程脚本开发取色技巧小白学触动零基础视频教程触动精灵开发者指南触动产品功能对比如何查看更多文档脚本开发相关工具触动精灵 iOS触动精灵 Android脚本编辑器：TouchSprite Studio抓色器：TSColorPicker已
2、兼容的模拟器点击触摸函数：touchDown、touchUp、touchMove 触摸点击、滑动函数：catchTouchPoint 获取用户点击坐标图色类及屏幕相关函数：init 初始化函数：getDeviceOrient 获取手机、应用屏幕方向（仅支持 iOS）函数：setDeviceOrient 设置屏幕方向（仅支持 iOS）函数：getScreenSize 获取屏幕分辨率函数：setScreenScale 坐标缩放函数：keepScreen 保持屏幕函数：getColor、getColorRGB 获取屏幕某点颜色值函数：findColorInRegionFuzzy 区域模糊找色函数：f
3、indImageInRegionFuzzy 区域模糊找图函数：findMultiColorInRegionFuzzy 区域多点找色函数：findMultiColorInRegionFuzzyExt 高级区域多点找色函数：findImage 高级区域找图（仅支持 iOS）函数：snapshot 截图函数：imageOperMerge 图片合并（仅支持 iOS）开发辅助类函数：initLog、wLog、closeLog 日志函数函数：sysLog 系统日志函数：nLog 远程日志脚本控制函数：mSleep 延时函数：lua_exit 退出脚本函数：lua_restart 重载脚本函数：luaExi
4、tIfCall 来电暂停函数：checkScriptAuth 脚本授权系统相关函数：dialog 提示框函数：toast 提示函数：dialogRet 带按钮的对话框函数：dialogInput 参数对话框（仅支持 iOS）函数：getNetTime 获取网络时间函数：addContactToAB 添加联系人函数：removeAllContactsFromAB 清空通讯录UTF-8 编码模块说明函数：utf8.char 整数序列转换字符串函数：utf8.codes 获取字符编码函数：utf8.codepoint 获取指定位置字符编码函数：utf8.len 统计字符个数函数：utf8.offse
5、t 获取字符位置文字输入及按键模拟函数：inputText 输入字符串函数：switchTSInputMethod 切换到触动/帮你玩输入法（仅支持 Android）函数：getInPutMethod 获取当前输入法包名（仅支持 Android）函数：pressHomeKey 模拟主屏幕按键函数：doublePressHomeKey 双击 HOME 键（仅支持 iOS）函数：keyDown、keyUp 模拟键盘（仅支持 iOS）命令： 安卓模拟物理按键（仅支持 Android）应用相关函数：runApp、closeApp 运行、关闭应用函数：isFrontApp 判断前台应用函数：frontA
6、ppBid 获取前台应用函数：appBundlePath 获取应用安装路径函数：appDataPath 获取应用数据路径（仅支持 iOS）函数：appIsRunning 检测应用是否运行函数：openURL 打开网络地址函数：ipaInstall、ipaUninstall 安装、卸载应用（仅支持 iOS）函数：install, uninstallApp 安装、卸载应用程序（仅支持 Android）函数：getInstalledApps 获取应用列表函数：isInstalledApk 查询应用程序是否安装（仅支持 Android）函数：changeSpeed 变速器（仅支持 iOS）函数：cle
7、anApp 清理应用数据（仅支持 Android）系统信息类函数：getDeviceType 获取设备类型函数：getDeviceID 获取触动精灵设备号函数：getMemoryInfo 获取设备内存信息函数：getTSVer、getOSVer 获取引擎版本号、获取系统版本号函数：getOSType 获取设备系统函数：batteryStatus 检测电池状态、电量函数：getProcess 获取设备进程列表函数：getDeviceAlias 获取设备别名（仅支持 iOS 企业版）函数：getDeviceName 获取设备名称函数：setDeviceName 设置设备名称（仅支持 iOS）函数：
8、getIMEI 获取设备 IMEI(仅支持 Android)函数：getNetworkIP 获取网络 IP(仅支持 Android)函数：getDeviceBrand 获取设备品牌(仅支持 Android)函数：getDeviceModel 获取设备型号(仅支持 Android)函数：getCPUType 获取 CPU 型号(仅支持 Android)函数：getUUID 获取 UUID(仅支持 Android)函数：getSDCardPath 获取 SD 卡路径(仅支持 Android)函数：getDPI 获取屏幕 DPI 和像素密度(仅支持 Android)系统控制函数：setRotatio
9、nLockEnable 锁定设备方向（仅支持 iOS）函数：setWifiEnable 无线开关函数：setBTEnable 蓝牙开关函数：setAirplaneMode 飞行模式开关函数：getVPNStatus 获取VPN状态函数：setVPNEnable VPN 开关（仅支持 iOS）函数：setCellularDataEnable 蜂窝网络开关（仅支持 iOS）函数：setAssistiveTouchEnable 小圆点开关（仅支持 iOS）函数：setReduceMotionEnable 减弱动效开关（仅支持 iOS）函数：getBacklightLevel 获取屏幕亮度函数：set
10、BacklightLevel 设置屏幕亮度函数：setVolumeLevel 设置设备音量函数：vibrator 手机振动函数：playAudio 播放音频函数：stopAudio 停止播放 （仅Android）函数：lockDevice 锁定设备函数：deviceIsLock 设备锁定状态函数：unlockDevice 解锁设备函数：setAutoLockTime 设置锁屏时间函数：resetIDLETimer 重置锁屏计时（仅支持 iOS）函数：shakeDevice 摇一摇（仅支持 iOS）函数：setScreenResolution 修改分辨率（仅支持 iOS）函数：clearKeyC
11、hain 清除钥匙串（仅支持 iOS）函数：fakeGPS 伪装位置（仅支持 iOS）函数：saveImageToAlbum 图片存入相册函数：saveVideoToAlbum 视频存入相册（仅支持 iOS）函数：writePasteboard、readPasteboard 读写剪贴板回调函数函数：beforeUserExit 终止之前运行文字识别函数：ocrText 本地光学字符识别函数：addTSOcrDict、addTSOcrDictEx、tsOcrText、tsFindText 触动点阵识别函数：addDmOcrDict、dmOcrText、dmFindText 打码点阵识别触动相关函
12、数：deviceIsAuth 获取触动精灵授权状态（仅支持 iOS）函数：getRunningAccess 获取当前脚本运行权限（仅支持 Android）函数：userPath 获取客户端文件路径函数：whoAmI 检测触动产品类型函数：showFloatButton 显示、隐藏悬浮条命令： 强制重启触动服务Thread 协程（仅支持 iOS）函数：thread.create 创建协程函数：thread.createSubThread 创建子协程函数：thread.stop 停止协程队列函数：thread.wait 阻塞等待当前协程完成函数：thread.setTimeout 设置协程超时时间
13、函数：thread.clearTimeout 清除协程超时时间函数：thread.waitAllThreadExit 协程阻塞等待浮动窗口函数：fwShowWnd 显示浮动窗口函数：fwShowTextView 显示文字视图函数：fwShowImageView 显示图形视图函数：fwCloseView 关闭视图函数：fwCloseWnd 关闭窗口函数：fwGetWndPos 获取窗口位置函数：fwShowButton 显示一个按钮函数：fwGetPressedButton 获取按钮点击事件完整实例脚本 UIshowUI什么是 json调用示例用 json 创建界面全局属性控件通用属性界面控件控
14、件： Label 标签控件： RadioGroup 单选框控件： Edit 文本编辑框控件： CheckBoxGroup 多选框控件： ComboBox 下拉框控件： Image 图片默认样式指定控件尺寸与位置返回值自定义样式实例代码webUI（仅支持 iOS）函数： webview.new 创建 webview函数： myweb1.show 显示webview函数： myweb1.set 改变 webview 外观函数： myweb1.close 关闭 webview函数： event.register 发送消息,传递参数完整例子为触动增加无限可能，Lua扩展库触动精灵 TSLib 函数扩展
15、库云打码扩展库触动精灵云打码使用方法函数：ocr.cloudOcrText、ocr.cloudOcrReportError、ocr.version简易 SMTP 邮件发送库函数：mail.send触动精灵中 os.execute 应用respring 注销poweroff 关机reboot 重启clearCache 清空缓存delFile 删除文件unzip 解压movefile 移动文件copyfile 复制文件newfolder 创建文件夹触动精灵中io库应用readFile 将指定文件中的内容按行读取getList 遍历文件findFile 查找文件file_exists 检测指定文件是
16、否存在在触动精灵中使用LuaSocket网络库如何安装httpGet请求httpPost请求挂载代理以 socket 的方式访问smtp方法发送 mail实现获取网络时间统计毫秒精度的时间生成随机数触动精灵ts.so扩展库触动精灵苏泽扩展库JSON 模块FTP 模块设备信息模块字符串处理模块（仅支持 iOS）HTTP 模块PLIST 文件操作（仅支持 iOS）POS 模块附录iOS 设备分辨率一览表Lua math 库已知与触动精灵/帮你玩/小精灵/企业版 iOS 冲突的插件列表约定的按键编码电话功能按键控制类按键基本类按键安卓手机如何开启系统悬浮窗权限设备 SSH 连接工具相关工具运行库OC
17、R（光学字符识别）相关LuaSQLiteiOS 系统设置参数对照表按键码表字母按键码表数字按键码表其他按键码表更多请自行尝试前言触动精灵是一款模拟手机触摸、按键操作的软件,通过制作脚本,可以让触动精灵代替双手,自动执行一系列触摸、按键操作。触动精灵简单、易用，不需要掌握任何编程知识就可以录制出功能强大的脚本;还可以使用编程知识,编写出功能更为复杂，交互更为灵活的脚本;只要能够在手机上完成的人为操作,触动精灵都可以代替完成，不仅省力,而且高效。触动精灵采用 Lua 脚本语言作为底层语言,支持 Lua 5.2.3 版本的所有语法与基本函数，并在其的基础上添加了一些扩展函数,用于取色、找色、找图、发
18、送触摸事件等高级功能的实现。用户在阅读本函数说明前，请参考 Lua 的官方手册以及相关资料，学习以下基本语法：- 注释- 变量与类型- 运算符- 条件、循环控制- 函数定义- 库函数- 本说明仅供初等文化水平以上的、了解计算机编程基本原理的个体学习与参考，并不适用于零基础的编程入门者学习编程基本知识。严禁用于商业以及非法目的，严禁转载、抄袭、未经许可地引用。为了便于解释和描述，本说明中采用了一些非专业的描述与形容方法（如：number），敬请理解。因编写校对仓促，如有错误欢迎及时指正，本文中的示例仅供函数参考，不要直接用于脚本中。重要提示：Lua 官方手册：http:/www.lua.org/
19、manual/5.2/Lua 中文开发手册：http:/ 基础简明教程：https:/ UTF-8 文本编码，如果您出现脚本中文无法正常显示与处理，请在您使用的编辑器或 IDE 中设置文本编码为 UTF-8，谢谢。学习前的准备越狱及 root 常识在学习脚本开发之前，首先要具备一些关于 iOS 越狱和安卓 root 的知识，以及触动精灵的常用信息文档链接：https:/ 不见了或者已安装界面空白该怎么办为什么安装插件总是报错呢Lua 基础简明教程首先你需要了解 Lua 这门语言的一些基础知识，什么是循环，什么是函数，布尔型和数值型分别是什么意思，才有可能看得懂下面的教程和手册。文档地址：htt
20、ps:/ 插件安装方法平刷插件 Cydia EraserSSH 命令工具 putty触动精灵的安装使用及常识抓色器和编辑器的使用及常识同样的脚本为什么有的手机运行异常showUI 返回值的调用showUI 应该怎么写才简洁好用大漠字库工具的用法触动精灵开发者指南由于触动精灵在线文档数量较多，很多人不知道如何查询，现建立此文档做为索引，其中会补充一些软件使用的常用信息。触动精灵旗下目前有四款软件：触动精灵（iOS/Android）、帮你玩商城（iOS/Android）、小精灵（iOS/Android）、企业版（iOS/Android 开发中）。触动精灵适合开发者和有中控开发能力的工作室使用帮你玩
21、脚本商城适合开发玩家脚本的开发者和普通脚本用户使用小精灵适合有图标和包名自定义需求的开发者和工作室使用企业版适合有批量控制设备需求的工作室使用文档地址：https:/ iOS使用教程：https:/ Android使用教程：https:/ Bundle ID 不同，不能跨源覆盖安装或直接升级，请卸载之后再安装另一个源的版本。脚本编辑器：TouchSprite Studio支持函数自动补全、函数提示、关键字高亮、文件传送、远程运行、自动缩进等常用功能，已内置所有至最新 2.3.6 版本触动精灵扩展函数，推荐使用。下载地址：http:/ v2.1.5 以上版本）。下载地址：http:/ 模拟器、雷
22、电模拟器模拟器使用教程：https:/ 触摸点击、滑动函数名称：触摸按下、抬起、移动函数功能：通过按下、抬起、移动动作发送触摸事件。函数方法touchDown(index , x , y);touchMove(index , x, y);touchUp(index , x , y);返回值：无参数类型说明indexnumber手指序号（可省略）xnumber屏幕横坐标ynumber屏幕纵坐标脚本实例：快速划动touchDown(150, 550);-在坐标 (150, 550)按下mSleep(30);touchMove(150, 600);-移动到坐标 (150, 600)，注意一次滑动的坐
23、标间隔不要太大，不宜超过50像素mSleep(30);touchUp(150, 600);-在坐标 (150, 600) 抬起连续划动touchDown(150, 550);-在坐标 (150, 550) 按下for i = 0, 400, 10 do-使用for循环从起始点连续横向移动到终止点touchMove(150 + i, 550);mSleep(10);-延迟endtouchUp(150 + 200, 550);-在坐标 (350, 550) 抬起多点触控touchDown(1, 200, 400);-手指 1 在坐标 (200, 400) 按下touchDown(2, 300, 5
24、00);-手指 2 在坐标 (300, 500) 按下mSleep(50);for i = 1, 100, 1 do-使用 for 循环使两只手指同时分离touchMove(1, 200 - i, 400 - i);touchMove(2, 300 + i, 500 + i);mSleep(10);endtouchUp(1, 200 - 100, 400 - 100);-抬起手指1touchUp(2, 300 + 100, 500 + 100);-抬起手指2封装一个点击函数function click(x, y)touchDown(x, y)mSleep(30)touchUp(x, y)end
25、click(100, 200) -点击坐标 100，200 位置方形渐开线init(1)mSleep(1000)local x = 1010 -起始坐标xlocal y = 698-起始坐标ylocal v = 30-两点间距离touchDown(x, y)mSleep(100)for var = 1,20 doj = 0k = vfor _i = 1,2 dofor i = 1,10 dox = x + jy = y + ktouchMove(x, y)mSleep(20)endj = vk = 0endv = v * (-1.05)endtouchUp(x, y)圆形渐开线init(1)m
26、Sleep(1000)local x0 = 1010 -起始坐标xlocal y0 = 698-起始坐标ylocal rr = 20 -设置递增半径local l = 10 -设置点间距local p = 0 -初始化角度local r = 30 -设置首圈半径local rn = 10 -设置圈数touchDown(x0, y0)mSleep(100)for var = 1,rn dowhile p 应用ID查询 中能查看到应用程序的 Bundle ID；2. iOS 使用 iFile、PP助手等软件可查看应用文件夹下的 Info.plist，其中的 CFBundleIdentifier 即
27、为该应用的 Bundle ID。3. 使用 frontAppBid 函数，前台运行要获取 Bundle ID 的应用，运行此函数并用 diolag、toast、nLog 函数显示返回值。函数：getDeviceOrient 获取手机、应用屏幕方向（仅支持 iOS）函数名称：获取手机、应用屏幕方向函数功能：用于获取当前手机方向和应用方向支持版本：引擎版本 iOS v2.3.9 以上,Android 暂不支持函数方法：orient = getDeviceOrient()返回值：number orient.app,orient.dev返回值类型说明orient.appnumber前台应用方向orie
28、nt.devnumber手机屏幕方向脚本实例：local orient = getDeviceOrient()dialog(屏幕方向： . orient.dev . n应用方向： . orient.app, 0)注意事项：屏幕方向,0-3,和 init 方向一致该函数获取时间长，不建议频繁调用，否则可能会影响脚本效率函数：setDeviceOrient 设置屏幕方向（仅支持 iOS）函数名称：设置屏幕方向函数功能：设置当前脚本运行时的屏幕方向。支持版本：引擎版本 iOS v2.3.4 以上,Android 暂不支持函数方法setDeviceOrient(number rotate);返回值：无参数类型说明rotatenumber0 - 竖屏；1 - Home键在右边；2 - Home键在左边函数：getScreenSize 获取屏幕分辨率函数名称：获取屏幕分辨率，取分辨率函数功能：用于获取设备屏幕的分辨率，用来判断坐标系的使用。函数
