Auto.js简单使用

杨良平

2023-12-01

Auto.js是使用JavaScript作为脚本语言
支持部分ES6特性
以下API是基于Auto.js4.X版本进行介绍
"自动操作"的部分又可以大致分为基于控件和基于坐标的操作
基于坐标的操作是传统按键精灵、触摸精灵等脚本软件采用的方式

快速入门

简单的demo案例
提示hello world

log("hello world")// 在左上角展示打印相当于日志
toast("hello world")//显示提示内容 hello world
console.show()// 将log信息展示出去

按键模拟

必须要打开无障碍模式

back()
模拟按下返回键,返回是否执行成功true/false

back()

主页

home()
模拟按下home按键,返回返回是否执行成功true/false

home()

电源菜单

powerDialog()
模拟长按电源键,返回返回是否执行成功true/false

powerDialog()

通知栏

notifications()
拉出通知栏,返回是否执行成功true/false

notifications()

显示快速设置

quickSettings()
显示快速设置(下拉通知栏到底),返回是否执行成功true/false

quickSettings()

显示最近任务

recents()
显示最近任务,返回是否执行成功true/false

recents()

分屏

splitScreen()
启动分屏,返回是否执行成功true/false

splitScreen()

模拟手指触摸

点击

click(x,y)
模拟点击坐标(x, y)，并返回是否点击成功
不推荐使用

click(x, y)

推荐使用press

press(x, y, duration)
模拟按住坐标(x, y), 和时间长度
如果时长超过500毫秒，则认为是长按

for(let i = 0;i<=10;i++){
    press(120,166,8)
    sleep(8)
}

滑动

swipe(x1,y1,x2,y2,duration)
起始坐标和结束坐标,执行时间长度

for(let i = 200;i<800;i+=10){
    sleep(8)
    swipe(i,800,i,1600,8)
}

连续滑动

gesture(duration,[x1,y1],[x2,y2],...)
duration手势的时长

gesture(2000,[200,800],[200,1500],[1000,1500],[1000,800],[200,800])

模拟多个手势

gestures
每个手势的参数为[delay, duration, 坐标]
delay为延迟多久(毫秒)才执行该手势

// 双指捏合
gestures([0, 500, [800, 300], [500, 1000]],
         [0, 500, [300, 1500], [500, 1000]]);

对话框

可以通过对话框和用户进行交互

alert("Hello World")

是和否的对话框
confirm()
是true否false

let tot = confirm("要清除所有缓存吗?")
if(tot){
    toast("清除成功");
}else{
    toast("不进行清除")
}

以上两种方法的第一个参数是标题
第二个参数是内容

输入内容

rawInput(title,prefill,callback)
title 标题
prefill 输入框的初始内容
callback 点击确定时被调用

let name = rawInput("输入名字","",(data)=>{
    toast(data)
})

例如

rawInput("请输入用户名", "狗蛋").then(name => {
    alert("您的用户名是" + name);
});

选择对话框

dialogs.select

title 对话框的标题
items 选项列表(字符串数组)
callback 回调函数

let options = ["选项A", "选项B", "选项C", "选项D"]
let i = dialogs.select("请选择一个选项", options,(data)=>{
    toast(data)
});

输入数字

dialogs.input
会把输入的字符串计算一遍再返回

let age = dialogs.input("请输入您的年龄", "");
alert(age,typeof age)// Number

例如

let age = dialogs.input("请输入您的年龄", "18",(data)=>{
    toast(data)
})

自定义对话框

dialogs.build({
    //对话框标题
    title: "发现新版本",
    //对话框内容
    content: "更新日志: 新增了若干了BUG",
    //确定键内容
    positive: "下载",
    //取消键内容
    negative: "取消",
    //中性键内容
    neutral: "到浏览器下载",
    //勾选框内容
    checkBoxPrompt: "不再提示"
}).on("positive", ()=>{
    //监听确定键
    toast("开始下载....");
}).on("neutral", ()=>{
    //监听中性键
    // 打开浏览器 https://www.autojs.org 地址
    app.openUrl("https://www.autojs.org");
}).on("check", (checked)=>{
    //监听勾选框
    toast(checked)
}).show();

打开应用程序

打开应用程序分为两部
获取应用程序的包名
打开应用包名对应的应用程序

获取应用包名

getPackageName("应用名称")
获取应用名称对应的已安装的应用的包名。如果该找不到该应用，返回null

let name = getPackageName("QQ")
toast(name)

应用包名启动应用

launch("com.tencent.mm")
通过应用包名启动应用。如果该包名对应的应用不存在，则返回false；否则返回true

let name = getPackageName("QQ")
if(!name){
    toast("停止")
    exit()// 立即停止脚本运行
}
launch(name);

暂停1秒

有些操作过于迅速
需要给手机一些渲染动画的时间

sleep(1000)

剪贴板

设置剪贴板内容

setClip("eeee")
sleep(500)//需要给一些延时

获取剪贴板内容
getClip()

toast(getClip())//

toast

提示消息
信息的显示是"异步"执行的
不会等待信息消失程序才继续执行
可以通过sleep 方式使用

for(var i = 0; i < 5; i++){
  toast(i);
  sleep(2000);
}