触摸精灵帮助手册

1 基本使用

1.1 如何录制

  1. 点击底部导航栏切换到“制作”界面。
  2. 点击顶部标签栏切换到“录制脚本”标签页。
  3. 在名称框输入想要录制的脚本的名称。
  4. 在描述框输入想要录制的脚本的描述。
  5. 点击“录制”按钮。
  6. 阅读弹出的提示对话框中的内容,然后点击“确定”按钮。
  7. 切换到手机的任意界面,按下热键开始录制(在使用控制条时按下控制条“录制”按钮开始录制)。
  8. 再次按下热键停止录制(在使用控制条时按下控制条“停止”按钮停止录制)。

1.2 如何播放

  1. 点击底部导航栏切换到“列表”界面。
  2. 单击想要播放的脚本,或者长按想要播放的脚本,在弹出的菜单中选择“播放”。
  3. 阅读弹出的提示对话框中的内容,然后点击“确定”按钮。
  4. 切换到手机的任意界面,按下热键开始播放(在使用控制条时按下控制条“播放”按钮开始播放)。
  5. 脚本在播放完毕后会自动停止,或在播放过程中再次按下热键停止播放(在使用控制条时按下控制条“停止”按钮停止播放,按下“暂停”按钮暂停播放,按下“退出”按钮退出此次播放)。

1.3 如何编辑

  1. 点击底部导航栏切换到“列表”界面。
  2. 单击想要播放的脚本,或者长按想要播放的脚本,在弹出的菜单中选择“编辑”。
  3. 在弹出的界面中直接编辑脚本文件,或点击“插入”按钮选择支持的函数。
  4. 点击“保存”按钮保存脚本文件,点击“退出”按钮退出编辑界面。

1.4 如何导出

  1. 点击底部导航栏切换到“播放”界面。
  2. 长按想要播放的脚本,在弹出的菜单中选择“导出”。
  3. 在弹出的文件浏览器中切换到想要导出的目录, 然后点击“确定”按钮。

1.5 如何导入

  1. 点击底部导航栏切换到“录制”界面。
  2. 点击顶部标签栏切换到“导入”标签页。
  3. 在文件浏览器中选中要导入的脚本, 然后点击“导入”按钮。

1.6 如何注册

  1. 点击底部导航栏切换到“设置”界面。
  2. 点击“注册状态”,获取您的设备的唯一序列号(三选一:IMEI码用于绑定手机,IMSI码用于绑定SIM卡,WMAC码用于绑定平板电脑)。
  3. 登录http://aisence.taobao.com,购买前请仔细阅读购买说明。
  4. 购买注册码,在附加信息中留下您的IMEI码或IMSI码或WMAC码、邮箱。
  5. 我们会尽快将注册文件发送到您的邮箱中。
  6. 将注册文件放入手机的SD卡中。
  7. 点击底部导航栏切换到“设置”界面。
  8. 点击“导入注册文件”,在弹出的文件浏览器中选中注册文件,然后点击确定。
  9. 看到“导入成功”的提示后完成注册。再次点击“注册状态”时显示“已注册”以及该注册文件的到期时间。

2 脚本语言

触摸精灵使用Lua语言作为底层脚本语言,支持Lua 5.2版本的所有语法与基本库函数,并在Lua语言的基础上添加了一些扩展函数,用于发送触摸事件、找图、找色等高级功能的实现。


2.1 基本语法

用户可参考Lua的官方手册或者其他资料来学习以下基本语法:


2.2 扩展函数

2.2.1 logDebug()

输出调试信息到系统日志


2.2.2 mSleep()

进行毫秒级别延迟


2.2.3 notifyMessage()

以文字提示框的方式通知用户


2.2.4 notifyVibrate()

以震动方式通知用户


2.2.5 notifyVoice()

以播放音频的方式通知用户


2.2.6 touchDown()

发送手指按下事件


2.2.7 touchMove()

发送手指移动事件


2.2.8 touchUp()

发送手指抬起事件


2.2.9 getScreenResolution()

获取当前屏幕分辨率


2.2.10 getScreenColorBits()

获取当前屏幕色彩位数


2.2.11 getColor()

获取指定像素的颜色


2.2.11 getColorRGB()

获取指定像素颜色的R、G、B三个值


2.2.12 findColor()

全屏找色


2.2.13 findColorFuzzy()

全屏模糊找色


2.2.14 findColorInRegion()

区域找色


2.2.15 findColorInRegionFuzzy()

区域模糊找色


2.2.16 findImage()

全屏找图


2.2.17 findImageFuzzy()

全屏模糊找图


2.2.18 findImageInRegion()

区域找图


2.2.19 findImageInRegionFuzzy()

区域模糊找图


2.2.20 snapshotScreen()

全屏截图


2.2.20 snapshotRegion()

区域截图