屏幕操作

requestScreenShot

请求截屏权限,注意:建议在冰狐智能辅助app处于前台时调用,否则可能会出现黑屏闪烁,请求权限失败。建议在脚本的最开头调用该函数。
参数:
参数名 类型 默认值 说明
confirmPermissionTag string 选填,默认值为'立即开始|允许' confirmPermissionTag为权限对话框中确认打开权限的文字。如果不为空,则会自动点击该控件,自动确认打开权限;若为空则需要自己点击确认按钮。支持"|"分割多个文本,找到一个即可。
retryCount integer 选填,默认值为5 点击confirmTag的重试次数
例子:
function main() {
    requestScreenShot();
}

screenShot

截屏,截屏图片存在sdcard/aznfz中,支持png和jpg格式,返回boolean,true表示截屏成功。注意:第一次调用前必须先申请截屏权限
参数:
参数名 类型 默认值 说明
fileName string 必填 截图存放的文件名,默认存放的路径在手机扩展存储目录(一般为sdcard,注意不同的手机存储目录可能不同)下的aznfz目录下,支持png和jpg后缀;
destPath string 选填 图片存放的目标文件夹,相对手机扩展存储目录。注意不是绝对路径
例子:
var ret = screenShot('pic.png');
console.log('ret:' + ret);

getScreenColor

获取屏幕某点的颜色值,返回颜色值为整型值,为ARGB格式,黑色为:0xFF000000,红色为:0xFFFF000000,透明为:0x00000000。注意:第一次调用前必须先申请截屏权限
参数:
参数名 类型 默认值 说明
x integer 必填 x坐标,像素值
y integer 必填 y坐标,像素值
例子:
var color = getScreenColor(200, 300);
console.log('color:' + color);

findColor

找色,在当前UI界面中寻找相似的颜色,返回数组,数组元素为找到的点,用point表示点。注意:第一次调用前必须先申请截屏权限
参数:
参数名 类型 默认值 说明
color integer/string 必填 颜色,支持整型值和字符串,字符串格式为#AARRGGBB或者#RRGGBB
options object {findAll:false, threshold: 0, region:[left, top, right, bottom], neighbor:[[offsetX, offsetY, color], [offsetX, offsetY, color]]} findAll表示是否查找所有符合条件的点。threshold表示每个rgb分量的阈值,默认为0,表示完全匹配,取值范围[0-255]。region表示搜索区域,默认搜索整个屏幕。neighbor表示对目标点的相邻点的颜色要求,偏移值为相对目标color坐标的偏移,可以为负值。
例子:
var arr = findColor('#445533', {threshold: 3, findAll: true, region:[10, 10, 300, 300], neighbor:[[0, 3, '#443322'],[3, 0, '#443322']]});
for(var point of arr) {
    console.log('find color x:', point.x, ' y:', point.y);
}

findImage

找图,在当前UI界面中寻找指定的图片,返回找到图片的左上角坐标point,point.x和point.y表示。注意:第一次调用前必须先申请截屏权限
参数:
参数名 类型 默认值 说明
imageFileName string 必填 带路径的图片文件名
例子:
var point = findImage('/sdcard/template.jpg');
if (point) {
   console.log('find success x:', point.x, ' y:', point.y);
} else {
    console.log('find image failed');
}

requestLockScreen

请求锁屏权限,调用后需要人工点击同意,必须在launchApp之前调用,建议在脚本的第一行调用,返回boolean,true表示权限请求成功。注意该权限只需要设置一次,除非卸载冰狐智能辅助app
参数:
参数名 类型 默认值 说明
maxWaitTime integer 选填 最长等待多长时间设置完成,单位毫秒,默认值1000*40
例子:
var ret = requestLockScreen();
console.log('ret:' + ret);

lockScreen

熄灭屏幕,锁屏。
参数:
参数名 类型 默认值 说明

wakeup

亮屏。
参数:
参数名 类型 默认值 说明