$engine

• 更新时间:2025-09-04 17:44:10

脚本引擎

脚本引擎是全局唯一的对象，主要负责调度脚本的运行，脚本任务创建、运行、暂停、继续等操作都可以通过脚本引擎对象完成。

run(path)

运行路径中的代码

• 参数 : path {string} 脚本路径
• 返回 : {string} taskID
• 版本 : 1.0.0

let id = $engine.run("/sdcard/脚本.js");

run(jsFile)

运行路径中的代码

• 参数 : jsFile {File} 代码文件
• 返回 : {string} taskID
• 版本 : 1.0.0

let id = $engine.run($file.open("/sdcard/脚本.js"));

runCode(code)

运行代码

• 参数 : code {string} 代码
• 返回 : {string} taskID
• 版本 : 1.0.0

let id = $engine.runCode(`
    alert("提示","我被运行了");
`);

runCode(path, code)

运行代码 此处传入的路径只是决定了$task中的上下文环境路径，但不是通过该路径读取文件内容，因此可以随意填写。

• 参数 : path {string} 路径(决定了$task的路径:$task.getPath())
• 参数 : code {string} 代码
• 返回 : {string} taskID
• 版本 : 1.0.0

let id = $engine.runCode("/sdcard/main.js",`
    alert("提示","我被运行了");
`);

pause(id)

暂停运行

该方法会暂停未执行完毕的所有脚本

• 参数 : id {string} 任务ID
• 版本 : 1.3.9

let id = $engine.run("/sdcard/脚本.js");
//暂停运行
$engine.pause(id);
sleep(2000);
//继续运行
$engine.start(id);

isPause(id)

判断任务是否处于暂停状态

遍历所有任务列表，查询这个id的任务是否处于暂停状态

• 参数 : id {string} 任务id
• 返回 : {boolean} false:运行态; true:暂停态; null:未找到;
• 版本 : 1.3.9

let isPause = $engine.isPause(id);
if(isPause!=null){
    if(isPause){
        info("任务已暂停");
    }else{
        info("任务正在跑");
    }
}else{
    info("未找到任务");
}

start(id)

开始运行

该方法会继续运行暂停的脚本

• 参数 : id {string} 任务ID
• 版本 : 1.3.9

let id = $engine.run("/sdcard/脚本.js");
//暂停运行
$engine.pause(id);
sleep(2000);
//继续运行
$engine.start(id);

ls()

列出所有的任务信息

• 返回 : {JsTaskInfo[]} 任务列表信息
• 版本 : 1.0.0

stop(id)

停止指定任务

• 参数 : id {string} 任务id
• 版本 : 1.0.0

let id = $engine.run("/sdcard/脚本.js");
$engine.stop(id);

stopAll(exit)

停止所有任务

• 参数 : exit {boolean} 是否退出系统
• 版本 : 1.0.0

$engine.stopAll(true);//会杀死app

stopAll()

停止所有任务

• 版本 : 1.0.0

$engine.stopAll();

lsTask()

获得任务列表信息

• 返回 : {JsExecuteTask[]} 任务列表信息
• 版本 : 1.0.0

has(id)

停止指定任务

• 参数 : id {string} 任务id
• 版本 : 1.5.0

let id = $engine.run("/sdcard/脚本.js");
//怕判断任务是否存在(任务结束后会自动销毁)
let hasTask = $engine.has(id);
if(hasTask){
    $engine.stop(id);
}