IME Functions

Overview

IME functions are provided by the EasyClick Cloud Test built-in keyboard, designed specifically for text input
Enable the IME before use:
Go to Settings > General > Keyboard > Keyboards > Add New Keyboard and enable the [packaged app name (default: EasyClick Cloud Test; custom name after packaging)] keyboard. If you cannot find it, restart the device
After setup, tap the keyboard name on the keyboard screen and select [Allow Full Access]
Once enabled, the keyboard appears when a text field is focused. If multiple keyboards are available, tap the [Globe] button at the bottom-left to switch to EasyClick Cloud Test
When the [EasyClick Cloud Test (goose-yellow background)] keyboard is visible, the functions are ready to use
Important: functions work only when the EasyClick Cloud Test keyboard is shown; otherwise they have no effect. Use imeApi.isOk() to check whether the IME is ready
The IME can fully replace previous input functions and avoids freezing the proxy app
***Not suitable for: password fields and fields that disallow third-party keyboards — iOS will switch back to the system keyboard automatically ***

imeApi.isOk Check IME Status

Check whether the IME is available
Supported EC iOS USB 6.37.0+
@return {boolean} true if available, false otherwise

1
function main() {
2
    var ok = imeApi.isOk();
3
    if (!ok) {
4
        logw("IME unavailable. Go to Settings > General > Keyboard and enable the [packaged app name (default: EasyClick Cloud Test)] third-party keyboard. If the option is missing, restart the device")
5
        logw("After enabling, tap a text field and show the [packaged app name (default: EasyClick Cloud Test, goose-yellow background)] keyboard before using these functions")
6
        return
7
    }
8
    logd("IME is ready")
9
}
10

11
main();

imeApi.input Input String

Input a string
Supported EC iOS USB 6.37.0+
@param content string
@returns {string} empty if input failed; non-empty if input succeeded (returns the entered data)

1
function main() {
2
    var ok = imeApi.isOk();
3
    if (!ok) {
4
        logw("IME unavailable. Go to Settings > General > Keyboard and enable the [packaged app name (default: EasyClick Cloud Test)] third-party keyboard. If the option is missing, restart the device")
5
        logw("After enabling, tap a text field and show the [packaged app name (default: EasyClick Cloud Test, goose-yellow background)] keyboard before using these functions")
6
        return
7
    }
8
    let result = imeApi.input("我是数据")
9
    logd("Text field data: " + result)
10
}
11

12
main();

imeApi.paste Paste String

Paste a string — copy to clipboard first, then insert into the text field
Supported EC iOS USB 6.37.0+
@param content string; if empty, uses clipboard data directly
@returns {string} empty if failed; non-empty if succeeded (returns the pasted data)

1
function main() {
2
    var ok = imeApi.isOk();
3
    if (!ok) {
4
        logw("IME unavailable. Go to Settings > General > Keyboard and enable the [packaged app name (default: EasyClick Cloud Test)] third-party keyboard. If the option is missing, restart the device")
5
        logw("After enabling, tap a text field and show the [packaged app name (default: EasyClick Cloud Test, goose-yellow background)] keyboard before using these functions")
6
        return
7
    }
8
    let result = imeApi.paste("我是粘贴数据")
9
    logd("Pasted text field data: " + result)
10
}
11

12
main();

imeApi.pressDel Delete Text in Input Field

Delete text in the input field
Supported EC iOS USB 6.37.0+
@returns {string} empty if the field has no data; non-empty if data remains

1
function main() {
2
    var ok = imeApi.isOk();
3
    if (!ok) {
4
        logw("IME unavailable. Go to Settings > General > Keyboard and enable the [packaged app name (default: EasyClick Cloud Test)] third-party keyboard. If the option is missing, restart the device")
5
        logw("After enabling, tap a text field and show the [packaged app name (default: EasyClick Cloud Test, goose-yellow background)] keyboard before using these functions")
6
        return
7
    }
8
    let result = imeApi.pressDel()
9
    logd("Remaining text field data: " + result)
10
}
11

12
main();

imeApi.pressEnter Press Enter Key

Press the Enter key
Supported EC iOS USB 6.37.0+
@returns {boolean} true on success, false on failure

1
function main() {
2
    var ok = imeApi.isOk();
3
    if (!ok) {
4
        logw("IME unavailable. Go to Settings > General > Keyboard and enable the [packaged app name (default: EasyClick Cloud Test)] third-party keyboard. If the option is missing, restart the device")
5
        logw("After enabling, tap a text field and show the [packaged app name (default: EasyClick Cloud Test, goose-yellow background)] keyboard before using these functions")
6
        return
7
    }
8
    let result = imeApi.pressEnter()
9
    logd("pressEnter: " + result)
10
}
11

12
main();

imeApi.dismiss Hide Keyboard

Hide the keyboard
Supported EC iOS USB 6.37.0+
@returns {boolean} true on success, false on failure

1
function main() {
2
    var ok = imeApi.isOk();
3
    if (!ok) {
4
        logw("IME unavailable. Go to Settings > General > Keyboard and enable the [packaged app name (default: EasyClick Cloud Test)] third-party keyboard. If the option is missing, restart the device")
5
        logw("After enabling, tap a text field and show the [packaged app name (default: EasyClick Cloud Test, goose-yellow background)] keyboard before using these functions")
6
        return
7
    }
8
    let result = imeApi.dismiss()
9
    logd("dismiss: " + result)
10

11
}
12

13
main();

imeApi.copyToClipboard Copy Input Field Data to Clipboard

Copy input field data to the clipboard
Supported EC iOS USB 6.37.0+
@returns {string} empty if the field has no data; non-empty if data was copied to the clipboard

1
function main() {
2
    var ok = imeApi.isOk();
3
    if (!ok) {
4
        logw("IME unavailable. Go to Settings > General > Keyboard and enable the [packaged app name (default: EasyClick Cloud Test)] third-party keyboard. If the option is missing, restart the device")
5
        logw("After enabling, tap a text field and show the [packaged app name (default: EasyClick Cloud Test, goose-yellow background)] keyboard before using these functions")
6
        return
7
    }
8
    let result = imeApi.copyToClipboard()
9
    logd("copyToClipboard data: " + result)
10
}
11

12
main();

imeApi.changeKeyboard Switch to Another Keyboard

Switch to another keyboard
Returns first, then switches after a 2-second wait
Supported EC iOS USB 6.37.0+
@returns {boolean} true on success, false on failure

1
function main() {
2
    var ok = imeApi.isOk();
3
    if (!ok) {
4
        logw("IME unavailable. Go to Settings > General > Keyboard and enable the [packaged app name (default: EasyClick Cloud Test)] third-party keyboard. If the option is missing, restart the device")
5
        logw("After enabling, tap a text field and show the [packaged app name (default: EasyClick Cloud Test, goose-yellow background)] keyboard before using these functions")
6
        return
7
    }
8
    let result = imeApi.changeKeyboard()
9
    logd("changeKeyboard data: " + result)
10
}
11

12
main();

imeApi.removeAllContent Clear Input Field

Clear all content in the input field
Supported EC iOS USB 6.37.0+
@returns {boolean} true on success, false on failure

1
function main() {
2
    var ok = imeApi.isOk();
3
    if (!ok) {
4
        logw("IME unavailable. Go to Settings > General > Keyboard and enable the [packaged app name (default: EasyClick Cloud Test)] third-party keyboard. If the option is missing, restart the device")
5
        logw("After enabling, tap a text field and show the [packaged app name (default: EasyClick Cloud Test, goose-yellow background)] keyboard before using these functions")
6
        return
7
    }
8
    let result = imeApi.removeAllContent()
9
    logd("removeAllContent : " + result)
10
}
11

12
main();

imeApi.getClipboard Read Clipboard Data

Read clipboard data
Supported EC iOS USB 6.37.0+
@returns {string} clipboard data

1
function main() {
2
    var ok = imeApi.isOk();
3
    if (!ok) {
4
        logw("IME unavailable. Go to Settings > General > Keyboard and enable the [packaged app name (default: EasyClick Cloud Test)] third-party keyboard. If the option is missing, restart the device")
5
        logw("After enabling, tap a text field and show the [packaged app name (default: EasyClick Cloud Test, goose-yellow background)] keyboard before using these functions")
6
        return
7
    }
8
    let result = imeApi.getClipboard()
9
    logd("getClipboard data : " + result)
10
}
11

12
main();

imeApi.setClipboard Set Clipboard Data

Set clipboard data
Supported EC iOS standalone 3.15.0+
@param content string
@param type 1 for plain string, 2 for URL data
@returns {boolean} true on success, false on failure

1
function main() {
2
    var ok = imeApi.isOk();
3
    if (!ok) {
4
        logw("IME unavailable. Go to Settings > General > Keyboard and enable the [packaged app name (default: EasyClick Cloud Test)] third-party keyboard. If the option is missing, restart the device")
5
        logw("After enabling, tap a text field and show the [packaged app name (default: EasyClick Cloud Test, goose-yellow background)] keyboard before using these functions")
6
        return
7
    }
8
    let result = imeApi.setClipboard("我是剪切板的的数据","1")
9
    logd("setClipboard : " + result)
10
}
11

12
main();

imeApi.openUrl Open URL Link

Open a URL link
Supported EC iOS standalone 3.15.0+
@param url URL address, e.g. http://baidu.com
@returns {boolean} true on success, false on failure

1
function main() {
2
    var ok = imeApi.isOk();
3
    if (!ok) {
4
        logw("IME unavailable. Go to Settings > General > Keyboard and enable the [packaged app name (default: EasyClick Cloud Test)] third-party keyboard. If the option is missing, restart the device")
5
        logw("After enabling, tap a text field and show the [packaged app name (default: EasyClick Cloud Test, goose-yellow background)] keyboard before using these functions")
6
        return
7
    }
8
    let result = imeApi.openUrl("http://baidu.com")
9
    logd("openUrl : " + result)
10
}
11

12
main();

imeApi.getText Get Input Field Data

Get input field data
Supported EC iOS standalone 3.15.0+
@returns {string} empty if no data or not retrieved; non-empty if data was retrieved

1
function main() {
2
    var ok = imeApi.isOk();
3
    if (!ok) {
4
        logw("IME unavailable. Go to Settings > General > Keyboard and enable the [packaged app name (default: EasyClick Cloud Test)] third-party keyboard. If the option is missing, restart the device")
5
        logw("After enabling, tap a text field and show the [packaged app name (default: EasyClick Cloud Test, goose-yellow background)] keyboard before using these functions")
6
        return
7
    }
8
    let result = imeApi.getText()
9
    logd("getText : " + result)
10
}
11

12
main();

imeApi.forwardImeServer Forward Input Method Service

Forward the input method service
Supported EC iOS USB 9.20.0+
This avoids enabling the proxy service; if forwarding is used, the proxy service must be enabled for forwarding
@returns {string} null or empty on success; otherwise an error message

1
function testImeServer() {
2
    imeApi.closeForwardImeServer()
3
    let forward = imeApi.forwardImeServer();
4
    if (forward == null) {
5
        console.log("Input method forwarding succeeded; proxy service is not required")
6
    } else {
7
        logw("Forward failed")
8
        return
9
    }
10
    sleep(1000)
11
    let ok = imeApi.isOk()
12
    if (!ok) {
13
        logw("Input method not ready")
14
        return
15
    }
16

17
    let rr = imeApi.input("123")
18
    console.log("Input result: " + rr)
19
    logd(imeApi.paste("bgigm"))
20
}
21

22
testImeServer()

imeApi.closeForwardImeServer Close Input Method Forwarding

Close input method forwarding
Supported EC iOS USB 9.20.0+
@returns {string} null or empty on success; otherwise an error message

1
function testImeServer() {
2
    imeApi.closeForwardImeServer()
3
    let forward = imeApi.forwardImeServer();
4
    if (forward == null) {
5
        console.log("Input method forwarding succeeded; proxy service is not required")
6
    } else {
7
        logw("Forward failed")
8
        return
9
    }
10
    sleep(1000)
11
    let ok = imeApi.isOk()
12
    if (!ok) {
13
        logw("Input method not ready")
14
        return
15
    }
16

17
    let rr = imeApi.input("123")
18
    console.log("Input result: " + rr)
19
    logd(imeApi.paste("bgigm"))
20
}
21

22
testImeServer()