Automation

sendAction

true  // Returns true on successful operation

// Return to home screen
await apiInvoke('sendAction', {
    deviceId: 'P72578581E07',
    action: 'home'
});

// Wait 1 second
await new Promise(resolve => setTimeout(resolve, 1000));

// Open app switcher
await apiInvoke('sendAction', {
    deviceId: 'P72578581E07',
    action: 'switcher'
});

openApp

true  // Returns true on successful operation

// Open WeChat app
await apiInvoke('openApp', {
    deviceId: 'P72578581E07',
    name: 'WeChat'
});

killRecents

true  // Returns true on successful operation

// Clear all background apps on device
await apiInvoke('killRecents', {
    deviceId: 'P72578581E07'
});

click

true  // Returns true on successful operation

// Click screen coordinate (100, 200)
await apiInvoke('click', {
    deviceId: 'P72578581E07',
    x: 100,
    y: 200
});

mouseMove

true  // Returns true on successful operation

// Move cursor to coordinate (300, 400)
await apiInvoke('mouseMove', {
    deviceId: 'P72578581E07',
    x: 300,
    y: 400
});

mouseReset

true  // Returns true on successful operation

// Reset cursor to origin
await apiInvoke('mouseReset', {
    deviceId: 'P72578581E07'
});

mouseDown

true  // Returns true on successful operation

// Press left button at coordinate (200, 300)
await apiInvoke('mouseDown', {
    deviceId: 'P72578581E07',
    x: 200,
    y: 300
    // key defaults to 'LEFT'
});

// Press left button and auto release
await apiInvoke('mouseDown', {
    deviceId: 'P72578581E07',
    x: 200,
    y: 300,
    autoRelease: true  // Auto release button
});

mouseUp

true  // Returns true on successful operation

// Release left button at coordinate (200, 300)
await apiInvoke('mouseUp', {
    deviceId: 'P72578581E07',
    x: 200,
    y: 300
    // key defaults to 'LEFT'
});

mouseWheel

true  // Returns true on successful operation

// Scroll down
await apiInvoke('mouseWheel', {
    deviceId: 'P72578581E07',
    tilt: -120  // Negative = scroll down
});

// Scroll up
await apiInvoke('mouseWheel', {
    deviceId: 'P72578581E07',
    tilt: 120  // Positive = scroll up
});

swipe

true  // Returns true on successful operation

// Simulate pull down to open notification center
await apiInvoke('swipe', {
    deviceId: 'P72578581E07',
    start: [screenWidth / 2, 0],
    end: [screenWidh / 2, screenHeight * 0.8]
});

keyDown

true  // Returns true on successful operation

// Press Enter key
await apiInvoke('keyDown', {
    deviceId: 'P72578581E07',
    key: 'ENTER'
});

// Note: Must be used with keyUp
await apiInvoke('keyUp', {
    deviceId: 'P72578581E07',
    key: 'ENTER'
});

keyUp

true  // Returns true on successful operation

// Release Enter key
await apiInvoke('keyUp', {
    deviceId: 'P72578581E07',
    key: 'ENTER'
});

// Note: Must call keyDown first

sendKey

true  // Returns true on successful operation

// Input letter A
await apiInvoke('sendKey', {
    deviceId: 'P72578581E07',
    key: 'A'
});

// Input "HELLO"
await apiInvoke('sendKey', {
    deviceId: 'P72578581E07',
    key: 'HELLO'
});

// Equivalent to inputting H, E, L, L, O sequentially

// COMMAND + C (Copy)
await apiInvoke('sendKey', {
    deviceId: 'P72578581E07',
    key: 'C',
    fnkey: 'COMMAND'
});

// COMMAND + V (Paste)
await apiInvoke('sendKey', {
    deviceId: 'P72578581E07',
    key: 'V',
    fnkey: 'COMMAND'
});

// COMMAND + A (Select All)
await apiInvoke('sendKey', {
    deviceId: 'P72578581E07',
    key: 'A',
    fnkey: 'COMMAND'
});

// Send text with emoji
await apiInvoke('sendText', {
    deviceId: 'P72578581E07',
    text: '你好，Hello iClick! 😄'
});