Device API
Simulate Events
Simulate incoming SMS, phone calls, and fingerprint authentication.
Trigger system-level events that would normally come from external hardware or network sources.
send_sms
Simulate an incoming SMS message. The message appears in the device notification shade and SMS app as if received from the network.
| Parameter | Type | Required | Description |
|---|---|---|---|
srcAddress | string | Yes | Sender phone number (e.g. +14155552671) |
text | string | Yes | Message body |
SMS sent from +14155552671: "Your verification code is 847291"send_phone_call
Simulate phone call events. Chain operations to build a complete call flow.
| Parameter | Type | Required | Description |
|---|---|---|---|
operation | string | Yes | Call lifecycle operation |
number | string | Yes | Phone number (e.g. +14155552671) |
| Operation | Description |
|---|---|
init | Trigger an incoming call |
accept | Answer the call |
reject | Decline the call |
busy | Return a busy signal |
disconnect | End the call |
hold | Put the call on hold |
unhold | Resume the call |
A typical call flow: init → accept → disconnect.
Phone call initiated from +14155552671.send_fingerprint
Simulate a fingerprint sensor touch. Use to test biometric authentication flows without physical hardware.
| Parameter | Type | Required | Description |
|---|---|---|---|
isTouching | boolean | Yes | true = finger on sensor, false = lifted |
touchId | number | No | Fingerprint ID. 1 = registered print (auth succeeds). Any other value = unregistered (auth fails). Default: 1 |
Fingerprint touch event sent (isTouching: true, touchId: 1).