USB HID Events

Overview

All functions in the USB HID event module require activating USB HID with the EasyClick USB HID host program before they can be called
You can also activate USB HID with one click from the HarmonyOS Next control center (right-click menu “USB HID Control”)
The module object prefix is hidEvent, e.g. hidEvent.clickPoint
Different from Bluetooth BLE HID (bleEvent): USB HID uses a data cable/AOA; Bluetooth HID uses an ESP32 board

USB HID Functions

setHidCenter — Set USB HID Host Address

Set the USB HID host address
Supported: HarmonyOS Next USB edition 2.15.0+
@param hidCenterUrl URL where the USB HID host program is running
@return {string} null on success; otherwise an error message

1
function main() {
2
    // Usually not needed
3
    logd(hidEvent.setHidCenter("http://127.0.0.1:8988"))
4
}
5

6
main();

isUsbConnected — Check USB Connection

Check whether the device is connected via USB
Supported: HarmonyOS Next USB edition 2.15.0+
@return {boolean} true if the device is connected via USB

1
function main() {
2
    logd(hidEvent.isUsbConnected())
3
}
4

5
main();

simCloseUsbDebug — Simulate Disabling USB Debugging

Simulate disabling USB debugging
Supported: HarmonyOS Next USB edition 2.15.0+
@return {boolean} true on success, false on failure

1
function main() {
2
    // See activeHid — Initialize USB HID device
3
}
4

5
main();

simOpenUsbDebug — Simulate Enabling USB Debugging

Simulate enabling USB debugging
Supported: HarmonyOS Next USB edition 2.15.0+
@return {boolean} true on success, false on failure

1
function main() {
2
    // See activeHid — Initialize USB HID device
3
}
4

5
main();

connectByTcp — Switch to TCP Connection

Switch to a TCP connection
Supported: HarmonyOS Next USB edition 2.15.0+
@return {boolean} true on success, false on failure

1
function main() {
2
    // See activeHid — Initialize USB HID device
3
}
4

5
main();

clearHidStatus — Clear USB HID Connection State

Clear USB HID connection state
This function does not reset PID and VID
Supported: HarmonyOS Next USB edition 2.15.0+
@return {null|string} null on success; otherwise an error message

1
function main() {
2
    // See activeHid — Initialize USB HID device
3
}
4

5
main();

isHidStatus — Check USB HID Status

Check USB HID status
Supported: HarmonyOS Next USB edition 2.15.0+
@return {boolean} true on success, false on failure

1
function main() {
2
    // See activeHid — Initialize USB HID device
3
}
4

5
main();

activeHid — Initialize USB HID Device

Initialize the USB HID device
Supported: HarmonyOS Next USB edition 2.15.0+
@return {boolean} true on success, false on failure

1
function main() {
2

3
 let r = one_key_active_hid();
4
 console.log("--- one_key_active_hid {}", r)
5
 if (!r) {
6
 return;
7
 }
8

9

10
 let click = hidEvent.clickPoint(469, 1306)
11
 if (click == null) {
12
 console.log("Tap succeeded")
13
 } else {
14
 console.log("Tap failed")
15
 }
16

17

18
 // let openNotification = hidEvent.openNotification();
19
 // logd("Result: {}", openNotification)
20

21

22
}
23

24

25
function one_key_active_hid() {
26
 if (hidEvent.isHidStatus()) {
27
 logd("Already in USB HID mode, no need to activate")
28
 return true;
29
 }
30
 logd("Switching to TCP connection...")
31
 let toTcpResult = hidEvent.connectByTcp()
32
 if (toTcpResult) {
33
 logd("TCP switch succeeded, continuing USB HID activation...")
34
 } else {
35
 logw("TCP switch failed; USB HID activation may not work")
36
 }
37
 sleep(3000)
38
 if (hidEvent.isUsbConnected()) {
39
 console.log("Simulating USB debugging off... please wait")
40
 let close_debug_result = hidEvent.simCloseUsbDebug();
41
 console.log("close_debug_result {}", close_debug_result)
42
 if (close_debug_result) {
43
 console.log("USB debugging disabled successfully")
44
 sleep(3000)
45
 } else {
46
 logw("Failed to disable USB debugging")
47
 return;
48
 }
49
 }
50
 logd("Clearing previous USB HID records...")
51
 let clearResult = hidEvent.clearHidStatus()
52
 if (clearResult != null) {
53
 clearResult = hidEvent.clearHidStatus()
54
 if (clearResult != null) {
55
 logw("Clear failed --> USB HID host call failed: " + clearResult)
56
 return false;
57
 }
58
 }
59

60
 logd("USB HID records cleared; activating USB HID... connection may drop and reconnect automatically")
61

62

63
 let activeResult = hidEvent.activeHid();
64
 if (activeResult != null) {
65
 activeResult = hidEvent.activeHid()
66
 if (hidEvent.isHidStatus()) {
67
 return true
68
 } else {
69
 logw("Activation failed --> USB HID host call failed: " + activeResult)
70
 return false;
71
 }
72
 }
73
 sleep(2000)
74
 logd("USB HID activated successfully")
75
 let rs = hidEvent.isHidStatus();
76
 if (rs) {
77
 logd("Device is in USB HID mode")
78
 } else {
79
 logw("Device is not in USB HID mode")
80
 return false;
81
 }
82

83
 return true;
84

85

86
}
87

88
main()

closeDevice — Close USB HID Device

Close and reset the USB HID device
Resets PID and VID
Supported: HarmonyOS Next USB edition 2.15.0+
@return {null|string} null on success; otherwise an error message

1
function main() {
2
    let rr = hidEvent.closeDevice();
3
    if (rr == null) {
4
        logd("USB reset succeeded")
5
    } else {
6
        logd("USB reset failed: " + rr)
7
    }
8
}
9

10
main();

clickPoint — Tap Coordinates

Tap coordinates
Supported: HarmonyOS Next USB edition 2.15.0+
@param x x coordinate
@param y y coordinate
@return {null|string} null on success; otherwise an error message

1
function main() {
2

3
    let r = one_key_active_hid();
4
    console.log("--- one_key_active_hid {}", r)
5
    if (!r) {
6
        return;
7
    }
8
    let click = hidEvent.clickPoint(469, 1306)
9
    if (click == null) {
10
        console.log("Tap succeeded")
11
    } else {
12
        console.log("Tap failed {}", click)
13
    }
14
}
15

16

17
function one_key_active_hid() {
18
    if (hidEvent.isHidStatus()) {
19
        logd("Already in USB HID mode, no need to activate")
20
        return true;
21
    }
22
    logd("Switching to TCP connection...")
23
    let toTcpResult = hidEvent.connectByTcp()
24
    if (toTcpResult) {
25
        logd("TCP switch succeeded, continuing USB HID activation...")
26
    } else {
27
        logw("TCP switch failed; USB HID activation may not work")
28
    }
29
    sleep(3000)
30
    if (hidEvent.isUsbConnected()) {
31
        console.log("Simulating USB debugging off... please wait")
32
        let close_debug_result = hidEvent.simCloseUsbDebug();
33
        console.log("close_debug_result {}", close_debug_result)
34
        if (close_debug_result) {
35
            console.log("USB debugging disabled successfully")
36
            sleep(3000)
37
        } else {
38
            logw("Failed to disable USB debugging")
39
            return;
40
        }
41
    }
42
    logd("Clearing previous USB HID records...")
43
    let clearResult = hidEvent.clearHidStatus()
44
    if (clearResult != null) {
45
        clearResult = hidEvent.clearHidStatus()
46
        if (clearResult != null) {
47
            logw("Clear failed --> USB HID host call failed: " + clearResult)
48
            return false;
49
        }
50
    }
51

52
    logd("USB HID records cleared; activating USB HID... connection may drop and reconnect automatically")
53

54

55
    let activeResult = hidEvent.activeHid();
56
    if (activeResult != null) {
57
        activeResult = hidEvent.activeHid()
58
        if (hidEvent.isHidStatus()) {
59
            return true
60
        } else {
61
            logw("Activation failed --> USB HID host call failed: " + activeResult)
62
            return false;
63
        }
64
    }
65
    sleep(2000)
66
    logd("USB HID activated successfully")
67
    let rs = hidEvent.isHidStatus();
68
    if (rs) {
69
        logd("Device is in USB HID mode")
70
    } else {
71
        logw("Device is not in USB HID mode")
72
        return false;
73
    }
74

75
    return true;
76

77

78
}
79

80
main()

doubleClickPoint — Double-Tap Coordinates

Double-tap coordinates
Supported: HarmonyOS Next USB edition 2.15.0+
@param x x coordinate
@param y y coordinate
@return {null|string} null on success; otherwise an error message

1
function main() {
2

3
    let r = one_key_active_hid();
4
    console.log("--- one_key_active_hid {}", r)
5
    if (!r) {
6
        return;
7
    }
8
    let rse = hidEvent.doubleClickPoint(469, 1306)
9
    if (rse == null) {
10
        console.log("Succeeded")
11
    } else {
12
        console.log("Failed {}", rse)
13
    }
14
}
15

16

17
function one_key_active_hid() {
18
    if (hidEvent.isHidStatus()) {
19
        logd("Already in USB HID mode, no need to activate")
20
        return true;
21
    }
22
    logd("Switching to TCP connection...")
23
    let toTcpResult = hidEvent.connectByTcp()
24
    if (toTcpResult) {
25
        logd("TCP switch succeeded, continuing USB HID activation...")
26
    } else {
27
        logw("TCP switch failed; USB HID activation may not work")
28
    }
29
    sleep(3000)
30
    if (hidEvent.isUsbConnected()) {
31
        console.log("Simulating USB debugging off... please wait")
32
        let close_debug_result = hidEvent.simCloseUsbDebug();
33
        console.log("close_debug_result {}", close_debug_result)
34
        if (close_debug_result) {
35
            console.log("USB debugging disabled successfully")
36
            sleep(3000)
37
        } else {
38
            logw("Failed to disable USB debugging")
39
            return;
40
        }
41
    }
42
    logd("Clearing previous USB HID records...")
43
    let clearResult = hidEvent.clearHidStatus()
44
    if (clearResult != null) {
45
        clearResult = hidEvent.clearHidStatus()
46
        if (clearResult != null) {
47
            logw("Clear failed --> USB HID host call failed: " + clearResult)
48
            return false;
49
        }
50
    }
51

52
    logd("USB HID records cleared; activating USB HID... connection may drop and reconnect automatically")
53

54

55
    let activeResult = hidEvent.activeHid();
56
    if (activeResult != null) {
57
        activeResult = hidEvent.activeHid()
58
        if (hidEvent.isHidStatus()) {
59
            return true
60
        } else {
61
            logw("Activation failed --> USB HID host call failed: " + activeResult)
62
            return false;
63
        }
64
    }
65
    sleep(2000)
66
    logd("USB HID activated successfully")
67
    let rs = hidEvent.isHidStatus();
68
    if (rs) {
69
        logd("Device is in USB HID mode")
70
    } else {
71
        logw("Device is not in USB HID mode")
72
        return false;
73
    }
74

75
    return true;
76

77

78
}
79

80
main()

press — Long-Press Coordinates

Long-press coordinates
Supported: HarmonyOS Next USB edition 2.15.0+
@param x x coordinate
@param y y coordinate
@param delay hold duration in milliseconds
@return {null|string} null on success; otherwise an error message

1
function main() {
2

3
    let r = one_key_active_hid();
4
    console.log("--- one_key_active_hid {}", r)
5
    if (!r) {
6
        return;
7
    }
8
    let rse = hidEvent.press(469, 1306, 5000)
9
    if (rse == null) {
10
        console.log("Succeeded")
11
    } else {
12
        console.log("Failed {}", rse)
13
    }
14
}
15

16

17
function one_key_active_hid() {
18
    if (hidEvent.isHidStatus()) {
19
        logd("Already in USB HID mode, no need to activate")
20
        return true;
21
    }
22
    logd("Switching to TCP connection...")
23
    let toTcpResult = hidEvent.connectByTcp()
24
    if (toTcpResult) {
25
        logd("TCP switch succeeded, continuing USB HID activation...")
26
    } else {
27
        logw("TCP switch failed; USB HID activation may not work")
28
    }
29
    sleep(3000)
30
    if (hidEvent.isUsbConnected()) {
31
        console.log("Simulating USB debugging off... please wait")
32
        let close_debug_result = hidEvent.simCloseUsbDebug();
33
        console.log("close_debug_result {}", close_debug_result)
34
        if (close_debug_result) {
35
            console.log("USB debugging disabled successfully")
36
            sleep(3000)
37
        } else {
38
            logw("Failed to disable USB debugging")
39
            return;
40
        }
41
    }
42
    logd("Clearing previous USB HID records...")
43
    let clearResult = hidEvent.clearHidStatus()
44
    if (clearResult != null) {
45
        clearResult = hidEvent.clearHidStatus()
46
        if (clearResult != null) {
47
            logw("Clear failed --> USB HID host call failed: " + clearResult)
48
            return false;
49
        }
50
    }
51

52
    logd("USB HID records cleared; activating USB HID... connection may drop and reconnect automatically")
53

54

55
    let activeResult = hidEvent.activeHid();
56
    if (activeResult != null) {
57
        activeResult = hidEvent.activeHid()
58
        if (hidEvent.isHidStatus()) {
59
            return true
60
        } else {
61
            logw("Activation failed --> USB HID host call failed: " + activeResult)
62
            return false;
63
        }
64
    }
65
    sleep(2000)
66
    logd("USB HID activated successfully")
67
    let rs = hidEvent.isHidStatus();
68
    if (rs) {
69
        logd("Device is in USB HID mode")
70
    } else {
71
        logw("Device is not in USB HID mode")
72
        return false;
73
    }
74

75
    return true;
76

77

78
}
79

80
main()

swipe — Swipe

Swipe
Supported: HarmonyOS Next USB edition 2.15.0+
@param x start x coordinate
@param y start y coordinate
@param ex end x coordinate
@param ey end y coordinate
@param delay hold duration in milliseconds
@return {null|string} null on success; otherwise an error message

1
function main() {
2

3
    let r = one_key_active_hid();
4
    console.log("--- one_key_active_hid {}", r)
5
    if (!r) {
6
        return;
7
    }
8
    let rse = hidEvent.swipe(469, 1306, 600, 1000, 1000)
9
    if (rse == null) {
10
        console.log("Succeeded")
11
    } else {
12
        console.log("Failed {}", rse)
13
    }
14
}
15

16

17
function one_key_active_hid() {
18
    if (hidEvent.isHidStatus()) {
19
        logd("Already in USB HID mode, no need to activate")
20
        return true;
21
    }
22
    logd("Switching to TCP connection...")
23
    let toTcpResult = hidEvent.connectByTcp()
24
    if (toTcpResult) {
25
        logd("TCP switch succeeded, continuing USB HID activation...")
26
    } else {
27
        logw("TCP switch failed; USB HID activation may not work")
28
    }
29
    sleep(3000)
30
    if (hidEvent.isUsbConnected()) {
31
        console.log("Simulating USB debugging off... please wait")
32
        let close_debug_result = hidEvent.simCloseUsbDebug();
33
        console.log("close_debug_result {}", close_debug_result)
34
        if (close_debug_result) {
35
            console.log("USB debugging disabled successfully")
36
            sleep(3000)
37
        } else {
38
            logw("Failed to disable USB debugging")
39
            return;
40
        }
41
    }
42
    logd("Clearing previous USB HID records...")
43
    let clearResult = hidEvent.clearHidStatus()
44
    if (clearResult != null) {
45
        clearResult = hidEvent.clearHidStatus()
46
        if (clearResult != null) {
47
            logw("Clear failed --> USB HID host call failed: " + clearResult)
48
            return false;
49
        }
50
    }
51

52
    logd("USB HID records cleared; activating USB HID... connection may drop and reconnect automatically")
53

54

55
    let activeResult = hidEvent.activeHid();
56
    if (activeResult != null) {
57
        activeResult = hidEvent.activeHid()
58
        if (hidEvent.isHidStatus()) {
59
            return true
60
        } else {
61
            logw("Activation failed --> USB HID host call failed: " + activeResult)
62
            return false;
63
        }
64
    }
65
    sleep(2000)
66
    logd("USB HID activated successfully")
67
    let rs = hidEvent.isHidStatus();
68
    if (rs) {
69
        logd("Device is in USB HID mode")
70
    } else {
71
        logw("Device is not in USB HID mode")
72
        return false;
73
    }
74

75
    return true;
76

77

78
}
79

80
main()

touchDown — Touch Down

Touch down
Supported: HarmonyOS Next USB edition 2.15.0+
@param x x coordinate
@param y y coordinate
@return {null|string} null on success; otherwise an error message

1
function main() {
2

3
    let r = one_key_active_hid();
4
    console.log("--- one_key_active_hid {}", r)
5
    if (!r) {
6
        return;
7
    }
8
    let rse = hidEvent.touchDown(469, 1306)
9
    if (rse == null) {
10
        console.log("Succeeded")
11
    } else {
12
        console.log("Failed {}", rse)
13
    }
14
}
15

16

17
function one_key_active_hid() {
18
    if (hidEvent.isHidStatus()) {
19
        logd("Already in USB HID mode, no need to activate")
20
        return true;
21
    }
22
    logd("Switching to TCP connection...")
23
    let toTcpResult = hidEvent.connectByTcp()
24
    if (toTcpResult) {
25
        logd("TCP switch succeeded, continuing USB HID activation...")
26
    } else {
27
        logw("TCP switch failed; USB HID activation may not work")
28
    }
29
    sleep(3000)
30
    if (hidEvent.isUsbConnected()) {
31
        console.log("Simulating USB debugging off... please wait")
32
        let close_debug_result = hidEvent.simCloseUsbDebug();
33
        console.log("close_debug_result {}", close_debug_result)
34
        if (close_debug_result) {
35
            console.log("USB debugging disabled successfully")
36
            sleep(3000)
37
        } else {
38
            logw("Failed to disable USB debugging")
39
            return;
40
        }
41
    }
42
    logd("Clearing previous USB HID records...")
43
    let clearResult = hidEvent.clearHidStatus()
44
    if (clearResult != null) {
45
        clearResult = hidEvent.clearHidStatus()
46
        if (clearResult != null) {
47
            logw("Clear failed --> USB HID host call failed: " + clearResult)
48
            return false;
49
        }
50
    }
51

52
    logd("USB HID records cleared; activating USB HID... connection may drop and reconnect automatically")
53

54

55
    let activeResult = hidEvent.activeHid();
56
    if (activeResult != null) {
57
        activeResult = hidEvent.activeHid()
58
        if (hidEvent.isHidStatus()) {
59
            return true
60
        } else {
61
            logw("Activation failed --> USB HID host call failed: " + activeResult)
62
            return false;
63
        }
64
    }
65
    sleep(2000)
66
    logd("USB HID activated successfully")
67
    let rs = hidEvent.isHidStatus();
68
    if (rs) {
69
        logd("Device is in USB HID mode")
70
    } else {
71
        logw("Device is not in USB HID mode")
72
        return false;
73
    }
74

75
    return true;
76

77

78
}
79

80
main()

touchMove — Touch Move

Touch move
Supported: HarmonyOS Next USB edition 2.15.0+
@param x x coordinate
@param y y coordinate
@return {null|string} null on success; otherwise an error message

1
function main() {
2

3
    let r = one_key_active_hid();
4
    console.log("--- one_key_active_hid {}", r)
5
    if (!r) {
6
        return;
7
    }
8
    let rse = hidEvent.touchMove(480, 1310)
9
    if (rse == null) {
10
        console.log("Succeeded")
11
    } else {
12
        console.log("Failed {}", rse)
13
    }
14
}
15

16

17
function one_key_active_hid() {
18
    if (hidEvent.isHidStatus()) {
19
        logd("Already in USB HID mode, no need to activate")
20
        return true;
21
    }
22
    logd("Switching to TCP connection...")
23
    let toTcpResult = hidEvent.connectByTcp()
24
    if (toTcpResult) {
25
        logd("TCP switch succeeded, continuing USB HID activation...")
26
    } else {
27
        logw("TCP switch failed; USB HID activation may not work")
28
    }
29
    sleep(3000)
30
    if (hidEvent.isUsbConnected()) {
31
        console.log("Simulating USB debugging off... please wait")
32
        let close_debug_result = hidEvent.simCloseUsbDebug();
33
        console.log("close_debug_result {}", close_debug_result)
34
        if (close_debug_result) {
35
            console.log("USB debugging disabled successfully")
36
            sleep(3000)
37
        } else {
38
            logw("Failed to disable USB debugging")
39
            return;
40
        }
41
    }
42
    logd("Clearing previous USB HID records...")
43
    let clearResult = hidEvent.clearHidStatus()
44
    if (clearResult != null) {
45
        clearResult = hidEvent.clearHidStatus()
46
        if (clearResult != null) {
47
            logw("Clear failed --> USB HID host call failed: " + clearResult)
48
            return false;
49
        }
50
    }
51

52
    logd("USB HID records cleared; activating USB HID... connection may drop and reconnect automatically")
53

54

55
    let activeResult = hidEvent.activeHid();
56
    if (activeResult != null) {
57
        activeResult = hidEvent.activeHid()
58
        if (hidEvent.isHidStatus()) {
59
            return true
60
        } else {
61
            logw("Activation failed --> USB HID host call failed: " + activeResult)
62
            return false;
63
        }
64
    }
65
    sleep(2000)
66
    logd("USB HID activated successfully")
67
    let rs = hidEvent.isHidStatus();
68
    if (rs) {
69
        logd("Device is in USB HID mode")
70
    } else {
71
        logw("Device is not in USB HID mode")
72
        return false;
73
    }
74

75
    return true;
76

77

78
}
79

80
main()

touchUp — Touch Up

Touch up
Supported: HarmonyOS Next USB edition 2.15.0+
@param x x coordinate
@param y y coordinate
@return {null|string} null on success; otherwise an error message

1
function main() {
2

3
    let r = one_key_active_hid();
4
    console.log("--- one_key_active_hid {}", r)
5
    if (!r) {
6
        return;
7
    }
8
    let rse = hidEvent.touchUp(480, 1310)
9
    if (rse == null) {
10
        console.log("Succeeded")
11
    } else {
12
        console.log("Failed {}", rse)
13
    }
14
}
15

16

17
function one_key_active_hid() {
18
    if (hidEvent.isHidStatus()) {
19
        logd("Already in USB HID mode, no need to activate")
20
        return true;
21
    }
22
    logd("Switching to TCP connection...")
23
    let toTcpResult = hidEvent.connectByTcp()
24
    if (toTcpResult) {
25
        logd("TCP switch succeeded, continuing USB HID activation...")
26
    } else {
27
        logw("TCP switch failed; USB HID activation may not work")
28
    }
29
    sleep(3000)
30
    if (hidEvent.isUsbConnected()) {
31
        console.log("Simulating USB debugging off... please wait")
32
        let close_debug_result = hidEvent.simCloseUsbDebug();
33
        console.log("close_debug_result {}", close_debug_result)
34
        if (close_debug_result) {
35
            console.log("USB debugging disabled successfully")
36
            sleep(3000)
37
        } else {
38
            logw("Failed to disable USB debugging")
39
            return;
40
        }
41
    }
42
    logd("Clearing previous USB HID records...")
43
    let clearResult = hidEvent.clearHidStatus()
44
    if (clearResult != null) {
45
        clearResult = hidEvent.clearHidStatus()
46
        if (clearResult != null) {
47
            logw("Clear failed --> USB HID host call failed: " + clearResult)
48
            return false;
49
        }
50
    }
51

52
    logd("USB HID records cleared; activating USB HID... connection may drop and reconnect automatically")
53

54

55
    let activeResult = hidEvent.activeHid();
56
    if (activeResult != null) {
57
        activeResult = hidEvent.activeHid()
58
        if (hidEvent.isHidStatus()) {
59
            return true
60
        } else {
61
            logw("Activation failed --> USB HID host call failed: " + activeResult)
62
            return false;
63
        }
64
    }
65
    sleep(2000)
66
    logd("USB HID activated successfully")
67
    let rs = hidEvent.isHidStatus();
68
    if (rs) {
69
        logd("Device is in USB HID mode")
70
    } else {
71
        logw("Device is not in USB HID mode")
72
        return false;
73
    }
74

75
    return true;
76

77

78
}
79

80
main()

openNotification — Open Notification Shade

Open the notification shade
Supported: HarmonyOS Next USB edition 2.15.0+
@return {null|string} null on success; otherwise an error message

1
function main() {
2

3
    let r = one_key_active_hid();
4
    console.log("--- one_key_active_hid {}", r)
5
    if (!r) {
6
        return;
7
    }
8
    let rse = hidEvent.openNotification()
9
    if (rse == null) {
10
        console.log("Succeeded")
11
    } else {
12
        console.log("Failed {}", rse)
13
    }
14
}
15

16

17
function one_key_active_hid() {
18
    if (hidEvent.isHidStatus()) {
19
        logd("Already in USB HID mode, no need to activate")
20
        return true;
21
    }
22
    logd("Switching to TCP connection...")
23
    let toTcpResult = hidEvent.connectByTcp()
24
    if (toTcpResult) {
25
        logd("TCP switch succeeded, continuing USB HID activation...")
26
    } else {
27
        logw("TCP switch failed; USB HID activation may not work")
28
    }
29
    sleep(3000)
30
    if (hidEvent.isUsbConnected()) {
31
        console.log("Simulating USB debugging off... please wait")
32
        let close_debug_result = hidEvent.simCloseUsbDebug();
33
        console.log("close_debug_result {}", close_debug_result)
34
        if (close_debug_result) {
35
            console.log("USB debugging disabled successfully")
36
            sleep(3000)
37
        } else {
38
            logw("Failed to disable USB debugging")
39
            return;
40
        }
41
    }
42
    logd("Clearing previous USB HID records...")
43
    let clearResult = hidEvent.clearHidStatus()
44
    if (clearResult != null) {
45
        clearResult = hidEvent.clearHidStatus()
46
        if (clearResult != null) {
47
            logw("Clear failed --> USB HID host call failed: " + clearResult)
48
            return false;
49
        }
50
    }
51

52
    logd("USB HID records cleared; activating USB HID... connection may drop and reconnect automatically")
53

54

55
    let activeResult = hidEvent.activeHid();
56
    if (activeResult != null) {
57
        activeResult = hidEvent.activeHid()
58
        if (hidEvent.isHidStatus()) {
59
            return true
60
        } else {
61
            logw("Activation failed --> USB HID host call failed: " + activeResult)
62
            return false;
63
        }
64
    }
65
    sleep(2000)
66
    logd("USB HID activated successfully")
67
    let rs = hidEvent.isHidStatus();
68
    if (rs) {
69
        logd("Device is in USB HID mode")
70
    } else {
71
        logw("Device is not in USB HID mode")
72
        return false;
73
    }
74

75
    return true;
76

77

78
}
79

80
main()

sendKey — USB HID Keyboard Input

USB HID keyboard input
Supported: HarmonyOS Next USB edition 2.15.0+
@param modifiers int modifier keys: 306 Left Ctrl, 304 Left Shift, 308 Left Alt, 305 Right Ctrl, 303 Right Shift, 307 Right Alt, 309 left Windows key, 310 Right Windows key
@param code int key code; see https://max.book118.com/html/2018/0108/147954370.shtm or https://wenku.csdn.net/answer/f525e3adc4034414899a2d53fe143c3e
or search for “HID keyboard key code values”
@return {null|string} null on success; otherwise an error message

1
function main() {
2

3
    let r = one_key_active_hid();
4
    console.log("--- one_key_active_hid {}", r)
5
    if (!r) {
6
        return;
7
    }
8
    // See documentation links for code values
9
    // 0x04 = a, 0x05 = b
10
    let rse = hidEvent.sendKey(0, 0x05)
11
    if (rse == null) {
12
        console.log("Succeeded")
13
    } else {
14
        console.log("Failed {}", rse)
15
    }
16
}
17

18

19
function one_key_active_hid() {
20
    if (hidEvent.isHidStatus()) {
21
        logd("Already in USB HID mode, no need to activate")
22
        return true;
23
    }
24
    logd("Switching to TCP connection...")
25
    let toTcpResult = hidEvent.connectByTcp()
26
    if (toTcpResult) {
27
        logd("TCP switch succeeded, continuing USB HID activation...")
28
    } else {
29
        logw("TCP switch failed; USB HID activation may not work")
30
    }
31
    sleep(3000)
32
    if (hidEvent.isUsbConnected()) {
33
        console.log("Simulating USB debugging off... please wait")
34
        let close_debug_result = hidEvent.simCloseUsbDebug();
35
        console.log("close_debug_result {}", close_debug_result)
36
        if (close_debug_result) {
37
            console.log("USB debugging disabled successfully")
38
            sleep(3000)
39
        } else {
40
            logw("Failed to disable USB debugging")
41
            return;
42
        }
43
    }
44
    logd("Clearing previous USB HID records...")
45
    let clearResult = hidEvent.clearHidStatus()
46
    if (clearResult != null) {
47
        clearResult = hidEvent.clearHidStatus()
48
        if (clearResult != null) {
49
            logw("Clear failed --> USB HID host call failed: " + clearResult)
50
            return false;
51
        }
52
    }
53

54
    logd("USB HID records cleared; activating USB HID... connection may drop and reconnect automatically")
55

56

57
    let activeResult = hidEvent.activeHid();
58
    if (activeResult != null) {
59
        activeResult = hidEvent.activeHid()
60
        if (hidEvent.isHidStatus()) {
61
            return true
62
        } else {
63
            logw("Activation failed --> USB HID host call failed: " + activeResult)
64
            return false;
65
        }
66
    }
67
    sleep(2000)
68
    logd("USB HID activated successfully")
69
    let rs = hidEvent.isHidStatus();
70
    if (rs) {
71
        logd("Device is in USB HID mode")
72
    } else {
73
        logw("Device is not in USB HID mode")
74
        return false;
75
    }
76

77
    return true;
78

79

80
}
81

82
main()

multiTouch — Multi-Touch

Multi-touch
Supported: HarmonyOS Next USB edition 2.15.0+
Touch parameters: action — usually 0 for down, 1 for up, 2 for move
x: X coordinate
y: Y coordinate
pointer: finger index — 1, 2, 3, etc.
delay: delay before this action in milliseconds; use more than 40 ms to avoid coordinate drift
@param touch1 touch point array for the first finger, e.g. [{"action":0,"x":1,"y":1,"pointer":1,"delay":30},{"action":2,"x":1,"y":1,"pointer":1,"delay":30}]
@param timeout multi-touch execution timeout in milliseconds
@return {null|string} null on success; otherwise an error message

1
function main() {
2

3
    let r = one_key_active_hid();
4
    console.log("--- one_key_active_hid {}", r)
5
    if (!r) {
6
        return;
7
    }
8
    mtouch();
9
}
10
function mtouch() {
11
    let data = [
12
        {"action": 0, "x": 250, "y": 1800, "pointer": 1, "delay": 100},
13
        {"action": 2, "x": 250, "y": 1700, "pointer": 1, "delay": 100},
14
        {"action": 2, "x": 300, "y": 1700, "pointer": 1, "delay": 100},
15
        {"action": 2, "x": 330, "y": 1650, "pointer": 1, "delay": 200},
16
        {"action": 2, "x": 400, "y": 1650, "pointer": 1, "delay": 100},
17
        {"action": 1, "x": 600, "y": 400, "pointer": 1, "delay": 100}
18
    ]
19

20
    let tou = hidEvent.multiTouch(data, 1000)
21
    if (tou == null) {
22
        logd("Multi-touch succeeded")
23
    } else {
24
        loge("Multi-touch failed:" + tou);
25
        return false
26
    }
27
}
28

29
function one_key_active_hid() {
30
    if (hidEvent.isHidStatus()) {
31
        logd("Already in USB HID mode, no need to activate")
32
        return true;
33
    }
34
    logd("Switching to TCP connection...")
35
    let toTcpResult = hidEvent.connectByTcp()
36
    if (toTcpResult) {
37
        logd("TCP switch succeeded, continuing USB HID activation...")
38
    } else {
39
        logw("TCP switch failed; USB HID activation may not work")
40
    }
41
    sleep(3000)
42
    if (hidEvent.isUsbConnected()) {
43
        console.log("Simulating USB debugging off... please wait")
44
        let close_debug_result = hidEvent.simCloseUsbDebug();
45
        console.log("close_debug_result {}", close_debug_result)
46
        if (close_debug_result) {
47
            console.log("USB debugging disabled successfully")
48
            sleep(3000)
49
        } else {
50
            logw("Failed to disable USB debugging")
51
            return;
52
        }
53
    }
54
    logd("Clearing previous USB HID records...")
55
    let clearResult = hidEvent.clearHidStatus()
56
    if (clearResult != null) {
57
        clearResult = hidEvent.clearHidStatus()
58
        if (clearResult != null) {
59
            logw("Clear failed --> USB HID host call failed: " + clearResult)
60
            return false;
61
        }
62
    }
63

64
    logd("USB HID records cleared; activating USB HID... connection may drop and reconnect automatically")
65

66

67
    let activeResult = hidEvent.activeHid();
68
    if (activeResult != null) {
69
        activeResult = hidEvent.activeHid()
70
        if (hidEvent.isHidStatus()) {
71
            return true
72
        } else {
73
            logw("Activation failed --> USB HID host call failed: " + activeResult)
74
            return false;
75
        }
76
    }
77
    sleep(2000)
78
    logd("USB HID activated successfully")
79
    let rs = hidEvent.isHidStatus();
80
    if (rs) {
81
        logd("Device is in USB HID mode")
82
    } else {
83
        logw("Device is not in USB HID mode")
84
        return false;
85
    }
86

87
    return true;
88

89

90
}
91

92
main()