跳到主要内容

JS与UI交互

说明​

  • 本章节主要讲述JS与UI元素进行交互
  • 和UI交互的的js模块对象统一以 ui开头，例如 ui.toast("msg")

如何使用​

  • 在工程的layout文件夹下新建一个ui.js文件，内容为
function main() {
    ui.toast("我是JS控制的UI");
}

main();
  • 加载layout的main.xml文件并展示出来，内容为
function main() {
    ui.toast("我是JS控制的UI");
    ui.layout("标签1", "main.xml");
}

main();
  • 以上的操作即可完成一个简单的展示main.xml布局的操作

高级操作​

  • 编写一个ui.js
/**
 * 该文件由EasyClick开发工具自动创建
 */
function main() {
    ui.toast("我是ui的Toast函数");
    var set = ui.layout("参数设置", "main.xml");
    ui.layout("其他说明", "main2.xml");
    ui.logd("设置UI结果: " + set);

    //Switch 开关按钮的用法
    var auto_env = ui.getViewValue(ui.auto_env);
    ui.logd("tag为 auto_env 的值: " + auto_env);
    //开关按钮的事件
    ui.setEvent(ui.auto_env, "checkedChange", function (view, isChecked) {
        ui.logd("tag为 auto_env isChecked " + isChecked);
        if (isChecked) {
            startAutoEnv();
        }
    });
    if (ui.isServiceOk()) {
        ui.auto_env.setChecked(true);
    } else {
        ui.auto_env.setChecked(false);
    }

    //EditText 编辑框的用法
    var name = ui.getViewValue(ui.name);
    ui.logd("tag为name的值: " + name);
    ui.name.setText("我是name的值");
    //Spinner 下拉选择框用法
    var sex = ui.getViewValue(ui.sex);
    ui.logd("tag为 sex 的值: " + sex);
    //下拉选择框的事件
    ui.setEvent(ui.sex, "itemSelected", function (position, value) {
        ui.logd("tag为 sex itemSelected " + value);
    });

    //RadioButton 单选框用法
    var three = ui.getViewValue(ui.three);
    ui.logd("tag为 three 的值: " + three);
    //单选框的事件
    ui.setEvent(ui.three, "checkedChange", function (view, isChecked) {
        ui.logd("tag为 three isChecked " + isChecked);
    });
    //CheckBox 复选框用法
    var dance = ui.getViewValue(ui.dance);
    ui.logd("tag为 dance 的值: " + dance);
    //复选框的事件
    ui.setEvent(ui.dance, "checkedChange", function (view, isChecked) {
        ui.logd("tag为 dance isChecked " + isChecked);
    });

    //saveAllBtn 保存参数事件
    ui.setEvent(ui.saveAllBtn, "click", function (view) {
        var s = ui.saveAllConfig();
        ui.logd("保存所有参数结果 " + s)
    });

    //系统设置按钮
    ui.setEvent(ui.systemSetting, "click", function (view) {
        ui.openECSystemSetting();

    });
    //启动脚本按钮
    ui.setEvent(ui.startBtn, "click", function (view) {
        ui.start();
    });
    //启动环境按钮
    ui.setEvent(ui.envBtn, "click", function (view) {
        //异步启动环境，如果成功了就设置auto_env 按钮的状态
        startAutoEnv();
    });
    //获取所有的UI参数
    ui.logd("获取所有的UI参数：" + ui.getConfigJSON());
    //设置值的用法，这里先注释掉
    // ui.setViewValue(ui.name, "我是设置的");
    // ui.setViewValue(ui.auto_env, false);
    // ui.setViewValue(ui.sex, "男生|女生");
    // ui.setViewValue(ui.three, true);
    // ui.setViewValue(ui.dance, false)
    //内存临时存储变量和数据
    ui.putShareData("nameVar", ui.name);
    ui.putShareData("value", "我是value");


}

function startAutoEnv() {
    ui.startEnvAsync(function (r) {
        ui.logd("启动环境结果: " + r);
        ui.auto_env.setChecked(r);
    });
}

main();

脚本如何与JS交互​

  • 以下代码是在js/main.js中运行的
function main() {
    //脚本获取UI中的对象，肯定是要先有界面才行
    //这里可以直接引用UI对象
    //假设在xml中，我们配置一个一个tag=name 的输入框，EditText
    //获取UI模块设置的变量和数据
    logd(ui.getShareData("nameVar"))
    logd(ui.getShareData("value"))


    //第一种方式，变量引用
    //重置JS变量
    ui.resetUIVar()
    //打印一下UI中的name变量
    logd("ui.name " + ui.name)
    if (ui.name) {
        //UI主线程中处理
        getHandler().post(function () {
            ui.name.setText("Fsdafsadfsa")
            ui.logd("输入框内容为 : " + ui.name.getEditableText());
        });

    }
    sleep(2000);
    //第二种方式， findViewByTag
    var name = ui.findViewByTag("name");
    if (name) {
        //UI主线程中处理
        getHandler().post(function () {
            name.setText("懵逼了")
            ui.logd("输入框内容为 : " + name.getEditableText());
        });

    }


    sleep(5000);

}

main();

消息类​

消息函数 toast​

  • 显示Toast信息
  • @param msg 信息
function main() {
    ui.toast("我是JS控制的UI");
}

main();

日志函数 logd​

  • 调试日志打印
  • @param msg 打印的消息
function main() {
    ui.logd("我是消息");
}

main();

布局UI类​

设置布局 layout​

  • 创建一个布局并设置到当前的页面中
  • @param name tab标签的名称
  • @param content 可以是layout文件夹中的文件名称，也可以直接是xml文件的内容
  • @return 布尔型 true代表成功， false代表失败
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");
    ui.logd("参数说明创建结果: " + u1);
    ui.logd("其他说明创建结果: " + u2);
}

main();

解析布局 parseView​

  • 解析布局并返回
  • @param content 可以是layout文件夹中的文件名称，也可以直接是xml文件的内容
  • @return View android的View对象，解析有问题就是null
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.parseView("main.xml");
    ui.logd("创建结果: " + u1);
}

main();

查找视图 resetUIVar​

  • 将所有的tag转换成UI的属性直接调用
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");
    ui.resetUIVar();
}

main();

查找视图 findViewByTag​

  • 通过tag查找到一个视图
  • @param tag 标签值
  • @return View android原生的View对象
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");
    //查找tag=name的视图
    var nameView = ui.findViewByTag("name");
    ui.logd("name view is:" + nameView);
}

main();

保存数据到存储区 putShareData​

  • 存储数据到存储区中，脚本可以使用,可用于存储变量和数据
  • @param key 键
  • @param value 值
  • @return 布尔型 true成功 false失败
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");
    //保存到存储区
    ui.putShareData("name", "我是临时数据");
}

main();

从存储区读取数据 getShareData​

  • 从存储区获取在UI模块存储的数据
  • @param key 键
  • @return 存储的数据
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");
    //从存储区读取数据
    var d = ui.getShareData("name");
    logd("d =" + d)
}

main();

从存储区清空数据 clearAllShareData​

  • 清理所有存储区的数据
  • @return true 或者 false
function main() {
    ui.clearAllShareData();
}

main();

设置事件 setEvent​

  • 设置事件
  • @param view 要设置事件的视图，可以是事件的tag值
  • @param eventType 时间类型： click：点击，checkedChange：单选和多选按钮的选中状态改变事件，itemClick：列表的项目点击，itemSelected：列表的项目选中
  • @param eventCallback 事件回调函数
  • @return 布尔型 true代表设置成功， false代表设置失败
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");
    //下拉选择框的事件
    ui.setEvent(ui.sex, "itemSelected", function (position, value) {
        ui.logd("tag为 sex itemSelected " + value);
    });
    ui.setEvent(ui.dance, "checkedChange", function (view, isChecked) {
        ui.logd("tag为 dance isChecked " + isChecked);
    });
    ui.setEvent(ui.startBtn, "click", function (view) {
        ui.start();
    });

}

main();

获取根视图 getRootView​

  • 取得当前的根视图对象，因为有可能是多标签的页面，返回的有可能是个集合
  • @return View 对象列表
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");
    //下拉选择框的事件
    var views = ui.getRootView();
    ui.logd("views " + views)
    for (var i = 0; i < views.length; i++) {
        var value = views[i];
        ui.logd("view-" + value)
    }
}

main();

设置视图值 setViewValue​

  • 设置视图的值
  • @param tagOrView 视图的tag或者视图对象
  • @param value 值，字符串或者是布尔型
  • @return 布尔型 true代表成功 false代表失败
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");
    //ui.name 是值xml中tag=name的视图对象
    ui.setViewValue(ui.name, "我是设置的名称")

}

main();

获取视图值 getViewValue​

  • 取得视图的值
  • @param tagOrView 视图的tag或者视图对象
  • @return 字符串或者布尔型
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");
    //ui.name 是值xml中tag=name的视图对象
    ui.setViewValue(ui.name, "我是设置的名称");
    var v = ui.getViewValue(ui.name);

    ui.logd("获取name的值为: " + v);

}

main();

取得UI配置值 getConfigJSON​

  • 取得所有UI配置
  • @return JSON字符串
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");

    ui.setViewValue(ui.name, "我是name");
    //保存所有的值
    ui.saveAllConfig();

    var data = ui.getConfigJSON();
    ui.logd("data " + data);

    data = JSON.parse(data);
    //打印name的值，如果没有值要先保存一下
    ui.logd(data.name);


}

main();

取得单个UI值 getConfig​

  • 取得单个UI配置项
  • @param key 配置的key
  • @return 字符串
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");

    ui.setViewValue(ui.name, "我是name");
    //保存所有的值
    ui.saveAllConfig();

    //单独保存某些值
    ui.saveConfig("sex", "女同学");
    ui.saveConfig("music", true);

    var data = ui.getConfigJSON();
    ui.logd("data " + data);

    data = JSON.parse(data);
    //打印name的值，如果没有值要先保存一下
    ui.logd(data.name);
    //获取单个值
    ui.logd(ui.getConfig("name"));
}

main();

保存所有UI值 saveAllConfig​

  • 根据设置的tag，保存所有配置
  • @return 布尔型 true 保存成功，false 保存失败
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");

    ui.setViewValue(ui.name, "我是name");
    //保存所有的值
    ui.saveAllConfig();

    //单独保存某些值
    ui.saveConfig("sex", "女同学");
    ui.saveConfig("music", true);

    var data = ui.getConfigJSON();
    ui.logd("data " + data);

    data = JSON.parse(data);
    //打印name的值，如果没有值要先保存一下
    ui.logd(data.name);
}

main();

保存单个UI值 saveConfig​

  • 保存UI参数值
  • @param key UI的key
  • @param value UI的值
  • @return 布尔型 true代表成功 false代表失败
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");

    ui.setViewValue(ui.name, "我是name");
    //保存所有的值
    ui.saveAllConfig();

    //单独保存某些值
    ui.saveConfig("sex", "女同学");
    ui.saveConfig("music", true);

    var data = ui.getConfigJSON();
    ui.logd("data " + data);

    data = JSON.parse(data);
    //打印name的值，如果没有值要先保存一下
    ui.logd(data.name);
}

main();

移出所有配置选项 removeAllUIConfig​

  • 移出所有配置选项
  • @return 布尔型 true代表成功 false代表失败
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");

    ui.setViewValue(ui.name, "我是name");
    //移出所有配置选项
    ui.removeAllUIConfig();

    //单独保存某些值
    ui.saveConfig("sex", "女同学");
    ui.saveConfig("music", true);

    var data = ui.getConfigJSON();
    ui.logd("data " + data);

    data = JSON.parse(data);
    //打印name的值，如果没有值要先保存一下
    ui.logd(data.name);
}

main();

读取图像资源 resResAsDrawable​

  • 读取IEC包中的res文件夹某个文件资源，并变成android的Drawable对象返回
  • @param path res文件夹中的资源文件路径
  • @return Drawable 图像对象或者null
function main() {
    // xml文件在layout文件夹下
    var u1 = ui.layout("参数说明", "main.xml");
    var u2 = ui.layout("其他说明", "main2.xml");

    //checkbox.png 存放在res文件夹下
    var bg = ui.resResAsDrawable("checkbox.png");
    //设置动态背景色
    ui.music.setBackgroundDrawable(bg);
    //设置按钮的背景
    ui.music.setButtonDrawable(bg);

}

main();

对话框​

alert​

  • alert，弹窗
  • @param map 例如 {"title":""} ,key的固定只有
  • title 标题
  • msg: 消息
  • cancelText: 取消按钮文字
  • okText: 确定按钮文字
  • cancelable: 是否可取消
  • @param okBtnCallback 点击确认按钮的回调
  • @param cancelBtnCallback 点击取消按钮的回调
  • @param dismissListener 对话框消失的回调
  • @return 布尔型 true 代表成功，false 代表失败
function main() {
    var p = {
        "title": "沙雕确认",
        "msg": "你是沙雕吗？",
        "cancelable": true,
        "cancelText": "不是",
        "okText": "我是"
    };
    ui.alert(p,
        function (dialog, v) {
            logd("ok btn click  : ")
            //让对话消失掉
            dialog.doDismiss();
            return true;
        },
        function (dialog, v) {
            logd("cancel btn click ")
            //让对话消失掉
            dialog.doDismiss();
            return true;
        },
        function () {
            logd("mission btn click ")
            return true;
        });

}

main();

inputDialog​

  • inputDialog 输入框弹窗
  • @param map 例如 {"title":""},key的固定只有
  • title 标题
  • msg: 消息
  • cancelText: 取消按钮文字
  • okText: 确定按钮文字
  • cancelable: 是否可取消
  • @param okBtnCallback 点击确认按钮的回调
  • @param cancelBtnCallback 点击取消按钮的回调
  • @param dismissListener 对话框消失的回调
  • @return 布尔型 true 代表成功，false 代表失败
function main() {
    var p = {
        "title": "沙雕确认",
        "msg": "你是沙雕吗？",
        "cancelable": true,
        "cancelText": "不是",
        "okText": "我是"
    };
    ui.inputDialog(p,
        function (dialog, v, text) {
            //text 是输入的文字
            logd("ok btn click  : " + text)
            //让对话消失掉
            dialog.doDismiss();
            return true;
        },
        function (dialog, v, text) {
            logd("cancel btn click " + text)
            //让对话消失掉
            dialog.doDismiss();
            return true;
        },
        function () {
            logd("mission btn click ")
            return true;
        });

}

main();

customDialog​

  • 自定义对话框
  • @param params 例如 {"cancelable":""},key的固定只有
  • fullScreen 是否全屏
  • cancelable: 是否可取消
  • @param view 原生的视图
  • @param onViewBind 视图绑定时候回调函数
  • @param dismissListener 对话框消失的回调
  • @return 布尔型 true 代表成功，false 代表失败
function main() {
    //用安卓原生的控件
    importPackage(android.widget)
    var textView = new TextView(ui.getContext());
    textView.setText("sdfasfsad");
    // 使用xml解析出来的控件
    var textView = ui.parseView("main2.xml");
    ui.customDialog({
            "fullScreen": true,
            "cancelable": true
        },
        textView,
        function (dialog, v) {
            //这里面可以拿到视图对象，然后进行设置各种事件
        }, function () {
            logd("dsssss")
        })

}

main();

浮窗类​

浮窗权限 hasFloatViewPermission​

  • 是否有浮窗权限
  • @return 布尔型 true代表有权限 false代表无权限
function main() {
    var r = ui.hasFloatViewPermission();
    if (!r) {
        var req = ui.requestFloatViewPermission(10000);
        ui.logd("申请浮窗权限: " + req);
    }
    r = ui.hasFloatViewPermission();
    ui.logd("是否有浮窗权限: " + r);

}

main();

请求浮窗权限 requestFloatViewPermissionAsync​

  • 异步请求浮窗权限
  • @param timeout 超时时间
  • @param callback 回调函数
  • @return 布尔型 true代表有权限 false代表无权限
function main() {
    var r = ui.hasFloatViewPermission();
    if (!r) {
        ui.requestFloatViewPermissionAsync(20000, function (r) {
            ui.logd("申请浮窗权限: " + r);
        });

    }
    r = ui.hasFloatViewPermission();
    ui.logd("是否有浮窗权限: " + r);

}

main();

展示控制浮窗 showCtrlWindow​

  • 展示控制浮窗
  • @return 布尔型 true代表成功，false代表失败
function main() {
    var r = ui.hasFloatViewPermission();
    ui.logd("是否有浮窗权限:" + r)
    if (!r) {
        return
    }
    //展示浮窗
    ui.showCtrlWindow();
    ui.logd("显示消息")
    //3秒后在UI线程消失掉
    ui.getHandler().postDelayed(function () {
        ui.closeCtrlWindow();
    }, 3000);
}

main();

关闭控制浮窗 closeCtrlWindow​

  • 关闭控制浮窗
  • @return 布尔型 true代表成功，false代表失败
function main() {
    var r = ui.hasFloatViewPermission();
    ui.logd("是否有浮窗权限:" + r)
    if (!r) {
        return
    }
    //展示浮窗
    ui.showCtrlWindow();
    ui.logd("显示消息")
    //3秒后在UI线程消失掉
    ui.getHandler().postDelayed(function () {
        ui.closeCtrlWindow();
    }, 3000);
}

main();

启停浮窗新增按钮 addCtrlView​

  • 新增启停浮窗按钮
  • 适用版本(EC 6.0.0+)
  • @param tag 按钮的标签
  • @param icon 按钮的图标路径，工程中的res/文件下的图片，例如填写 res/a.png
  • @param width 按钮的宽度，单位是dp，系统按钮是36
  • @param height 按钮的高度，单位是dp，系统按钮是36
  • @param index 按钮的加入索引，-1代表往后添加，0代表的是加入到第一位
  • @param onClickListener 按钮的点击回调
  • @return 布尔型 true代表成功，false代表失败
function main() {
    ui.toast("我是ui的Toast函数");
    var set = ui.layout("参数设置", "main.xml");
    ui.layout("其他说明", "main2.xml");
    ui.logd("设置UI结果: " + set);
    ui.showCtrlWindow()
    // 这里最好用延时，因为showCtrlWindow是异步的，防止没效果
    ui.run(1000, function () {
        //移出对应的视图
        //关闭悬浮框按钮
        ui.removeCtrlView("log_close_ctrl")
        //回主页按钮
        ui.removeCtrlView("main_page_ctrl")
        //脚本启停按钮
        ui.removeCtrlView("script_status_ctrl")
        //日志框按钮
        ui.removeCtrlView("log_window_ctrl")
        //退出脚本按钮
        ui.removeCtrlView("system_power_ctrl")
        //加入新的按钮
        ui.addCtrlView("tag", "res/a.png", 32, 32, 0, function (v) {
            logd(v);
            //启动脚本
            ui.start();
        })
    })
    ui.run(3000, function () {
        //移出所有控制视图
        ui.removeAllCtrlView()
    })
    ui.run(5000, function () {
        //重置
        ui.resetDefaultCtrlView()
    })
}

main();

启停浮窗更新按钮 updateCtrlView​

  • 更新启停浮窗按钮
  • 适用版本(EC 6.6.0+)
  • @param tag 按钮的标签
  • @param icon 按钮的图标路径，工程中的res/文件下的图片，例如填写 res/a.png
  • @param onClickListener 按钮的点击回调
  • @return 布尔型 true代表成功，false代表失败
function main() {
    ui.toast("我是ui的Toast函数");
    var set = ui.layout("参数设置", "main.xml");
    ui.layout("其他说明", "main2.xml");
    ui.logd("设置UI结果: " + set);
    ui.showCtrlWindow()
    // 这里最好用延时，因为showCtrlWindow是异步的，防止没效果
    ui.run(1000, function () {
        //移出对应的视图
        //关闭悬浮框按钮
        ui.removeCtrlView("log_close_ctrl")
        //回主页按钮
        ui.removeCtrlView("main_page_ctrl")
        //脚本启停按钮
        ui.removeCtrlView("script_status_ctrl")
        //日志框按钮
        ui.removeCtrlView("log_window_ctrl")
        //退出脚本按钮
        ui.removeCtrlView("system_power_ctrl")
        //加入新的按钮
        ui.addCtrlView("tag", "res/a.png", 32, 32, 0, function (v) {
            logd(v);
            //启动脚本
            ui.start();
        })
    })
    ui.run(3000, function () {
        //更新按钮动作
        ui.updateCtrlView("tag", "res/ab.png", function (v) {
            logd("aaaa");

        })
    })

}

main();

删除启停浮窗按钮 removeCtrlView​

  • 删除启停浮窗按钮
  • 适用版本(EC 6.0.0+)
  • @param tag 按钮的标签
  • @return 布尔型 true代表成功，false代表失败
function main() {
    ui.toast("我是ui的Toast函数");
    var set = ui.layout("参数设置", "main.xml");
    ui.layout("其他说明", "main2.xml");
    ui.logd("设置UI结果: " + set);
    ui.showCtrlWindow()
    // 这里最好用延时，因为showCtrlWindow是异步的，防止没效果
    ui.run(1000, function () {
        //移出对应的视图
        //关闭悬浮框按钮
        ui.removeCtrlView("log_close_ctrl")
        //回主页按钮
        ui.removeCtrlView("main_page_ctrl")
        //脚本启停按钮
        ui.removeCtrlView("script_status_ctrl")
        //日志框按钮
        ui.removeCtrlView("log_window_ctrl")
        //退出脚本按钮
        ui.removeCtrlView("system_power_ctrl")
        //加入新的按钮
        ui.addCtrlView("tag", "res/a.png", 32, 32, 0, function (v) {
            logd(v);
            //启动脚本
            ui.start();
        })
    })
    ui.run(3000, function () {
        //移出所有控制视图
        ui.removeAllCtrlView()
    })
    ui.run(5000, function () {
        //重置
        ui.resetDefaultCtrlView()
    })
}

main();

删除所有启停浮窗按钮 removeAllCtrlView​

  • 删除所有启停浮窗按钮
  • 适用版本(EC 6.0.0+)
  • @return 布尔型 true代表成功，false代表失败
function main() {
    ui.toast("我是ui的Toast函数");
    var set = ui.layout("参数设置", "main.xml");
    ui.layout("其他说明", "main2.xml");
    ui.logd("设置UI结果: " + set);
    ui.showCtrlWindow()
    // 这里最好用延时，因为showCtrlWindow是异步的，防止没效果
    ui.run(1000, function () {
        //移出对应的视图
        //关闭悬浮框按钮
        ui.removeCtrlView("log_close_ctrl")
        //回主页按钮
        ui.removeCtrlView("main_page_ctrl")
        //脚本启停按钮
        ui.removeCtrlView("script_status_ctrl")
        //日志框按钮
        ui.removeCtrlView("log_window_ctrl")
        //退出脚本按钮
        ui.removeCtrlView("system_power_ctrl")
        //加入新的按钮
        ui.addCtrlView("tag", "res/a.png", 32, 32, 0, function (v) {
            logd(v);
            //启动脚本
            ui.start();
        })
    })
    ui.run(3000, function () {
        //移出所有控制视图
        ui.removeAllCtrlView()
    })
    ui.run(5000, function () {
        //重置
        ui.resetDefaultCtrlView()
    })
}

main();

重置启停浮窗按钮 resetDefaultCtrlView​

  • 重置启停浮窗按钮
  • 适用版本(EC 6.0.0+)
  • @return 布尔型 true代表成功，false代表失败
function main() {
    ui.toast("我是ui的Toast函数");
    var set = ui.layout("参数设置", "main.xml");
    ui.layout("其他说明", "main2.xml");
    ui.logd("设置UI结果: " + set);
    ui.showCtrlWindow()
    // 这里最好用延时，因为showCtrlWindow是异步的，防止没效果
    ui.run(1000, function () {
        //移出对应的视图
        //关闭悬浮框按钮
        ui.removeCtrlView("log_close_ctrl")
        //回主页按钮
        ui.removeCtrlView("main_page_ctrl")
        //脚本启停按钮
        ui.removeCtrlView("script_status_ctrl")
        //日志框按钮
        ui.removeCtrlView("log_window_ctrl")
        //退出脚本按钮
        ui.removeCtrlView("system_power_ctrl")
        //加入新的按钮
        ui.addCtrlView("tag", "res/a.png", 32, 32, 0, function (v) {
            logd(v);
            //启动脚本
            ui.start();
        })
    })
    ui.run(3000, function () {
        //移出所有控制视图
        ui.removeAllCtrlView()
    })
    ui.run(5000, function () {
        //重置
        ui.resetDefaultCtrlView()
    })
}

main();

展示日志浮窗 showLogWindow​

  • 显示日志浮窗
  • @return 布尔型 true代表成功，false代表失败
function main() {
    var r = ui.hasFloatViewPermission();
    ui.logd("是否有浮窗权限:" + r)
    if (!r) {
        return
    }
    //展示浮窗
    ui.showLogWindow();
    ui.logd("显示消息")
    //3秒后在UI线程消失掉
    ui.getHandler().postDelayed(function () {
        ui.closeLogWindow();
    }, 3000);
}

main();

关闭日志浮窗 closeLogWindow​

  • 关闭日志浮窗
  • @return 布尔型 true代表成功，false代表失败
function main() {
    var r = ui.hasFloatViewPermission();
    ui.logd("是否有浮窗权限:" + r)
    if (!r) {
        return
    }
    //展示浮窗
    ui.showLogWindow();
    ui.logd("显示消息")
    //3秒后在UI线程消失掉
    ui.getHandler().postDelayed(function () {
        ui.closeLogWindow();
    }, 3000);
}

main();

显示脚本暂停控制悬浮窗 showScriptCtrlFloatView​

  • 显示脚本暂停控制悬浮窗
  • 适配EC 10.0.0+
function main() {
    var r = ui.hasFloatViewPermission();
    ui.logd("是否有浮窗权限:" + r)
    if (!r) {
        return
    }
    //展示浮窗
    ui.showScriptCtrlFloatView();
    //3秒后在UI线程消失掉
    ui.getHandler().postDelayed(function () {
        ui.closeScriptCtrlFloatView();
    }, 3000);
}

main();

关闭脚本暂停控制悬浮窗 closeScriptCtrlFloatView​

  • 关闭脚本暂停控制悬浮窗
  • 适配EC 10.0.0+
function main() {
    var r = ui.hasFloatViewPermission();
    ui.logd("是否有浮窗权限:" + r)
    if (!r) {
        return
    }
    //展示浮窗
    ui.showScriptCtrlFloatView();
    //3秒后在UI线程消失掉
    ui.getHandler().postDelayed(function () {
        ui.closeScriptCtrlFloatView();
    }, 3000);
}

main();

脚本启动​

是否是无障碍模式 isAccMode​

  • 是否是无障碍运行模式
  • @return 布尔型 true 是 false 否
function main() {
    ui.logd("无障碍模式: " + ui.isAccMode());
    ui.logd("代理模式: " + ui.isAgentMode());

    // 设置运行模式
    ui.setRunningMode(1);

    ui.logd("无障碍模式: " + ui.isAccMode());
    ui.logd("代理模式: " + ui.isAgentMode());
}

main();

是否是代理模式 isAgentMode​

  • 是否是代理运行模式
  • @return 布尔型 true 是 false 否
function main() {
    ui.logd("无障碍模式: " + ui.isAccMode());
    ui.logd("代理模式: " + ui.isAgentMode());

    // 设置运行模式
    ui.setRunningMode(1);

    ui.logd("无障碍模式: " + ui.isAccMode());
    ui.logd("代理模式: " + ui.isAgentMode());
}

main();

自动化服务是否正常 isServiceOk​

  • 自动化服务是否正常
  • @return 布尔型 true 是 false 否
function main() {
    ui.logd("无障碍模式: " + ui.isAccMode());
    ui.logd("代理模式: " + ui.isAgentMode());

    // 设置运行模式
    ui.setRunningMode(1);

    ui.logd("无障碍模式: " + ui.isAccMode());
    ui.logd("代理模式: " + ui.isAgentMode());


    var ok = ui.isServiceOk();
    if (!ok) {
        ui.startEnvAsync(function (r) {
            ui.logd("启动环境结果: " + r);

        });
    }
}

main();

设置运行模式 setRunningMode​

  • 设置运行模式
  • @param mode 1 代表是代理模式 2 代表无障碍模式
  • @return 布尔型 true 是 false 否
function main() {
    ui.logd("无障碍模式: " + ui.isAccMode());
    ui.logd("代理模式: " + ui.isAgentMode());

    // 设置运行模式
    ui.setRunningMode(1);

    ui.logd("无障碍模式: " + ui.isAccMode());
    ui.logd("代理模式: " + ui.isAgentMode());
}

main();

异步启动自动化环境 startEnvAsync​

  • 启动环境
  • @return 布尔型 true代表启动成功，false代表启动失败
function main() {
    var ok = ui.isServiceOk();
    if (!ok) {
        ui.startEnvAsync(function (r) {
            ui.logd("启动环境结果: " + r);
        });
    }
}

main();

启动脚本 start​

  • 启动脚本
  • @return 布尔型 true代表启动成功，false代表启动失败
function main() {
    ui.layout("参数设置", "main.xml");
//xml中有个tag=startBtn的按钮
//启动脚本按钮
    ui.setEvent(ui.startBtn, "click", function (view) {
        ui.start();
    });
}

main();

停止脚本 stopTask​

  • 停止脚本
  • @return 布尔型 true代表启动成功，false代表启动失败
function main() {
    ui.layout("参数设置", "main.xml");
    //xml中有个tag=stopBtn的按钮
    //启动脚本按钮
    ui.setEvent(ui.stopBtn, "click", function (view) {
        ui.stopTask();
    });
}

main();

设置脚本暂停或者继续 setScriptPause​

  • 设置脚本暂停或者继续
  • 适配 EC 10.0.0+
  • @param pause true 代表暂停脚本，false代表继续
  • @param timeout 自动恢复时间单位毫秒，0 代表不自动恢复，等待外部交互后恢复，大于0代表到了时间自动恢复运行
  • @return {boolean} true 代表脚本处于暂停中，false 代表继续运行中
function main() {
    ui.layout("参数设置", "main.xml");
    //xml中有个tag=stopBtn的按钮
    //启动脚本按钮
    ui.setEvent(ui.cbtn, "click", function (view) {
        ui.setScriptPause(true, 0);
    });
}

main();

脚本是否处于暂停中 isScriptPause​

  • 脚本是否处于暂停中
  • 适配 EC 10.0.0+
  • @return {boolean} true 代表脚本处于暂停中
function main() {
    ui.layout("参数设置", "main.xml");
    //启动脚本按钮
    ui.setEvent(ui.cBtn, "click", function (view) {
        // 如果是暂停 点下就是继续，如果是继续 点下就是暂停
        // 这里是演示
        ui.setScriptPause(!ui.isScriptPause(), 0);
    });
}

main();

脚本是否运行 isScriptRunning​

  • 脚本是否运行
  • @return 布尔型 true代表启动成功，false代表启动失败
function main() {
    ui.layout("参数设置", "main.xml");
    //xml中有个tag=startBtn的按钮
    logd("运行状态 -{}", ui.isScriptRunning())
}

main();

定时任务​

开启定时任务 startJob​

  • 开启一个定时脚本任务
  • @param tag 任务的唯一标示，不能为空，脚本中可以使用readConfigString("jobTaskTag")获取当前tag值，判断是那个任务过来执行的
  • @param execTime 定时时间格式: 2020-04-17 19:20:00，或者直接是秒数字，例如 3，代表3秒后
  • @param cancelBeforeRunning
  • @return 整型 jobid
function main() {
    var set = ui.layout("参数设置", "main.xml");
    //按照日志定时的任务
    var time = "2020-05-15 15:47:00";
    var tag = "job1";
    var jobid = ui.startJob(tag, time, true);
    ui.logd("按照日志定时的任务:" + jobid)

    //按照多少秒执行
    var time2 = "10";
    var tag2 = "job2";
    var jobid2 = ui.startJob(tag2, time2, false);
    ui.logd("按照多少秒执行:" + jobid2)

    var tags = ui.getAllJobTag();
    ui.logd("定时任务的标签:" + tags)

    //取消任务
    ui.cancelAllJob();
    //按照标签取消任务
    ui.cancelJob("job2");
}

main();

取消定时任务 cancelJob​

  • 取消指定标签的任务
  • @param tag 标签
  • @return 布尔型 true代表成功，false代表失败
function main() {
    var set = ui.layout("参数设置", "main.xml");
    //按照日志定时的任务
    var time = "2020-05-15 15:47:00";
    var tag = "job1";
    var jobid = ui.startJob(tag, time, true);
    ui.logd("按照日志定时的任务:" + jobid)

    //按照多少秒执行
    var time2 = "10";
    var tag2 = "job2";
    var jobid2 = ui.startJob(tag2, time2, false);
    ui.logd("按照多少秒执行:" + jobid2)

    var tags = ui.getAllJobTag();
    ui.logd("定时任务的标签:" + tags)

    //取消任务
    ui.cancelAllJob();
    //按照标签取消任务
    ui.cancelJob("job2");
}

main();

取消所有定时任务 cancelAllJob​

  • 取消所有的定时任务
  • @return 布尔型 true代表成功，false代表失败
function main() {
    var set = ui.layout("参数设置", "main.xml");
    //按照日志定时的任务
    var time = "2020-05-15 15:47:00";
    var tag = "job1";
    var jobid = ui.startJob(tag, time, true);
    ui.logd("按照日志定时的任务:" + jobid)

    //按照多少秒执行
    var time2 = "10";
    var tag2 = "job2";
    var jobid2 = ui.startJob(tag2, time2, false);
    ui.logd("按照多少秒执行:" + jobid2)

    var tags = ui.getAllJobTag();
    ui.logd("定时任务的标签:" + tags)

    //取消任务
    ui.cancelAllJob();
    //按照标签取消任务
    ui.cancelJob("job2");
}

main();

所有定时任务标签 getAllJobTag​

  • 获取所有定时任务TAG
  • @return JSON字符串
function main() {
    var set = ui.layout("参数设置", "main.xml");
    //按照日志定时的任务
    var time = "2020-05-15 15:47:00";
    var tag = "job1";
    var jobid = ui.startJob(tag, time, true);
    ui.logd("按照日志定时的任务:" + jobid)

    //按照多少秒执行
    var time2 = "10";
    var tag2 = "job2";
    var jobid2 = ui.startJob(tag2, time2, false);
    ui.logd("按照多少秒执行:" + jobid2)

    var tags = ui.getAllJobTag();
    ui.logd("定时任务的标签:" + tags)

    //取消任务
    ui.cancelAllJob();
    //按照标签取消任务
    ui.cancelJob("job2");
}

main();

其他扩展​

setWebViewType 切换webview内核函数​

  • 适用版本(EC 5.16.0+)
  • 设置加载网页的webview组件组件类型，默认是X5浏览器
  • @param type 1：系统自带的webview， 2：X5浏览器
  • @return 布尔型 true 代表成功，false 代表失败
// ui.js中的注入
function main() {
   ui.setWebViewType(2)
   ui.layout("main", "main.html");
}

main();

registeH5Function 向H5注入扩展函数​

  • 向网页中注入一个JS函数，H5可以调用该函数，以实现脚本和HTML的互通扩展
  • @param funcName 注入的函数名称
  • @param callback 回调 常见例子
  • @return 布尔型 true 代表成功，false 代表失败
// ui.js中的注入
function main() {
    //UI中进行注入新的扩展
    ui.registeH5Function("customFunction", function (data) {
        logd("h5 call-" + data);
        //返回给网页的数据
        return new Date().toString()
    })
    ui.layout("main", "main.html");
}

main();

网页中的调用

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<button onclick="test()">测试扩展函数</button>
<script>
    function test() {
        //调用ui.js注入进来的扩展
        let d = window.ec.call('customFunction', JSON.stringify({'action': 'android.settings.SETTINGS'}));
        console.log("ddd  " + d)
    }
</script>
</body>
</html>

unregisteH5Function 取消向网页中注入一个JS函数​

  • 取消向网页中注入一个JS函数
  • @param funcName 注入的函数名称
  • @return 布尔型 true 代表成功，false 代表失败
// ui.js中的注入
function main() {
    //UI中进行注入新的扩展
    ui.registeH5Function("customFunction", function (data) {
        logd("h5 call-" + data);
    })
    ui.layout("main", "main.html");

    ui.unregisteH5Function("customFunction");

}

main();

onActivityEvent 监听Activity 状态​

  • 监听UI所在的activity事件
  • @param eventType 事件类型，分别为：onResume：Activity恢复时， onPause: Activity暂停时， onStop：Activity停止时， onDestroy：Activity销毁时,onActivityResult: 跳转到启动地方返回时候，
  • @param callback 回调函数
function main() {
    //监听Activity的事件设置
    ui.onActivityEvent("onResume", function (eventType) {
        // 可以在这里判断服务是否正常
        ui.logd("activity onResume " + ui.isServiceOk());
    });

    ui.onActivityEvent("onPause", function (eventType) {
        ui.logd("activity onPause");
    });

    ui.onActivityEvent("onStop", function (eventType) {
        ui.logd("activity onStop");
    });
    ui.onActivityEvent("onDestroy", function (eventType) {
        ui.logd("activity onDestroy");
    });


    //  参数请看Android的
    // protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) 函数
    ui.onActivityEvent("onActivityResult", function (requestCode, resultCode, data) {
        ui.logd("activity onDestroy");
    });
}

main();

getActivity UI对应的Activity​

  • 取得当前的activity对象
  • @return Activity 对象或者null
function main() {
    var activity = ui.getActivity();
    ui.logd("activity " + activity);
    //android context对象也是自带的
    importPackage(android.widget);
    importPackage(android.graphics);
    //直接使用java对象
    var tv = new android.widget.TextView(context);
    tv.setText("我是js和java交互的文本对象");
    tv.setTextColor(Color.parseColor("#888888"))
    activity.setContentView(tv);
}

main();

getHandler 原生的Handler​

  • 取得当前的Handler对象
  • @return Handler 对象或者null
function main() {
    //展示浮窗
    ui.showLogWindow();
    ui.logd("显示消息")
    //3秒后在UI线程消失掉
    ui.getHandler().postDelayed(function () {
        ui.closeLogWindow();
    }, 3000);
}

main();

run UI线程异步任务​

  • 在主线程进行运行函数，相当于 getHandler.post
  • @param delayTime 延迟时间，单位毫秒，如果是0就是理解执行
  • @param callback 回调
function main() {
    ui.run(30, function () {
        logd("Fsdfsd");
    })
    sleep(1000)
}

main();

setECSystemConfig 设置EC的系统参数​

  • 设置EC的系统参数
  • @param params map形式例如 {"running_mode":"无障碍"}
{
  "running_mode": "无障碍",
  "auto_start_service": "是",
  "volume_start_tc": "否",
  "log_float_window": "否",
  "ctrl_float_window": "否",
  "service_start_run_script": "否"
}
  • 参数解释有：
  • running_mode : 值有 无障碍，代理两种
  • auto_start_service : 开机启动服务 值有 是，否 两种
  • log_float_window : 日志悬浮窗展示 值有 是，否 两种
  • ctrl_float_window : 启停控制悬浮窗展示 值有 是，否 两种
  • service_start_run_script : 服务被重启后自动重新运行 值有 是，否 两种
  • home_key_start_stop : 三击HOME启停脚本 值有 是，否 两种
  • @return 布尔型 true 是 false 否
function main() {
    var m = {
        "running_mode": "无障碍",
        "auto_start_service": "是",
        "log_float_window": "否",
        "ctrl_float_window": "否"
    };
    ui.setECSystemConfig(m);
}

main();

openECSystemSetting 打开EC系统设置​

  • 打开EC的系统设置
  • @return 布尔型 true代表成功 false代表失败
function main() {
    ui.openECSystemSetting();
}

main();

openActivity 打开其他应用程序​

  • 打开一个activity，通过map参数
  • @param map 例如 {"action":""},key的固定只有
  • action,
  • uri,pkg,className,flag,其他的都是参数了
  • @return 布尔型 true 代表成功，false 代表失败
function main() {
    //打开安装包界面
    var m = {
        "action": "android.intent.action.VIEW",
        "uri": "file:///sdcard/a.apk",
        "type": "application/vnd.android.package-archive"
    };
    var x = ui.openActivity(m);
    ui.logd("x " + x);

    var map = {
        "uri": "xx://xx/live/6701887916223941379",
    };
    ui.openActivity(map);
}

main();