触动精灵脚本开发手册.docx

DecryptGUIminiknife 2017-09-27 18:51 字数 119624 阅读 480798触动精灵脚本开发手册开发手册 触动精灵Windows 平台按 Ctrl + F 打开快捷搜索Mac 平台按 command + F 打开快捷搜索右侧文本列表可以找到全部手册目录触动精灵脚本开发手册目录前言学习前的准备越狱及 root 常识Lua 基础简明教程脚本开发取色技巧小白学触动零基础视频教程触动精灵开发者指南触动产品功能对比如何查看更多文档脚本开发相关工具触动精灵 iOS触动精灵 Android脚本编辑器：TouchSprite Studio抓色器：TSColorPicker已兼容的模拟器点击触摸函数：touchDown、touchUp、touchMove 触摸点击、滑动函数：catchTouchPoint 获取用户点击坐标图色类及屏幕相关函数：init 初始化函数：getDeviceOrient 获取手机、应用屏幕方向（仅支持 iOS）函数：setDeviceOrient 设置屏幕方向（仅支持 iOS）函数：getScreenSize 获取屏幕分辨率函数：setScreenScale 坐标缩放函数：keepScreen 保持屏幕函数：getColor、getColorRGB 获取屏幕某点颜色值函数：findColorInRegionFuzzy 区域模糊找色函数：findImageInRegionFuzzy 区域模糊找图函数：findMultiColorInRegionFuzzy 区域多点找色函数：findMultiColorInRegionFuzzyExt 高级区域多点找色函数：findImage 高级区域找图（仅支持 iOS）函数：snapshot 截图函数：imageOperMerge 图片合并（仅支持 iOS）开发辅助类函数：initLog、wLog、closeLog 日志函数函数：sysLog 系统日志函数：nLog 远程日志脚本控制函数：mSleep 延时函数：lua_exit 退出脚本函数：lua_restart 重载脚本函数：luaExitIfCall 来电暂停函数：checkScriptAuth 脚本授权系统相关函数：dialog 提示框函数：toast 提示函数：dialogRet 带按钮的对话框函数：dialogInput 参数对话框（仅支持 iOS）函数：getNetTime 获取网络时间函数：addContactToAB 添加联系人函数：removeAllContactsFromAB 清空通讯录UTF-8 编码模块说明函数：utf8.char 整数序列转换字符串函数：utf8.codes 获取字符编码函数：utf8.codepoint 获取指定位置字符编码函数：utf8.len 统计字符个数函数：utf8.offset 获取字符位置文字输入及按键模拟函数：inputText 输入字符串函数：switchTSInputMethod 切换到触动/帮你玩输入法（仅支持 Android）函数：getInPutMethod 获取当前输入法包名（仅支持 Android）函数：pressHomeKey 模拟主屏幕按键函数：doublePressHomeKey 双击 HOME 键（仅支持 iOS）函数：keyDown、keyUp 模拟键盘（仅支持 iOS）命令： 安卓模拟物理按键（仅支持 Android）应用相关函数：runApp、closeApp 运行、关闭应用函数：isFrontApp 判断前台应用函数：frontAppBid 获取前台应用函数：appBundlePath 获取应用安装路径函数：appDataPath 获取应用数据路径（仅支持 iOS）函数：appIsRunning 检测应用是否运行函数：openURL 打开网络地址函数：ipaInstall、ipaUninstall 安装、卸载应用（仅支持 iOS）函数：install, uninstallApp 安装、卸载应用程序（仅支持 Android）函数：getInstalledApps 获取应用列表函数：isInstalledApk 查询应用程序是否安装（仅支持 Android）函数：changeSpeed 变速器（仅支持 iOS）函数：cleanApp 清理应用数据（仅支持 Android）系统信息类函数：getDeviceType 获取设备类型函数：getDeviceID 获取触动精灵设备号函数：getMemoryInfo 获取设备内存信息函数：getTSVer、getOSVer 获取引擎版本号、获取系统版本号函数：getOSType 获取设备系统函数：batteryStatus 检测电池状态、电量函数：getProcess 获取设备进程列表函数：getDeviceAlias 获取设备别名（仅支持 iOS 企业版）函数：getDeviceName 获取设备名称函数：setDeviceName 设置设备名称（仅支持 iOS）函数：getIMEI 获取设备 IMEI(仅支持 Android)函数：getNetworkIP 获取网络 IP(仅支持 Android)函数：getDeviceBrand 获取设备品牌(仅支持 Android)函数：getDeviceModel 获取设备型号(仅支持 Android)函数：getCPUType 获取 CPU 型号(仅支持 Android)函数：getUUID 获取 UUID(仅支持 Android)函数：getSDCardPath 获取 SD 卡路径(仅支持 Android)函数：getDPI 获取屏幕 DPI 和像素密度(仅支持 Android)系统控制函数：setRotationLockEnable 锁定设备方向（仅支持 iOS）函数：setWifiEnable 无线开关函数：setBTEnable 蓝牙开关函数：setAirplaneMode 飞行模式开关函数：getVPNStatus 获取VPN状态函数：setVPNEnable VPN 开关（仅支持 iOS）函数：setCellularDataEnable 蜂窝网络开关（仅支持 iOS）函数：setAssistiveTouchEnable 小圆点开关（仅支持 iOS）函数：setReduceMotionEnable 减弱动效开关（仅支持 iOS）函数：getBacklightLevel 获取屏幕亮度函数：setBacklightLevel 设置屏幕亮度函数：setVolumeLevel 设置设备音量函数：vibrator 手机振动函数：playAudio 播放音频函数：stopAudio 停止播放 （仅Android）函数：lockDevice 锁定设备函数：deviceIsLock 设备锁定状态函数：unlockDevice 解锁设备函数：setAutoLockTime 设置锁屏时间函数：resetIDLETimer 重置锁屏计时（仅支持 iOS）函数：shakeDevice 摇一摇（仅支持 iOS）函数：setScreenResolution 修改分辨率（仅支持 iOS）函数：clearKeyChain 清除钥匙串（仅支持 iOS）函数：fakeGPS 伪装位置（仅支持 iOS）函数：saveImageToAlbum 图片存入相册函数：saveVideoToAlbum 视频存入相册（仅支持 iOS）函数：writePasteboard、readPasteboard 读写剪贴板回调函数函数：beforeUserExit 终止之前运行文字识别函数：ocrText 本地光学字符识别函数：addTSOcrDict、addTSOcrDictEx、tsOcrText、tsFindText 触动点阵识别函数：addDmOcrDict、dmOcrText、dmFindText 打码点阵识别触动相关函数：deviceIsAuth 获取触动精灵授权状态（仅支持 iOS）函数：getRunningAccess 获取当前脚本运行权限（仅支持 Android）函数：userPath 获取客户端文件路径函数：whoAmI 检测触动产品类型函数：showFloatButton 显示、隐藏悬浮条命令： 强制重启触动服务Thread 协程（仅支持 iOS）函数：thread.create 创建协程函数：thread.createSubThread 创建子协程函数：thread.stop 停止协程队列函数：thread.wait 阻塞等待当前协程完成函数：thread.setTimeout 设置协程超时时间函数：thread.clearTimeout 清除协程超时时间函数：thread.waitAllThreadExit 协程阻塞等待浮动窗口函数：fwShowWnd 显示浮动窗口函数：fwShowTextView 显示文字视图函数：fwShowImageView 显示图形视图函数：fwCloseView 关闭视图函数：fwCloseWnd 关闭窗口函数：fwGetWndPos 获取窗口位置函数：fwShowButton 显示一个按钮函数：fwGetPressedButton 获取按钮点击事件完整实例脚本 UIshowUI什么是 json调用示例用 json 创建界面全局属性控件通用属性界面控件控件： Label 标签控件： RadioGroup 单选框控件： Edit 文本编辑框控件： CheckBoxGroup 多选框控件： ComboBox 下拉框控件： Image 图片默认样式指定控件尺寸与位置返回值自定义样式实例代码webUI（仅支持 iOS）函数： webview.new 创建 webview函数： myweb1.show 显示webview函数： myweb1.set 改变 webview 外观函数： myweb1.close 关闭 webview函数： event.register 发送消息,传递参数完整例子为触动增加无限可能，Lua扩展库触动精灵 TSLib 函数扩展库云打码扩展库触动精灵云打码使用方法函数：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 检测指定文件是否存在在触动精灵中使用LuaSocket网络库如何安装httpGet请求httpPost请求挂载代理以 socket 的方式访问smtp方法发送 mail实现获取网络时间统计毫秒精度的时间生成随机数触动精灵ts.so扩展库触动精灵苏泽扩展库JSON 模块FTP 模块设备信息模块字符串处理模块（仅支持 iOS）HTTP 模块PLIST 文件操作（仅支持 iOS）POS 模块附录iOS 设备分辨率一览表Lua math 库已知与触动精灵/帮你玩/小精灵/企业版 iOS 冲突的插件列表约定的按键编码电话功能按键控制类按键基本类按键安卓手机如何开启系统悬浮窗权限设备 SSH 连接工具相关工具运行库OCR（光学字符识别）相关LuaSQLiteiOS 系统设置参数对照表按键码表字母按键码表数字按键码表其他按键码表更多请自行尝试前言触动精灵是一款模拟手机触摸、按键操作的软件,通过制作脚本,可以让触动精灵代替双手,自动执行一系列触摸、按键操作。触动精灵简单、易用，不需要掌握任何编程知识就可以录制出功能强大的脚本;还可以使用编程知识,编写出功能更为复杂，交互更为灵活的脚本;只要能够在手机上完成的人为操作,触动精灵都可以代替完成，不仅省力,而且高效。触动精灵采用 Lua 脚本语言作为底层语言,支持 Lua 5.2.3 版本的所有语法与基本函数，并在其的基础上添加了一些扩展函数,用于取色、找色、找图、发送触摸事件等高级功能的实现。用户在阅读本函数说明前，请参考 Lua 的官方手册以及相关资料，学习以下基本语法：- 注释- 变量与类型- 运算符- 条件、循环控制- 函数定义- 库函数- 本说明仅供初等文化水平以上的、了解计算机编程基本原理的个体学习与参考，并不适用于零基础的编程入门者学习编程基本知识。严禁用于商业以及非法目的，严禁转载、抄袭、未经许可地引用。为了便于解释和描述，本说明中采用了一些非专业的描述与形容方法（如：number），敬请理解。因编写校对仓促，如有错误欢迎及时指正，本文中的示例仅供函数参考，不要直接用于脚本中。重要提示：Lua 官方手册：/manual/5.2/Lua 中文开发手册：/Lua 基础简明教程：/lisaisacat/note/636399触动精灵的脚本开发、存储过程必须使用 UTF-8 文本编码，如果您出现脚本中文无法正常显示与处理，请在您使用的编辑器或 IDE 中设置文本编码为 UTF-8，谢谢。学习前的准备越狱及 root 常识在学习脚本开发之前，首先要具备一些关于 iOS 越狱和安卓 root 的知识，以及触动精灵的常用信息文档链接：/lisaisacat/note/324664看了上面的文档，你可以具备以下知识：什么样的手机适合用来做脚本开发拿到一台越狱手机之后应该做什么才能避免白苹果和报错Cydia 不见了或者已安装界面空白该怎么办为什么安装插件总是报错呢Lua 基础简明教程首先你需要了解 Lua 这门语言的一些基础知识，什么是循环，什么是函数，布尔型和数值型分别是什么意思，才有可能看得懂下面的教程和手册。文档地址：/lisaisacat/note/636399脚本开发取色技巧新手在学习使用触动精灵开发脚本的时候，总会进入一些误区，或者会有一些迷惑的点，觉得无从下手，本文总结了一些自己在学习过程中遇到的问题和经验技巧，欢迎大家一起交流分享。文档链接：/lisaisacat/note/508345看了上面的文档，你可以具备以下知识：透明背景图、动图、带动画的界面应该怎么取色找色和找图哪个更好用函数封装是什么脚本报错了怎么办小白学触动零基础视频教程如果你没有任何编程基础，可以先看一下零基础教学视频：/lisaisacat/note/585252看了上面的文档，你可以具备以下知识：deb 插件安装方法平刷插件 Cydia EraserSSH 命令工具 putty触动精灵的安装使用及常识抓色器和编辑器的使用及常识同样的脚本为什么有的手机运行异常showUI 返回值的调用showUI 应该怎么写才简洁好用大漠字库工具的用法触动精灵开发者指南由于触动精灵在线文档数量较多，很多人不知道如何查询，现建立此文档做为索引，其中会补充一些软件使用的常用信息。触动精灵旗下目前有四款软件：触动精灵（iOS/Android）、帮你玩商城（iOS/Android）、小精灵（iOS/Android）、企业版（iOS/Android 开发中）。触动精灵适合开发者和有中控开发能力的工作室使用帮你玩脚本商城适合开发玩家脚本的开发者和普通脚本用户使用小精灵适合有图标和包名自定义需求的开发者和工作室使用企业版适合有批量控制设备需求的工作室使用文档地址：/miniknife/note/509515触动产品功能对比产品名称自定义图标录制调试运行源码授权批量控制支持平台开发者平台触动精灵iOS30元/台/年购买API自行开发iOS/Android/site/index触动精灵安卓免费购买API自行开发iOS/Android/site/index触动小精灵11元/台/月购买API自行开发iOS/Android/帮你玩商城免费iOS/Android/p4u/site/index触动企业版38元/台/年免费iOS/Android/如何查看更多文档在文档右侧栏顶部点击文档分类菜单栏按钮，即可查看触动精灵所有在线文档。此处输入图片的描述脚本开发相关工具工欲善其事，必先利其器，在学习触动精灵脚本编写前我们需要下载安装一些辅助工具来完成脚本编写，包含但不限于以下工具：触动精灵 iOS使用教程：/miniknife/note/307627官方源地址：测试源地址：脚本存放路径：/var/mobile/Media/TouchSprite/lua默认资源路径：/var/mobile/Media/TouchSprite/res脚本日志路径：/var/mobile/Media/TouchSprite/log配置文件路径：/var/mobile/Media/TouchSprite/config触动精灵 Android使用教程：/miniknife/note/443534下载地址：/touchsprite脚本存放路径：/sdcard/TouchSprite/res/lua默认资源路径：/sdcard/TouchSprite/res/res脚本日志路径：/sdcard/TouchSprite/res/log配置文件路径：/sdcard/TouchSprite/res/config安卓不同机型路径有差别，请用userPath函数获取路径注意事项有些函数不支持低版本触动精灵，请仔细阅读函数说明并尽量保持触动精灵客户端为最新版。测试版为不稳定版本，为避免不必要的麻烦，请勿大规模安装。测试版和正式版的 Bundle ID 不同，不能跨源覆盖安装或直接升级，请卸载之后再安装另一个源的版本。脚本编辑器：TouchSprite Studio支持函数自动补全、函数提示、关键字高亮、文件传送、远程运行、自动缩进等常用功能，已内置所有至最新 2.3.6 版本触动精灵扩展函数，推荐使用。下载地址：/tools使用手册：/miniknife/note/123055视频教程：/lisaisacat/note/324664#编辑器与抓色器的使用抓色器：TSColorPicker一个趁手的抓色器可以让你的脚本开发过程变的轻松愉快，在此强烈推荐触动抓色器，快捷抓点、一键生成代码、远程抓屏，让你如虎添翼。具体使用方法请阅读压缩包内附带的说明（远程抓屏功能需使用触动精灵iOS v2.1.5 以上版本）。下载地址：/tools使用手册：/havonz/note/94681视频教程：/lisaisacat/note/324664#编辑器与抓色器的使用已兼容的模拟器猩猩模拟器、夜神模拟器、海马玩模拟器、逍遥模拟器、51 模拟器、雷电模拟器模拟器使用教程：/miniknife/note/443336从系统兼容和资源占用角度考虑，推荐使用雷电模拟器、夜神模拟器。点击触摸函数：touchDown、touchUp、touchMove 触摸点击、滑动函数名称：触摸按下、抬起、移动函数功能：通过按下、抬起、移动动作发送触摸事件。函数方法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)，注意一次滑动的坐标间隔不要太大，不宜超过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, 500);-手指 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)endclick(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)mSleep(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 即为该应用的 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前台应用方向orient.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 获取屏幕分辨率函数名称：获取屏幕分辨率，取分辨率函数功能：用于获取设备屏幕的分辨率，用来判断坐标系的使用。函数方法width,height = getScreenSize();返回值：number width,height返回值类型说明widthnumber获取到的屏幕宽度heightnumber获取到的屏幕高度脚本实例：根据分辨率判断脚本是否适配width, height = getScreenSize();if width = 640 and height = 1136 then-iPhone SE, 5, 5S, iPod touch 5dialog(iPhone SE, 5, 5S, iPod touch 5)elseif width = 640 and height = 960 then-iPhone 4,4S, iPod touch 4dialog(iPhone 4,4S, iPod touch 4)elseif width = 320 and height = 480 then-iPhone 非高分屏dialog(iPhone 非高分屏)elseif width = 768 and height = 1024 then-iPad 1,2, mini 1dialog(iPad 1,2, mini 1)elseif width = 1536 and height = 2048 then-iPad 3,4,5, mini 2dialog(iPad 3,4,5, mini 2)elseif width = 1080 and height = 1920 thendialog(小米 4,华为荣耀 6p 等)elseif width = 720 and height = 1280 thendialog(红米 note2 等)elseif width = 768 and height = 1280 thendialog(魅蓝等)elseif width = 800 and height = 1280 thendialog(三星 N5100 等)elseif width = 480 and height = 800 thendialog(酷派 8017-T00 等)end注意事项：统一为 iOS 竖屏（Home 键在下方时）、安卓初始方向屏幕的宽度和高度。部分安卓设备存在无法获取到屏幕分辨率的问题，需要在脚本中判断如果返回值小于0则指定一个固定的宽高。函数：setScreenScale 坐标缩放函数名称：坐标缩放函数功能：用于对屏幕坐标进行缩放，可直接影响点击、取色、找色函数中的坐标参数。支持版本：引擎版本 iOS v2.2.7,Android v1.2.8 以上函数方法setScreenScale(flag, width, height);返回值：无参数类型说明flagbooleantrue - 打开，false - 关闭widthnumber基准屏幕的宽度heightnumber基准屏幕的高度脚本实例：setScreenScale(true, 750, 1334)-以750,1334分辨率为基准坐标进行缩放-当此函数打开时，将影响点击、取色、单点模糊找色函数setScreenScale(false) -关闭缩放注意事项：当此函数打开时，受影响的函数为点击和单点找色函数：touchDown touchUp touchMove getColor getColorRGB findColorInRegionFuzzy snapshot多点找色函数不受此函数影响当两个设备宽高比相差较大时，此函数转换后的效果较差函数：keepScreen 保持屏幕函数名称：保持屏幕，保持图像函数功能：在脚本中保持当前屏幕内容不变，多次调用取色、找色、截图、找图等函数时，直接调用保持的内容。该函数为优化类函数，能够为大量的静态图像处理函数提供性能优化。函数方法keepScreen(flag);返回值：无参数类型说明flagboolean保持开关脚本实例：遍历屏幕区块keepScreen(true);-打开保持屏幕,当参数为 true 时启用屏幕保持，运行到该函数时内存中的屏幕图像保持在这一时刻for k = 1, 640, 10 dofor j = 1, 960, 10 do-格式化为十六进制文本color = string.format(%X, getColor(k, j);-输出到本地日志nLog(.k., .j.) Color: .color.);endendkeepScreen(false);-关闭保持屏幕，当参数为 false 时关闭屏幕保持，释放内存中的屏幕图像，以备下一次继续保持。注意事项：据不完全统计，与不使用该函数相比，使用此函数会使普通屏上脚本取色速率提升 100 倍，高分屏上脚本取色速率提升 50 倍。在执行大量静态图像操作时，请务必使用该函数优化脚本性能。该函数一般用于画面变动节奏较慢，但需要根据大量取色、找色来完成计算和操作的脚本中，例如天天爱消除、天天星连萌这样的游戏。名词解析：静态图像处理，指可在某一状态下屏幕内容保持到内存（不影响显示），对其进行进一步的 多次分析。否则，每次使用图像类函