Native UI Customization

Overview

EasyClick uses WebView to support HTML-based UI and extends JS methods for controlling the EC program.
When creating a new project, you can choose a corresponding template; the Materialize template is recommended. Documentation: http://www.materializecss.cn
You can also write your own HTML pages; refer to the template for more JS method usage examples

Multi-Tab Support

Simply create a ui.js file in the project’s layout folder with the following content:

1
function main() {
2
    ui.layout("Parameter Settings", "main.html");
3
    ui.layout("Register & Use", "reg.html");
4
    ui.layout("Usage Instructions", "intr.html");
5
}
6

7
main();

How Scripts Interact with JS

Writing the XML View

Use WebView to load local main.html with tag=web
Note: You need both layout.attr.xsd and layout.xsd files — copy them manually from a native UI project’s layout folder into your current project’s layout folder

1
<?xml version="1.0" encoding="UTF-8" ?>
2
<LinearLayout
3
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4
        xmlns:android="http://schemas.android.com/apk/res/android"
5
        xsi:noNamespaceSchemaLocation="layout.xsd"
6
        android:layout_height="match_parent"
7
        android:layout_width="match_parent">
8
    <WebView android:layout_width="wrap_content"
9
              android:tag="web"
10
              android:layout_height="wrap_content"
11
              android:url="main.html"/>
12

13
</LinearLayout>

Loading XML

Load the XML view in ui.js

1
function main() {
2
    ui.layout("Parameter Settings", "main.xml");
3
}
4

5
main();

HTML Code

1
<!doctype html>
2
<html lang="en">
3
<head>
4
    <!-- Required meta tags -->
5
    <meta charset="utf-8">
6
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
7
</head>
8
<body style="margin-left: 10px;margin-right: 10px">
9
I am a test page
10
</body>
11
<script>
12
    // Exposed for WebView to call
13
    function myalert() {
14
        alert("fdsafsad");
15
        // Store data in memory for the script to read
16
        window.ec.putShareData("mymsg", "Temporary data from the web page");
17
    }
18

19
    // Exposed for WebView to call — with parameters
20
    function myalert(msg) {
21
        alert("I am msg " + msg);
22
    }
23
</script>
24
</html>

Calling from the Script

Call the view from the js/main.js script

1
function main() {
2
    // Reset variables
3
    ui.resetUIVar();
4
    // Read data stored in memory by the UI
5
    logd(ui.getShareData("mymsg"))
6
    logd(ui.web)
7
    // Use the view with tag=web in the UI
8
    if (ui.web) {
9
        // myalert is a method exposed in HTML
10
        // Execute JS methods in the web page
11
        ui.web.quickCallJs("myalert();");
12
        ui.web.quickCallJs("myalert('bbbbb');");
13
    }
14
}
15

16
main();

Browser Extension Methods

Browser extension methods are mainly used for interaction between web pages and the EC program; these methods can only be called from within web pages

Calling Custom Extensions

call — Call Extension Function

Call an extension function injected by the script or ui.js
@param funcName Name of the injected function
@param data Can be a plain string or a JSON string
@return {string} Data returned by the called extension function

1
// Injection in ui.js
2
function main() {
3
    // Inject a new extension in the UI
4
    ui.registeH5Function("customFunction", function (data) {
5
        logd("h5 call-" + data);
6
        // Data returned to the web page
7
        return new Date().toString()
8
    })
9
    ui.layout("main", "main.html");
10
}
11

12
main();

Calling from the web page

1
<!DOCTYPE html>
2
<html lang="en">
3
<head>
4
    <meta charset="UTF-8">
5
    <title>Title</title>
6
</head>
7
<body>
8
<button onclick="test()">Test Extension Function</button>
9
<script>
10
    function test() {
11
        // Call the extension injected by ui.js
12
        let d = window.ec.call('customFunction', JSON.stringify({'action': 'android.settings.SETTINGS'}));
13
        console.log("ddd " + d)
14
    }
15
</script>
16
</body>
17
</html>

Start Script

1
window.ec.start()

Stop Script

1
window.ec.stopTask()

setAgentSupportNode — Set Node Retrieval Mode in Agent Mode

Set the node retrieval mode in agent mode
This method only takes effect in agent mode
EC Android 11.2.0+
Call this method before starting the agent service; using 2 and 3 can reduce detection signatures
Mode 1 may trigger ruru detection of AccessibilityManager.isEnabled; modes 2 and others do not
Mode 1 has stronger node capabilities; mode 2 has weaker node features; mode 3 has no node functionality
@param support 1 — similar to accessibility service; 2 — shell dump; 3 — do not start node service
@return {boolean} true for success, false for failure

1
function main() {
2
  window.ec.setAgentSupportNode("2");
3
}
4

5
main();

Check if Script Is Running

1
window.ec.isScriptRunning()

Hide Start Button

1
window.ec.hideStartBtn()

Show Start Button

1
window.ec.displayStartBtn()

Get All Configuration as JSON String

1
var s = window.ec.getConfigJSON();
2
alert(s);

Get a Single Configuration String from Config File

1
var s = window.ec.getConfig("name");
2
alert(s);

Save a Single Configuration to Config File

1
var s = window.ec.saveConfig("name", "123");
2
alert(s);

Remove All UI Configuration

1
var s = window.ec.removeAllUIConfig();
2
alert(s);

Save Data to Storage Area

This data is stored in memory

1
window.ec.putShareData("name", "123");

Read Data from Storage Area

This data is stored in memory

1
var d = window.ec.getShareData("name");
2
alert(d);

Clear Storage Area Data

This data is stored in memory

1
var d = window.ec.clearAllShareData();
2
alert(d);

Open EC System Settings

1
window.ec.openECSystemSetting()

Save EC System Parameters

Set EC system parameters
@param params Map format, e.g. {"running_mode":"accessibility"},
“running_mode”:“accessibility”,
“auto_start_service”:“yes”,
“log_float_window”:“no”,
“ctrl_float_window”:“no”
“service_start_run_script”:“no”
Parameters:
running_mode: accessibility or agent (two options)
auto_start_service: start service on boot — values: yes (yes), no (no)
log_float_window: show log floating window — values: yes (yes), no (no)
ctrl_float_window: show start/stop control floating window — values: yes (yes), no (no)
service_start_run_script: auto re-run script when service restarts — values: yes (yes), no (no)
home_key_start_stop: triple-tap HOME to start/stop script — values: yes (yes), no (no)
@return Boolean — true or false

1
var m = {
2
 "running_mode": "accessibility",
3
 "auto_start_service": "yes",
4
 "log_float_window": "no",
5
 "ctrl_float_window": "no"
6
};
7
window.ec.setECSystemConfig(JSON.stringify(m));

Show Toast Message

1
window.ec.toast("I am a toast message");

Show Log Message Window

1
window.ec.showLogWindow();

Close Log Message Window

1
window.ec.closeLogWindow();

Show Log Message

1
window.ec.logd("I am a log message");

Show Start/Stop Control Window

1
window.ec.showCtrlWindow();

Close Start/Stop Control Window

1
window.ec.closeCtrlWindow();

Open Other Applications — openActivity

1
// Open browser to download test
2
var m = {
3
 "action": "android.intent.action.VIEW",
4
 "uri": "https://imtt.dd.qq.com/16891/apk/55259F8EF9824AF1BF80106B0E00BCD1.apk?"
5

6
};
7
var x = window.ec.openActivity(JSON.stringify(m));
8
window.ec.logd("x " + x);
9

10
var map = {
11
 "uri": "xx://xx/live/6701887916223941379",
12
};
13
window.ec.openActivity(JSON.stringify(map));

Service Status Control

Check if Accessibility Service Mode

1
var s = window.ec.isAccMode();
2
alert(s);

Check if Agent Service Mode

1
var s = window.ec.isAgentMode();
2
alert(s);

Check if Accessibility Service Is Started

1
var s = window.ec.isAccServiceOk();
2
alert(s);

Check if Agent Service Is Started

1
var s = window.ec.isAgentServiceOk();
2
alert(s);

Start Service Environment

1
var s = window.ec.startEnv();
2
alert(s);

Floating Window Control

Check Floating Window Permission

1
var s = window.ec.hasFloatViewPermission();
2
alert(s);

Request Floating Window Permission

1
// Parameter is timeout in seconds
2
var s = window.ec.requestFloatViewPermission(10);
3
alert(s);

Show Floating Window

1
var m = {
2
 "path": "main.html",
3
 "tag": "tag",
4
 "titleBg": "#888888",
5
 "x": 10,
6
 "y": 10,
7
 "w": 100,
8
 "h": 200
9
};
10
var xd = window.ec.showFloatView(JSON.stringify(m));
11
alert(xd);

Close Floating Window

1
var m = {
2
 "path": "main.html",
3
 "tag": "tag",
4
 "titleBg": "#888888",
5
 "x": 10,
6
 "y": 10,
7
 "w": 100,
8
 "h": 200
9
};
10
var xd = window.ec.showFloatView(JSON.stringify(m));
11
setTimeout(function () {
12
 window.ec.closeFloatView("tag");
13
}, 3000);
14
alert(xd);

Close All Floating Windows (Excluding Log Floating Window)

1
var m = {
2
 "path": "main.html",
3
 "tag": "tag",
4
 "titleBg": "#888888",
5
 "x": 10,
6
 "y": 10,
7
 "w": 100,
8
 "h": 200
9
};
10
var xd = window.ec.showFloatView(JSON.stringify(m));
11
setTimeout(function () {
12
 window.ec.closeAllFloatView();
13
}, 3000);
14
alert(xd);

Scheduled Tasks

Start a Scheduled Task

Start a scheduled script task
@param tag Unique task identifier (required); the script can use readConfigString(“jobTaskTag”) to get the current tag and determine which task triggered execution
@param execTime Scheduled time format: 2020-04-17 19:20:00, or seconds directly, e.g. 3 for 3 seconds later
@param cancelBeforeRunning
@return Integer jobid

1
var time = "2020-04-17 09:00:00";
2
var id = window.ec.startJob("task1", time, true);
3
alert("job id " + id);

Get All Scheduled Task TAGs

1
var t = window.ec.getAllJobTag();
2
alert("job tags " + t);

Cancel All Scheduled Tasks

1
var t = window.ec.cancelAllJob();
2
alert("job cancel " + t);

Cancel Scheduled Task by TAG

1
// Parameter task1 is the tag value used when creating the scheduled task
2
var t = window.ec.cancelJob("task1");
3
alert("job cancel " + t);