Skip to main content

Proxy Events

Overview​

  • All proxy event module functions require PC activation; no root needed
  • The proxy event module uses the agentEvent prefix, e.g. agentEvent.clickPoint()
  • Functions listed here are specific to proxy mode; use global functions for other calls

Settings​

setAgentCallParam Set Proxy Global Communication Timeout​

  • Set proxy mode parameters
  • Requires EC 7.0.0+
  • @param data Parameter map
  • Example: {"remoteCallTimeout":10000}
  • remoteCallTimeout: Remote call timeout in milliseconds; default 10 seconds
  • @return {bool} true on success, false on failure
function main() {
 var result = agentEvent.setAgentCallParam({"remoteCallTimeout": 10000});
 if (result) {
 toast("yes");
 } else {
 toast("no");
 }
}

main();

Input​

setCurrentIme Set Current Input Method​

  • Set the current IME for text input
  • @return {boolean}
function main() {
 var result = agentEvent.setCurrentIme();
 if (result) {
 toast("yes");
 } else {
 toast("no");
 }
}

main();

restoreIme Restore Previous Input Method​

  • Restore the previous IME
  • @return {boolean}
function main() {
 var result = agentEvent.restoreIme();
 if (result) {
 toast("yes");
 } else {
 toast("no");
 }
}

main();

Screenshot​

fastScreenshot Fast Full-Screen Screenshot​

  • Capture a fast full-screen screenshot
  • @param filename File path
  • @return string Path to the screenshot
function main() {
 var result = agentEvent.fastScreenshot("/sdcard/a.jpg");
 toast("result:" + result);
}

main();

Gestures and Input Events​

inputEvent Execute Input Event​

  • Execute an input event
  • @param action Action; see MotionEvent.ACTION_*
  • @param x X coordinate
  • @param y Y coordinate
  • @param metaState Modifier keys such as shift, alt, ctrl; 0 or 1
  • @return boolean true on success, false on failure
function main() {
 var result = agentEvent.inputEvent(1, 10, 10, 0);
 if (result) {
 toast("success");
 } else {
 toast("failed");
 }
}

main();

touchDown Touch Down​

  • Execute touch-down input event
  • @param x X coordinate
  • @param y Y coordinate
  • @return boolean true on success, false on failure
function main() {
 // Must be used together; alone it has no effect
 // Touch down
 agentEvent.touchDown(100, 100)
 sleep(50)
 // Move
 agentEvent.touchMove(100, 150)
 sleep(50)
 // Move
 agentEvent.touchMove(100, 200)
 sleep(50)
 // Touch up
 agentEvent.touchUp(100, 200)
 sleep(200)
}

main();

touchMove Touch Move​

  • Execute touch-move input event
  • @param x X coordinate
  • @param y Y coordinate
  • @return boolean true on success, false on failure
function main() {
 // Must be used together; alone it has no effect
 // Touch down
 agentEvent.touchDown(100, 100)
 sleep(50)
 // Move
 agentEvent.touchMove(100, 150)
 sleep(50)
 // Move
 agentEvent.touchMove(100, 200)
 sleep(50)
 // Touch up
 agentEvent.touchUp(100, 200)
 sleep(200)
}

main();

touchUp Touch Up​

  • Execute touch-up input event
  • @param x X coordinate
  • @param y Y coordinate
  • @return boolean true on success, false on failure
function main() {
 // Must be used together; alone it has no effect
 // Touch down
 agentEvent.touchDown(100, 100)
 sleep(50)
 // Move
 agentEvent.touchMove(100, 150)
 sleep(50)
 // Move
 agentEvent.touchMove(100, 200)
 sleep(50)
 // Touch up
 agentEvent.touchUp(100, 200)
 sleep(200)
}

main();

pressKey Simulate Key Press​

  • Simulate a key press, e.g. home, back
  • @param key Values: home, back, left, right, up, down, center, menu, search, enter, delete (or del), recent (recent apps), volume_up, volume_down, volume_mute, camera, power
  • @return boolean true on success, false on failure
function main() {
 var result = agentEvent.pressKey("home");
 if (result) {
 toast("success");
 } else {
 toast("failed");
 }
}

main();

pressKeyCode Simulate Keyboard Input​

  • Simulate keyboard input
  • @param keyCode Key code; see KeyEvent.KEYCODE_*
  • @return boolean true on success, false on failure
function main() {
 var result = agentEvent.pressKeyCode(65);
 if (result) {
 toast("success");
 } else {
 toast("failed");
 }
}

main();

pressKeyCodeWithMetaState Simulate Keyboard Input with Meta State​

  • Simulate keyboard input with modifier keys
  • @param keyCode Key code; see KeyEvent.KEYCODE_*
  • @param metaState Modifier keys such as shift, alt, ctrl; 0 or 1
  • @return boolean true on success, false on failure
function main() {
 var result = agentEvent.pressKeyCodeWithMetaState(65, 1);
 if (result) {
 toast("success");
 } else {
 toast("failed");
 }
}

main();

System Keys​

  • Open the menu
  • @return {null|boolean}
function main() {
 var result = agentEvent.menu();
 if (result) {
 toast("success");
 } else {
 toast("failed");
 }
}

main();

enter Enter Key​

  • Enter key
  • @return {null|boolean}
function main() {
 var result = agentEvent.enter();
 if (result) {
 toast("success");
 } else {
 toast("failed");
 }
}

main();

delete Delete Key​

  • Delete key
  • @return {null|boolean}
function main() {
 var result = agentEvent.delete();
 if (result) {
 toast("success");
 } else {
 toast("failed");
 }
}

main();

search Search​

  • Search key
  • @return {null|boolean}
function main() {
 var result = agentEvent.search();
 if (result) {
 toast("success");
 } else {
 toast("failed");
 }
}

main();

Screen Control​

closeScreen Turn Screen Off​

  • Turn off the screen (display off but automation still works; unlike sleepScreen)
  • @return boolean true on success, false on failure
function main() {
 // If this function does not work, download another plugin from the forum
 // https://bbs.ieasyclick.com/thread-617-1-1.html
 var x = agentEvent.closeScreen();
}

main();

lightScreen Turn Screen On​

  • Turn on the screen (opposite of closeScreen)
  • @return boolean true on success, false on failure
function main() {
 var x = agentEvent.lightScreen();
 // If this function has no effect, force wake the screen with:
 // agentEvent.execShellCommandEx("input keyevent 26 && input keyevent 82 && input keyevent 82")
}

main();