该模块用于管理定时任务，用于在某些时间或某些事件触发时自动运行脚本。正如Auto.js Pro内置的定时任务功能一样，打包的脚本也可以使用这些函数来创建定时任务。

添加定时任务时建议加上申请忽略电池优化的代码，防止被Android限制在后台运行。参见电池管理 – PowerManageropen in new window。

if (!$power_manager.isIgnoringBatteryOptimizations()) {
    console.log("未开启忽略电池优化");
    $power_manager.requestIgnoreBatteryOptimizations();
}

注意

由于各系统的限制，定时任务不能一定保证准时运行，请尽量将Auto.js Pro加入各种白名单和允许自启动权限。参见Don’t kill my appopen in new window。

#$work_manager.addDailyTask(task)

• task {Object} 用于描述此定时任务的配置，包括：
  • path {string} 需要运行的脚本的绝对路径
  • time {number} | {string} | {Date} 此定时任务每天运行的时间，支持时间戳、字符串和Date对象
  • delay {number} 任务开始前的延迟，单位毫秒，默认为0；如果延时较长，则此参数并不可靠，建议勿用此参数控制大于30s的延迟
  • loopTimes {number} 任务循环次数，默认为1
  • interval {number} 任务循环间隔，单位毫秒，默认为0；如果间隔较长，则此参数并不可靠，建议勿用此参数控制大于30s的间隔
• 返回 {TimedTask}

新增一个每日运行一次的定时任务。其中时间参数会只保留每天的时间，忽略年月日。

例如创建一个每日下午1点14分运行的定时任务：

console.log($work_manager.addDailyTask({
    path: "/sdcard/脚本/test.js",
    time: new Date(0, 0, 0, 13, 14, 0),
    delay: 0,
    loopTimes: 1,
    interval: 0,
}));

#$work_manager.addWeeklyTask(task)

• task {Object}
  • path {string} 需要运行的脚本的绝对路径
  • time {number} | {string} | {Date} 此定时任务每天运行的时间，支持时间戳、字符串和Date对象
  • daysOfWeek {string[]} 每周几运行，参数包括：['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'] 或 ['一', '二', '三', '四', '五', '六', '日']
  • delay {number} 任务开始前的延迟，单位毫秒，默认为0；如果延时较长，则此参数并不可靠，建议勿用此参数控制大于30s的延迟
  • loopTimes {number} 任务循环次数，默认为1
  • interval {number} 任务循环间隔，单位毫秒，默认为0；如果间隔较长，则此参数并不可靠，建议勿用此参数控制大于30s的间隔
• 返回 {TimedTask}

新增一个按星期运行的定时任务。

例如创建一个每周一周二下午1点14分运行5次的定时任务

log($work_manager.addWeeklyTask({
    path: "/sdcard/脚本/test.js",
    // 时间戳为Mon Jun 21 2021 13:14:00 GMT+0800 (中国标准时间)，事实上只有13:14:00的参数起作用
    time: 1624252440000,
    daysOfWeek: ['一', '二'],
    delay: 0,
    loopTimes: 5,
    interval: 10
}));

#$work_manager.addDisposableTask(task)

• task {Object}
  • path {string} 需要运行的脚本的绝对路径
  • time {number} | {string} | {Date} 此定时任务开始运行的时间，支持时间戳、字符串和Date对象（9.3以上版本可以用这个字段代替date）
  • date {number} | {string} | {Date} 同time，由于一个失误，原本这个字段应该是time（9.2以之前版本需要用这个字段指定时间）
  • delay {number} 任务开始前的延迟，单位毫秒，默认为0；如果延时较长，则此参数并不可靠，建议勿用此参数控制大于30s的延迟
  • loopTimes {number} 任务循环次数，默认为1
  • interval {number} 任务循环间隔，单位毫秒，默认为0；如果间隔较长，则此参数并不可靠，建议勿用此参数控制大于30s的间隔
• 返回 {TimedTask}

此函数会新增一个一次性的定时任务，任务在执行一次后将在定时任务中自动删除。

例如创建一个2021年5月21日13点14分运行的定时任务。

log($work_manager.addDisposableTask({
    path: "/sdcard/脚本/test.js",
    date: new Date(2021, 5, 21, 13, 14, 0),
}));

#$work_manager.addIntentTask(task)

• task {Object}
  • path {string} 需要运行的脚本的绝对路径
  • action {string} 需要监听的事件的广播的Action名称
  • delay {number} 任务开始前的延迟，单位毫秒，默认为0；如果延时较长，则此参数并不可靠，建议勿用此参数控制大于30s的延迟
  • loopTimes {number} 任务循环次数，默认为1
  • interval {number} 任务循环间隔，单位毫秒，默认为0；如果间隔较长，则此参数并不可靠，建议勿用此参数控制大于30s的间隔
• 返回 {TimedTask}

新增一个广播定时任务，会在特定事件(广播)发生时运行。

其中最关键的参数是广播事件的Action。系统在发生特定事件（比如电量变化）时会发出特定Action的广播，参见广播Action。

例如创建一个在电量发生变化时运行脚本的定时任务：

log($work_manager.addIntentTask({
    path: "/sdcard/脚本/test.js",
    action: Intent.ACTION_BATTERY_CHANGED,
}));

#$work_manager.removeTimedTask(id)

• id {number} 定时任务的id
• 返回 {boolean} 是否删除成功

通过id删除按时间运行的定时任务。

#$work_manager.removeIntentTask(id)

• id {number} 定时任务的id
• 返回 {boolean} 是否删除成功

通过id删除按事件运行的定时任务。

#$work_manager.getTimedTask(id)

• id {number} 定时任务的id
• 返回 {TimedTask}

通过id获取按时间运行的定时任务。

#$work_manager.getIntentTask(id)

• id {number}定时任务的id
• 返回 {TimedTask}

通过id获取按事件运行的定时任务。

例如：

// 添加一个手机电量变化就触发的定时任务
let id = $work_manager.addIntentTask({
    path: "/sdcard/脚本/test.js",
    action: Intent.ACTION_BATTERY_CHANGED,
    delay: 0,
    loopTimes: 1,
    interval: 0
});
// 通过id找到该定时任务
let task = $work_manager.getIntentTask(id.id);
// 打印该定时任务所运行脚本的路径
log(task.scriptPath);

#$work_manager.queryTimedTasks([options])

• options {Object} 查询参数，可选。不填时，查询到所有按时间运行的定时任务
  • path {string} 定时任务脚本的路径
• 返回 {TimedTask[]} 查找到的定时任务数组

通过脚本路径查找按时间运行的定时任务，或者查询所有按时间运行的定时任务。

例如：

let jsPath = "/sdcard/脚本/test.js";
// 添加一个每周日下午1点13分运行的定时任务，循环运行5次脚本，间隔5000毫秒
let task = $work_manager.addWeeklyTask({
    path: jsPath,
    time: 1624252440000,
    daysOfWeek: ['sunday'],
    delay: 0,
    loopTimes: 5,
    interval: 5000
});
// 按脚本路径查找定时任务
let tasks = $work_manager.queryTimedTasks({
    path: jsPath
});
// 删除查找到的所有定时任务
tasks.forEach(t => {
    console.log("删除: ", t);
    log($work_manager.removeTimedTask(t.id));
});

#$work_manager.queryIntentTasks([options])

• options {Object} 查询参数，可选；不填时，查询到所有按事件运行的定时任务
  • path {string} 定时任务脚本的路径
  • action {string} 广播名称
• 返回 {TimedTask[]} 查找到的定时任务数组

通过脚本路径或监听广播查找按广播运行的定时任务，或者查询所有按广播运行的定时任务。

例如：

//添加一个手机电量变化就触发的定时任务
let task = $work_manager.addIntentTask({
    path: "/sdcard/脚本/test.js",
    action: Intent.ACTION_BATTERY_CHANGED,
    delay: 0,
    loopTimes: 1,
    interval: 0
});
// 查找所有的触发事件定时任务
let tasks = $work_manager.queryIntentTasks();
// 打印所有查找到的定时任务的触发事件
tasks.forEach(t => {
    console.log(t.action);
});

#TimedTask

表示一个定时任务对象，包含了此定时任务的基本信息。

#TimedTask.id

• {number}

此定时任务的唯一id，用于查找定时任务。

#TimedTask.scriptPath

• {string}

此定时任务的所执行脚本的路径。

#TimedTask.millis

• {number}

此定时任务的执行时间的时间戳，单位为毫秒。

#TimedTask.delay

• {number}

此定时任务所设置的延迟，

#TimedTask.interval

• {number}

此定时任务循环的间隔。

#TimedTask.loopTimes

• {number}

此定时任务循环的次数。

#TimedTask.action

• {string}

此定时任务的触发事件（只有广播定时任务才有该参数）。

#广播Action

可以在Android文档Intent: Actionopen in new window中找到大多数Android系统自带的Intent Action；一些系统组件也会自定义自己的Action，比如网络连接变化时触发的Action是ConnectivityManager.CONNECTIVITY_ACTION（使用时需要导入ConnectivityManager)。这些Action通常附带一些额外参数，可以通过$engines.myEngine().execArgv.intent获取广播的参数，参见广播参数。

以下列出一些常见的广播Action：

示例：

// 添加一个Auto.js启动时触发的定时任务（在打包中软件也可以使用）
console.log($work_manager.addIntentTask({
    path: "/sdcard/脚本/test.js",
    action: "org.autojs.autojs.action.startup",
}));

// 添加一个网络状态变化时触发的定时任务
let ConnectivityManager = android.net.ConnectivityManager;
console.log($work_manager.addIntentTask({
    path: "/sdcard/脚本/conn_test.js",
    action: ConnectivityManager.CONNECTIVITY_ACTION,
})); 

#广播参数

按广播执行的定时任务被执行时，我们可以通过$engines.myEngine().execArgv.intent获取到intent对象，再通过Android文档查阅intent对象的参数，从而获取这些参数。

例如电量变化的广播中，查询文档BatteryManageropen in new window可以知道通过EXTRA_LEVEL参数获取具体电量。

// 因电量变化而执行的定时任务脚本
let intent = $engines.myEngine().execArgv.intent;
if (!intent) {
    console.log("请设置定时任务 - 电量变化时来运行此脚本");
    exit();
}
let BatteryManager = android.os.BatteryManager;
let level = intent.getIntExtra(BatteryManager.EXTRA_LEVEL, -1);
console.log("电量为", level);

#Bug