AutoTouch帮助文档

适用v3.5.4-1以上

AutoTouch是用来“录制”和“回放”您在移动设备上的“触摸”和“点击”操作的一款“宏”工具,简言之就是移动设备上的“按键精灵”。它通过运行Lua脚本来模拟人的操作,脚本可以录制生成或手工编写来产生。它同时提供一系列扩展函数,来辅助实现复杂的自动化操作,比如自动玩游戏打怪赚取金币、批量编辑操作、进行程序自动化测试等。

AutoTouch运行在已越狱的苹果设备上,请通过Cydia安装。AutoTouch支持录制触摸、按实体键等操作,并提供触摸、截屏、颜色查找、图片匹配、启动关闭应用等扩展函数。同时提供一个脚本商城,您可以下载和购买脚本,也可以将自己的脚本在商城出售。


用法


怎样安装?


怎样录制?

Created with Raphaël 2.1.2平常状态平常状态弹出控制面板弹出控制面板录制中录制中长按“音量减键”点击“录制”再次长按“音量减键”

怎样播放?

Created with Raphaël 2.1.2平常状态平常状态弹出控制面板弹出控制面板弹出运行设置弹出运行设置运行中运行中长按“音量减键”点选脚本点击“立即运行”再次长按“音量减键”
Created with Raphaël 2.1.2平常状态平常状态弹出控制面板弹出控制面板弹出运行设置弹出运行设置预备运行状态预备运行状态运行中运行中长按“音量减键”点选脚本点击“稍后运行”点击“音量减键”再次点击“音量减键”点击“音量减键”再次点击“音量减键”再次长按“音量减键”

怎样预设播放设置?


怎样截屏?


怎样编写脚本?


怎样在编写脚本时使用“函数助手”?


怎样在电脑上编写和管理脚本?


怎样加密脚本?


怎样发布脚本到商城?


怎样从商城下载和购买脚本?


怎样购买授权?


脚本


基础

您可以从这里学习Lua语言的使用:《Lua Official Reference Manual》《Lua 5.3 参考手册


坐标和尺寸体系

在AutoTouch v3.5.2以前的版本中,坐标和尺寸体系使用“iOS点阵体系”,从该版本始,全部修改为“像素点体系”,即根据实际像素点衡量尺寸和坐标。

比如在旧的“iOS点阵体系”中,iPhone 6 Plus的屏幕尺寸是414x736,因为在该体系中,尺寸是“像素尺寸除去视网膜屏缩放值”的结果,即iPhone 6 Plus实际像素分辨率是1242x2208,缩放因素是3,那么在“iOS点阵体系”中,屏幕尺寸就是(1242÷3)x(2208÷3)。而在v3.5.2之后采用的“像素点体系”中,则简单直观地根据像素点尺寸来衡量坐标。如论是设置触摸坐标、查找颜色、匹配图片,都直接使用像素尺寸来衡量,不用再考虑视网膜屏缩放因素。

旧有脚本如果头部有旧SCREEN_RESOLUTION的声明,会自动被识别适应。比如如果有以前录制的iPhone 6 Plus的脚本,声明有SCREEN_RESOLUTION=414x736,则会被自动识别并处理,以适应尺寸体系的变更。


扩展函数

扩展函数用于扩展Lua语言,使具备模拟人类操作手机的一些能力。还提供截屏、颜色查找、颜色匹配、图片匹配等功能。


touchDown(id, x, y)触摸按下

在屏幕的(x, y)坐标按下。

参数

参数 类型 说明
id 整型 手指编号,用来在单点、多点触摸标识一个手指
x 浮点 屏幕x坐标
y 浮点 屏幕x坐标

返回值

示例

  1. -- 在坐标(100, 200)处单指按下。
  2. touchDown(0, 100, 200);
  3. -- 三指在屏幕三处同时按下
  4. touchDown(0, 100, 200);
  5. touchDown(1, 200, 300);
  6. touchDown(2, 300, 400);
  7. --实现一个点击屏幕的函数
  8. function tap(x, y)
  9. touchDown(0, x, y);
  10. usleep(16000);
  11. touchUp(0, x, y);
  12. end
  13. -- 在(100, 200)处点击
  14. tap(100, 200);

touchMove(id, x, y)触摸移动

移动手指到(x, y)坐标。

参数

参数 类型 说明
id 整型 手指编号,用来在单点、多点触摸标识一个手指
x 浮点 屏幕x坐标
y 浮点 屏幕x坐标

返回值

示例

  1. -- 在坐标(100, 200)处单指按下, 然后移动手指到坐标(200, 200)处。
  2. touchDown(0, 100, 200);
  3. usleep(16000);
  4. touchMove(0, 200, 200);
  5. -- 三指在屏幕三处同时按下,然后移动到新的位置。
  6. touchDown(0, 100, 200);
  7. touchDown(1, 200, 300);
  8. touchDown(2, 300, 400);
  9. usleep(16000);
  10. touchMove(0, 150, 250);
  11. touchMove(1, 250, 350);
  12. touchMove(2, 350, 450);

touchUp(id, x, y)触摸抬起

从(x, y)坐标抬起手指。

参数

参数 类型 说明
id 整型 手指编号,用来在单点、多点触摸标识一个手指
x 浮点 屏幕x坐标
y 浮点 屏幕x坐标

返回值

示例

  1. -- 在坐标(100, 200)处单指点击屏幕一次。
  2. touchDown(0, 100, 200);
  3. usleep(16000);
  4. touchUp(0, 100, 200);
  5. -- 三指在屏幕三处同时按下,然后移动到新的位置,然后抬起。
  6. touchDown(0, 100, 200);
  7. touchDown(1, 200, 300);
  8. touchDown(2, 300, 400);
  9. usleep(16000);
  10. touchMove(0, 150, 250);
  11. touchMove(1, 250, 350);
  12. touchMove(2, 350, 450);
  13. usleep(16000);
  14. touchUp(0, 150, 250);
  15. touchUp(1, 250, 350);
  16. touchUp(2, 350, 450);

keyDown(keyType)按下实体键

模拟实体键按下动作。

参数

参数 类型 说明
keyType 整型 实体键标识,现在可使用这些实体键

返回值

示例

  1. -- 模拟Home键按下的动作
  2. keyDown(KEY_TYPE.HOME_BUTTON);
  3. -- 怎样模拟一次按键动作
  4. function keyPress(keyType)
  5. keyDown(keyType);
  6. usleep(10000);
  7. keyDown(keyUp);
  8. end
  9. keyPress(KEY_TYPE.HOME_BUTTON);
  10. -- 怎样实现锁屏?
  11. function lockScreen()
  12. keyDown(KEY_TYPE.POWER_BUTTON);
  13. keyUp(KEY_TYPE.POWER_BUTTON);
  14. end
  15. -- 怎样实现解锁屏幕?
  16. function unlockScreen()
  17. keyDown(KEY_TYPE.POWER_BUTTON);
  18. keyUp(KEY_TYPE.POWER_BUTTON);
  19. usleep(1000000);
  20. local w, h = getScreenResolution();
  21. local x = 10;
  22. local gap = 120;
  23. touchDown(0, x, 200);
  24. while x < w do
  25. x = x + gap;
  26. usleep(16000);
  27. touchMove(0, x, 200);
  28. end
  29. touchUp(0, x, 200);
  30. end

keyUp(keyType)抬起实体键

模拟实体键抬起动作。

参数

参数 类型 说明
keyType 整型 实体键标识,现在可使用这些实体键

返回值

示例

  1. -- 模拟Home键按下抬起的动作
  2. keyDown(KEY_TYPE.HOME_BUTTON);
  3. usleep(10000);
  4. keyUp(KEY_TYPE.HOME_BUTTON);

getColor(x, y)获取屏幕颜色值

在当前屏幕获取指定坐标位置像素点的颜色值。

参数

参数 类型 说明
x 浮点 屏幕x坐标
y 浮点 屏幕x坐标

返回值

返回值 类型 说明
color 整型 像素点的整数类型颜色值

示例

  1. local color = getColor(100, 200);
  2. alert(string.format("Pixel color is :%d", color));
  3. -- 弹出提示color:16777215

getColors(locations)批量获取屏幕颜色值

批量获取屏幕颜色值。

参数

参数 类型 说明
locations table 一批坐标列表,如 {{x1,y1},{x2,y2},{x3,y4}}

返回值

返回值 类型 说明
colors table 返回与传入坐标对应的色值列表

示例

  1. local result = getColors({{100, 200}, {200, 300}, {300, 400}});
  2. for i, v in pairs(result) do
  3. log(string.format("Gotten color:%d", v));
  4. end

findColor(color, count, region)单点颜色查找

在当前屏幕查找所有匹配指定颜色的像素点坐标。

参数

参数 类型 说明
color 整型 匹配的颜色值
count 整型 最多查找多少个匹配的像素点,默认是0,表示查找所有匹配点。如果是1,表示查出第一个即可,若是2表示查出前两个即可。查找的个数越少速度越快。
region table 限定在指定区域进行查找。该参数是包含{x, y, width, height}四个值的一个table类型,四个值分别是矩形区域的左上x,y坐标,和矩形区域的宽和高,比如{100, 100, 200, 200}。如果不想限定区域,传入nil即可。

返回值

返回值 类型 说明
locations table 匹配的像素点的坐标。比如:{{x1, y1}, {x2, y2}, ...}

示例

  1. -- 示例 1:
  2. local result = findColor(0x0000ff, 2, nil);
  3. for i, v in pairs(result) do
  4. log(string.format("Found pixel: x:%f, y:%f", v[1], v[2]));
  5. end
  6. -- 示例 2:
  7. local result = findColor(0x00ddff, 0, {100, 50, 200, 200});
  8. for i, v in pairs(result) do
  9. log(string.format("Found pixel: x:%f, y:%f", v[1], v[2]));
  10. end
  11. -- 示例 3:
  12. local region = {100, 50, 200, 200};
  13. local result = findColor(0x00ddff, 0, region);
  14. for i, v in pairs(result) do
  15. log(string.format("Found pixel: x:%f, y:%f", v[1], v[2]));
  16. end

内部实现

  1. function findColor(color, count, region)
  2. return findColors({{color,0,0}}, count, region);
  3. end

findColors(colors, count, region)多点颜色查找

查找所有匹配“指定颜色及它们的相对位置”的矩形区域,返回找到的矩形区域中匹配第一个颜色的像素的坐标。该函数具有比findImage高得多的查找效率和可用度,比如查找一个按钮,不用像findImage一样去匹配整个按钮图片,只用匹配按钮中的几个锚点的颜色和它们的相对位置即可。可以使用count参数限定希望查找结果的个数,0表示查找所有,1标识查找第1个,2表示查找前两个。region参数可以用来限定查找的区域,为{x, y, width, height}的table类型,不限定时传入nil即可。

这个函数可以使用脚本编辑界面“扩展函数”中的“辅助”工具,快速地从屏幕截图中选择几个锚点颜色,并自动获取它们的相对位置来插入到函数参数位置。
下图箭头所指像素点的坐标为返回值的坐标。

IMG_0329.PNG-116kB

参数

参数 类型 说明
colors table 包含一些颜色以及它们的相对位置,比如{{0x00ddff,0,0}, {0x00eeff,10,10}, {0x0000ff,0,20}},大table中的小table包含三个值,第一个是颜色值,第二个和第三个值是该颜色相对于第一个颜色的相对位置,其中第一个颜色的table的相对位置总是(0,0),比如{0x00ddff,0,0}这个颜色,而后续的几个颜色的位置值,是它们相对于第一个颜色的位置。用这些颜色和相对位置关系,可以从屏幕中匹配到符合的矩形区域。
count 整型 最多查找多少个匹配的像素点,默认是0,表示查找所有匹配点。如果是1,表示查出第一个即可,若是2表示查出前两个即可。查找的个数越少速度越快。
region table 限定在指定区域进行查找。该参数是包含{x, y, width, height}四个值的一个table类型,四个值分别是矩形区域的左上x,y坐标,和矩形区域的宽和高,比如{100, 100, 200, 200}。如果不想限定区域,传入nil即可。

返回值

返回值 类型 说明
locations table 查找到的矩形区域中匹配第一个颜色的像素点的坐标。比如:{{x1, y1}, {x2, y2}, ...}

示例

  1. -- 示例 1:
  2. local result = findColors({{0x00ddff,0,0}, {0x00eeff,10,10}, {0x0000ff,0,20}}, 2, nil);
  3. for i, v in pairs(result) do
  4. log(string.format("Found rect at: x:%f, y:%f", v[1], v[2]));
  5. end
  6. -- 示例 2:
  7. local colors = {{0x00ddff,0,0}, {0x00eeff,10,10}, {0x0000ff,0,20}};
  8. local result = findColors(colors, 0, nil);
  9. for i, v in pairs(result) do
  10. log(string.format("Found rect at: x:%f, y:%f", v[1], v[2]));
  11. end
  12. -- 示例 3:
  13. local colors = {{0x00ddff,0,0}, {0x00eeff,10,10}, {0x0000ff,0,20}};
  14. local region = {100, 50, 200, 200};
  15. local result = findColors(colors, 0, region);
  16. for i, v in pairs(result) do
  17. log(string.format("Found rect at: x:%f, y:%f", v[1], v[2]));
  18. end

findImage(imagePath, count, fuzzy, ignoreColors, region)图片查找

在当前屏幕查找匹配指定图片的区域,以table形式返回找到的所有区域的左上角坐标。

参数

参数 类型 说明
imagePath 字符串 需要查找的图片的路径。从AutoTouch v3.1.1版本开始,此处不需要传入完整路径,只需传入在AutoTouch文档目录下的位置,即“本地脚本”位置下的路径(rootDir函数可获得文档目录的路径)。如“images/spirit.bmp”表示“/var/mobile/Library/AutoTouch/Scripts/images/spirit.bmp”,不要传入完整路径。
count 整型 最多查找多少个匹配的像素点,默认是0,表示查找所有匹配点。如果是1,表示查出第一个即可,若是2表示查出前两个即可。查找的个数越少速度越快。
fuzzy 浮点 查找的模糊度,默认是1,表示完全匹配,0.5表示匹配50%的像素点即可。
ignoreColors table 在查找中需要无视的颜色值,以数组形式提供,如{0xffffff, 0x2b2b2b},无则传入nil。
region table 限定在指定区域进行查找。该参数是包含{x, y, width, height}四个值的一个table类型,四个值分别是矩形区域的左上x,y坐标,和矩形区域的宽和高,比如{100, 100, 200, 200}。如果不想限定区域,传入nil即可。

返回值

返回值 类型 说明
locations table 匹配区域左上角坐标的数组. 比如: {{x1, y1}, {x2, y2}, ...}

示例

  1. -- 示例 1:
  2. local result = findImage("images/spirit.bmp", 5, 1, nil, nil);
  3. for i, v in pairs(result) do
  4. log(string.format("Found rect at: x:%f, y:%f", v[1], v[2]));
  5. end
  6. -- 示例 2:
  7. local result = findImage("images/spirit.bmp", 0, 0.6, nil, nil};
  8. for i, v in pairs(result) do
  9. log(string.format("Found rect at: x:%f, y:%f", v[1], v[2]));
  10. end
  11. -- 示例 3:
  12. local result = findImage("images/spirit.bmp", 0, {0xffffff, 0x2b2b2b}, nil};
  13. for i, v in pairs(result) do
  14. log(string.format("Found rect at: x:%f, y:%f", v[1], v[2]));
  15. end
  16. -- 示例 4:
  17. local imagePath = "images/spirit.bmp";
  18. local region = {100, 50, 200, 200};
  19. local ignoreColors = {0xffffff, 0x2b2b2b};
  20. local result = findImage(imagePath, 1, 0.9, ignoreColors, region};
  21. for i, v in pairs(result) do
  22. local x = v[1], y = v[2];
  23. log(string.format("Found rect at: x:%f, y:%f", x, y));
  24. -- 点击找到的位置一次
  25. tap(x, y);
  26. usleep(16000);
  27. end

screenshot(filePath, region)屏幕截图

对全屏,或指定区域进行屏幕截图,并以BMP格式保存在指定地址。

参数

参数 类型 说明
filePath 字符串 截屏要存放的地址。从AutoTouch v3.1.1版本开始,此参数为AutoTouch文档目录(本地脚本目录)下的相对位置(rootDir函数可获得文档目录的路径)。如“images/spirit.bmp”表示“/var/mobile/Library/AutoTouch/Scripts/images/spirit.bmp”,请不要再传入完整路径。
region table 对屏幕指定区域进行截图。该参数是包含{x, y, width, height}四个值的一个table类型,四个值分别是矩形区域的左上x,y坐标,和矩形区域的宽和高,比如{100, 100, 200, 200}。如果不想限定区域,传入nil即可。

返回值

示例

  1. -- 全屏截图并保存在指定位置。
  2. screenshot ("images/screenshot1.bmp", nil);
  3. -- 对指定区域截图并保存。
  4. screenshot ("images/screenshot2.bmp", {100, 100, 200, 200});

appRun(appIdentifier)启动应用

启动指定的应用。

参数

参数 类型 说明
appIdentifier 字符串 应用标识,如"com.apple.mobilesafari"。

返回值

示例

  1. -- 运行safari
  2. appRun("com.apple.mobilesafari");

appKill(appIdentifier)关闭应用

关闭指定的应用。

参数

参数 类型 说明
appIdentifier 字符串 应用标识,如"com.apple.mobilesafari"。

返回值

示例

  1. -- 关闭运行着的safari
  2. appKill("com.apple.mobilesafari");

appState(appIdentifier)获取应用运行状态

获取指定应用的运行状态。

参数

参数 类型 说明
appIdentifier 字符串 应用标识,如"com.apple.mobilesafari"。

返回值

返回值 类型 说明
state 字符串 字符串类型的状态, 它们是: "NOT RUNNING", "ACTIVATED", "DEACTIVATED"。

示例

  1. -- 获得Safari的状态.
  2. local state = appState("com.apple.mobilesafari");
  3. alert(string.format("State of Safari: %s", state));
  4. -- 弹出提示Safari状态"ACTIVATED"


rootDir()获取文档目录

获得脚本存放的默认目录地址。这是脚本和截图默认的存放位置,在"/var/mobile/Library/AutoTouch/Scripts/"位置。

参数

返回值

返回值 类型 说明
dir 字符串 脚本存放的默认目录地址。

示例

  1. local dirPath = rootDir();
  2. alert(dirPath);
  3. -- 弹出提示 "/var/mobile/Library/AutoTouch/Scripts/"

usleep(microseconds)停顿

停顿若干个微秒,即1/1000000秒。

参数

返回值 类型 说明
microseconds 整型 停顿多少微秒。

返回值

示例

  1. -- 停顿1
  2. usleep(1000000);

log(content)记录日志

记录日志,可在日志界面查看。

参数

返回值 类型 说明
content 字符串 需要记录的日志内容。

返回值

示例

  1. log("play here...");

alert(message)弹出框提示

弹出对话框显示指定内容。

参数

返回值 类型 说明
message 字符串 需要显示的内容。

返回值

示例

  1. alert("Hello World!");

vibrate()震动

震动一次。

参数

返回值

示例

  1. -- 震动一次
  2. vibrate();

playAudio(audioFile, times)播放音频

播放指定位置的音频文件。

参数

返回值 类型 说明
audioFile 字符串 音频文件绝对路径。
times 整型 重复播放次数。0表示无限重复。

返回值

示例

  1. -- 播放音频,且无限重复
  2. playAudio("/var/audio.mp3", 0);

stopAudio()停止播放音频

停止正在播放的音频。

参数

返回值

示例

  1. -- 停止播放音频
  2. stopAudio();

getOrientation()获取屏幕方向

获取屏幕方向。返回整型值,具体对应关系请看“屏幕方向类型”。

参数

返回值

返回值 类型 说明
orientation 整型 屏幕方向,可能是这些值

示例

  1. local o = getOrientation();
  2. alert(string.format("Screen orientation is : %d", 0))
  3. -- 弹出提示屏幕方向2,标识屏幕倒置。

getScreenResolution()获取屏幕像素分辨率

获取屏幕像素分辨率。

参数

返回值

返回值 类型 说明
width 整型 屏幕分辨率宽度。
height 整型 屏幕分辨率高度。

示例

  1. local w, h = getScreenResolution();
  2. alert(string.format("Resolution of iPhone 6 Plus: width:%d, height:%d", w, h));
  3. -- iPhone 6 Plus分辨率宽度是1242, 分辨率高度是2208

getSN()获取设备序列号

获取设备序列号。

参数

返回值

返回值 类型 说明
SN 字符串 设备序列号。

示例

  1. local sn = getSN();
  2. alert(string.format("SN is : %s", sn));
  3. -- 弹出提示设备序列号是: C15NFK32TWD2

getVersion()获取AutoTouch版本号

获取AutoTouch版本号。

参数

返回值

返回值 类型 说明
version 字符串 AutoTouch版本号。

示例

  1. local version = getVersion();
  2. alert(string.format("Current version of AutoTouch is : %s", version));
  3. -- 弹出提示当前AutoTouch版本号是: 3.5.3-4

intToRgb(intColor)整型颜色转RGB

将整型颜色值转换为R, G, B单独的值.。

参数

参数 类型 说明
intColor 整型 整型颜色值。

返回值

返回值 类型 说明
R 整型 Red色值。
G 整型 Green色值。
B 整型 Blue色值。

示例

  1. local r, g, b = intToRgb(0x2b2b2b);
  2. alert(string.format("R:%d, G:%d, B:%d", r, g, b));

rgbToInt(r, g, b)RGB色值转整型颜色值

将R, G, B色值转换为整形颜色值。

参数

参数 类型 说明
R 整型 Red色值。
G 整型 Green色值。
B 整型 Blue色值。

返回值

返回值 类型 说明
intColor 整型 整型颜色值。

示例

  1. local intColor = rgbToInt(200, 255, 100);
  2. alert(string.format("Int type color: %d", intColor));

copyText(text)复制文本

将指定文本复制到剪贴板。

参数

参数 类型 说明
text 字符串 要复制的文本。

返回值

示例

  1. copyText("This is a copied text!");

clipText()获取剪贴板中的文本

获取剪贴板中复制的文本。

参数

返回值

返回值 类型 说明
text 字符串 剪贴板中复制的文本。

示例

  1. local text = clipText();
  2. alert(text);
  3. -- 弹出提示复制的文本"This is a copied text!";

inputText(text)输入文本

输入文本到当前选中的输入框中。inputText("\b")可以退格删除一个字符。

参数

参数 类型 说明
text 字符串 要输入的文本。

返回值

示例

  1. inputText("Let's input some text automatically without tapping the keyboard!");
  2. -- 退格删除3个字符
  3. inputText("\b\b\b");

fakeLocation(appIdentifier, latitude, longitude)伪装位置

对指定应用进行地址伪装,伪装将一直有效,直到调用clearFakeLocation函数清除伪装,或在AutoTouch应用设置>伪装位置中清除伪装。

参数

参数 类型 说明
appIdentifier 字符串 应用标识,如"com.apple.Maps"。
latitude 双精度浮点 double类型纬度数。
longitude 双精度浮点 double类型经度数。

返回值

示例

  1. -- 对苹果地图伪装地理位置到纬度36°,经度50°
  2. fakeLocation("com.apple.Maps", 36, 50);

clearFakeLocation(appIdentifier)清除位置伪装

清除对指定应用的位置伪装。

参数

参数 类型 说明
appIdentifier 字符串 应用标识,如"com.apple.Maps"。

返回值

示例

  1. -- 对苹果地图的位置伪装。
  2. clearFakeLocation("com.apple.Maps");

dialog(controls, enableRemember)自定义对话框

弹出自定义对话框接收用户输入。具体使用方法请看示例。

参数

参数 类型 说明
controls table 自定义控件的数组,目前可以使用这些对话框控件类型
enableRemember 布尔 是否使用“集中用户输入”的功能

返回值

示例

  1. local label = {type=CONTROLLER_TYPE.LABEL, text="Would you mind to provide some personal informations?"}
  2. local nameInput = {type=CONTROLLER_TYPE.INPUT, title="Name:", key="Name", value="Kevin"}
  3. local positionPicker = {type=CONTROLLER_TYPE.PICKER, title="Position:", key="Position", value="CEO", options={"CEO", "CTO", "CFO", "CXO"}}
  4. local developerSwitch = {type=CONTROLLER_TYPE.SWITCH, title="A Developer:", key="ADeveloper", value=1}
  5. local controls = {label, nameInput, positionPicker, developerSwitch}
  6. local enableRemember = true;
  7. -- 弹出对话框。对话框弹出后,脚本会暂停在这里等待用户输入,直到用户点击确定或取消。
  8. dialog(controls, enableRemember);
  9. -- 然后可以获取用户的输入值。
  10. alert(string.format("name:%s, birthday:%s, gender:%d", nameInput.value, positionPicker.value, developerSwitch.value))

未标题-7.png-204.3kB


clearDialogValues(script)

Clear the remembered values of the dialog created by the function dialog.

Parameters

Parameter Type Specification
script string script path. eg. there is a dialog.lua script in the scripts list, use it like this: clearDialogValues("dialog.lua");

Return values
None

Examples

  1. -- There is a dialog.lua script in the scripts list
  2. clearDialogValues("dialog.lua");

固定值类型


实体键类型

说明
KEY_TYPE.HOME_BUTTON Home键
KEY_TYPE.VOLUME_DOWN_BUTTON 音量减键
KEY_TYPE.VOLUME_UP_BUTTON 音量加键
KEY_TYPE.POWER_BUTTON 电源键

对话框控件类型

说明
CONTROLLER_TYPE.LABEL 文本标记
CONTROLLER_TYPE.INPUT 输入框
CONTROLLER_TYPE.PICKER 选择器
CONTROLLER_TYPE.SWITCH 开关

屏幕方向类型

说明
ORIENTATION_TYPE.UNKNOWN 方向不明,实际值为0
ORIENTATION_TYPE.PORTRAIT 竖屏,Home键在下,实际值为1
ORIENTATION_TYPE.PORTRAIT_UPSIDE_DOWN 倒屏,Home键在上,实际值为2
ORIENTATION_TYPE.LANDSCAPE_LEFT 向左横屏,Home键在右,实际值为3
ORIENTATION_TYPE.LANDSCAPE_RIGHT 向右横屏,Home键在左,实际值为4