IME Functions

Overview

IME functions use the keyboard built into EasyClick Cloud Test, 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, on the keyboard screen tap the keyboard name and select [Allow Full Access]
When an input field is focused, the keyboard appears. If multiple keyboards are installed, tap the [Globe] button at the bottom-left to switch to EasyClick Cloud Test
Once the [EasyClick Cloud Test (goose-yellow background)] keyboard is visible, the functions are ready to use
Important: functions only work 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 to the system keyboard automatically ***

imeApi.isOk Check IME Status

Whether the IME is available
Available in EC iOS standalone 3.15.0+
@return {boolean} true if available, false if not

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 an input 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
Available in EC iOS standalone 3.15.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 an input 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("sample data")
9
    logd("Input field data: " + result)
10
}
11

12
main();

imeApi.paste Paste String

Paste a string — copy to clipboard, then insert into the input field
Available in EC iOS standalone 3.15.0+
@param content string; if empty, uses clipboard data directly
@returns {string} empty on failure; non-empty on success (returns the inserted 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 an input 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("paste data")
9
    logd("Pasted data in input field: " + result)
10
}
11

12
main();

imeApi.pressDel Delete Input Field Text

Delete text in the input field
Available in EC iOS standalone 3.15.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 an input 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 data in input field: " + result)
10
}
11

12
main();

imeApi.pressEnter Enter Key

Press Enter
Available in EC iOS standalone 3.15.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 an input 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
Available in EC iOS standalone 3.15.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 an input 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
Available in EC iOS standalone 3.15.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 an input 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
Waits 2 seconds after returning before switching
Available in EC iOS standalone 3.15.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 an input 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
Available in EC iOS standalone 3.15.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 an input 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
Available in EC iOS standalone 3.15.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 an input 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
Available in EC iOS standalone 3.15.0+
@param content string
@param type 1 = plain string, 2 = 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 an input 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("clipboard data","1")
9
    logd("setClipboard : " + result)
10
}
11

12
main();

imeApi.openUrl Open URL

Open a URL
Available in 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 an input 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
Available in 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 an input 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();