# Keyboard and Mouse
## 1.Mouse clicks
### Calling
* **Request Parameters**
| parameter | type | illustrate | Remark |
| --------- | ------- | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| fun | String | /mouse/click | Request function name |
| id | String | Device unique ID | Separate multiple devices with commas |
| button | String | 1 left button, 2 right button, 3 middle button, 4, 5, 6, 7, 8 button | If it is empty, the default left key is supported, and up to 8 keys are supported |
| x | Integer | x-coordinate | - |
| y | Integer | y coordinate | - |
| time | Integer | The delay between pressing and popping up, if not filled in, it will be handled by the internal | millisecond |
* **httpGet request example**
```
curl --request GET \
--url 'http://192.168.9.9:9911/api/mouse/click?id=5C:F7:E6:CE:65:22&x=100&y=100'
```
* **httpPost request example**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'content-type: multipart/form-data' \
--form fun=/mouse/click \
--form id=5C:F7:E6:CE:65:22 \
--form x=100 \
--form y=100
```
* **httpPost json request example \[websocket can also send the same json request]**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{
"fun": "/mouse/click",
"data": {
"id":"5C:F7:E6:CE:65:22",
"x":100,
"y":100
}
}'
```
### Response
```
{
"data": {
"code": 0,
"id": "5C:F7:E6:CE:65:22",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/mouse/click"
}
```
* **Response data data field description**\
None
## 2.Mouse slide
### Calling
* **Request Parameters**
| parameter | type | illustrate | Remark |
| ----------- | ---------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------- |
| fun | String | /mouse/swipe | Request function name |
| id | String | Device unique ID | Separate multiple devices with commas |
| button | String | 1 left button, 2 right button | Empty default left button |
| direction | Integer | Slide direction up, down, left, right | Corresponding to up, down, left and right respectively |
| len | Floating point numbers | Slide distance percentage | Assume 0.9 will slide from 10% to 90% of the screen |
| step\_sleep | Integer | When steping is greater than 1, it takes effect | The interval between multiple slides in milliseconds |
| stepping | Integer | How many times to slide to the specified position in the loop | - |
| brake | Integer | Stop immediately after sliding | Some interfaces may be delayed after sliding |
| sx | Integer | y coordinate | 0 Automatically calculated using the sliding distance percentage |
| sy | Integer | y coordinate | 0 Automatically calculated using the sliding distance percentage |
| ex | Integer | y coordinate | 0 Automatically calculated using the sliding distance percentage |
| ey | Integer | y coordinate | 0 Automatically calculated using the sliding distance percentage |
* **httpGet request example**
```
curl --request GET \
--url 'http://192.168.9.9:9911/api/mouse/swipe?id=1C:5C:F2:BC:D0:CC&direction=up&len=0.9'
```
* **httpPost request example**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'content-type: multipart/form-data' \
--form fun=/mouse/swipe \
--form id=1C:5C:F2:BC:D0:CC \
--form direction=up \
--form len=0.8
```
* **httpPost json request example \[websocket can also send the same json request]**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{
"fun": "/mouse/swipe",
"msgid": 1,
"data": {
"id": "1C:5C:F2:BC:D0:CC",
"direction": "up",
"len": 0.9,
"steping": 10,
"step_sleep": 10,
"brake": true,
"sx": 100,
"ex": 100
}
}'
```
{ "fun": "/mouse/swipe", "msgid": 2, "data": { "id": "0C:51:01:0B:E5:EA", "button": "left", "direction": "left", "steping": 0, "step\_sleep": 0, "brake": true, "sx": 100, "sy": 100, "ex": 100, "ey": 100 } }
### Response
```
{
"data": {
"code": 0,
"id": "5C:F7:E6:CE:65:22",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/mouse/swipe"
}
```
* **Response data data field description**\
None
## 3.Mouse pop-up
### Calling
* **Request Parameters**
| parameter | type | illustrate | Remark |
| --------- | ------ | -------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| fun | String | /mouse/up | Request function name |
| id | String | Device unique ID | Separate multiple devices with commas |
| button | String | 1 left button, 2 right button, 3 middle button, 4, 5, 6, 7, 8 button | If it is empty, the default left key is supported, and up to 8 keys are supported |
* **httpGet request example**
```
curl --request GET \
--url 'http://192.168.9.9:9911/api/mouse/up?id=5C:F7:E6:CE:65:22'
```
* **httpPost request example**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'content-type: multipart/form-data' \
--form fun=/mouse/up \
--form id=5C:F7:E6:CE:65:22
```
* **httpPost json request example \[websocket can also send the same json request]**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{
"fun": "/mouse/up",
"data": {
"id":"5C:F7:E6:CE:65:22"
}
}'
```
### Response
```
{
"data": {
"code": 0,
"id": "5C:F7:E6:CE:65:22",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/mouse/up"
}
```
* **Response data data field description**\
None
## 4.Mouse down
### Calling
* **Request Parameters**
| parameter | type | illustrate | Remark |
| --------- | ------ | -------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| fun | String | /mouse/down | Request function name |
| id | String | Device unique ID | Separate multiple devices with commas |
| button | String | 1 left button, 2 right button, 3 middle button, 4, 5, 6, 7, 8 button | If it is empty, the default left key is supported, and up to 8 keys are supported |
* **httpGet request example**
```
curl --request GET \
--url 'http://192.168.9.9:9911/api/mouse/down?id=5C:F7:E6:CE:65:22'
```
* **httpPost request example**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'content-type: multipart/form-data' \
--form fun=/mouse/down \
--form id=5C:F7:E6:CE:65:22
```
* **httpPost json request example \[websocket can also send the same json request]**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{
"fun": "/mouse/down",
"data": {
"id":"5C:F7:E6:CE:65:22"
}
}'
```
### Response
```
{
"data": {
"code": 0,
"id": "5C:F7:E6:CE:65:22",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/mouse/down"
}
```
* **Response data data field description**\
None
## 5.Mouse movement
### Calling
* **Request Parameters**
| parameter | type | illustrate | Remark |
| --------- | ------- | ---------------- | ------------------------------------- |
| fun | String | /mouse/move | Request function name |
| id | String | Device unique ID | Separate multiple devices with commas |
| x | Integer | x-coordinate | - |
| y | Integer | y coordinate | - |
* **httpGet request example**
```
curl --request GET \
--url 'http://192.168.9.9:9911/api/mouse/move?id=5C:F7:E6:CE:65:22&x=100&y=100'
```
* **httpPost request example**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'content-type: multipart/form-data' \
--form fun=/mouse/move \
--form id=5C:F7:E6:CE:65:22 \
--form x=100 \
--form y=100
```
* **httpPost json request example \[websocket can also send the same json request]**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{
"fun": "/mouse/move",
"data": {
"id":"5C:F7:E6:CE:65:22",
"x":100,
"y":10
}
}'
```
### Response
```
{
"data": {
"code": 0,
"id": "5C:F7:E6:CE:65:22",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/mouse/move"
}
```
* **Response data data field description**\
None
## 6.Mouse reset
### Calling
* **Request Parameters**
| parameter | type | illustrate | Remark |
| --------- | ------ | ---------------- | ------------------------------------- |
| fun | String | /mouse/reset | Request function name |
| id | String | Device unique ID | Separate multiple devices with commas |
* **httpGet request example**
```
curl --request GET \
--url 'http://192.168.9.9:9911/api/mouse/reset?id=5C:F7:E6:CE:65:22'
```
* **httpPost request example**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'content-type: multipart/form-data' \
--form fun=/mouse/reset \
--form id=5C:F7:E6:CE:65:22
```
* **httpPost json request example \[websocket can also send the same json request]**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{
"fun": "/mouse/reset",
"data": {
"id":"5C:F7:E6:CE:65:22"
}
}'
```
### Response
```
{
"data": {
"code": 0,
"id": "5C:F7:E6:CE:65:22",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/mouse/reset"
}
```
* **Response data data field description**\
None
## 7.Mouse wheel
### Calling
* **Request Parameters**
| parameter | type | illustrate | Remark |
| --------- | ------ | ---------------- | ------------------------------------- |
| fun | String | /mouse/wheel | Request function name |
| id | String | Device unique ID | Separate multiple devices with commas |
| direction | String | Scroll direction | up, down, left, right |
| len | String | Device unique ID | Scroll length 1-127 |
| number | String | Device unique ID | Number of scrolls |
* **httpGet request example**
```
curl --request GET \
--url 'http://192.168.9.9:9911/api/mouse/wheel?id=5C:F7:E6:CE:65:22&direction=up&len=30&number=1'
```
* **httpPost request example**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'content-type: multipart/form-data' \
--form fun=/mouse/wheel \
--form id=5C:F7:E6:CE:65:22 \
--form direction=up \
--form len=30 \
--form number=1
```
* **httpPost json request example \[websocket can also send the same json request]**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{
"fun": "/mouse/wheel",
"data": {
"id": "1C:5C:F2:BC:D0:CC",
"direction": "up",
"len": 30,
"number": 3
}
}'
```
### Response
```
{
"data": {
"code": 0,
"id": "5C:F7:E6:CE:65:22",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/mouse/wheel"
}
```
* **Response data data field description**\
None
## 8.Keyboard Pressed
### Calling
* **Request Parameters**
| parameter | type | illustrate | Remark |
| --------- | ------ | ---------------------- | ------------------------------------------------------------------------------------------ |
| fun | String | /key/down | Request function name |
| id | String | Device unique ID | Separate multiple devices with commas |
| key | String | Press the keyboard key | Only supports English, numbers and English characters, hotkeys (only supports single keys) |
| fn\_key | String | Combination hotkeys | When using hotkeys, please leave the key parameter blank. |
* **httpGet request example**
```
curl --request GET \
--url 'http://192.168.9.9:9911/api/key/sendkey?id=1C:5C:F2:BC:D0:CC&key=aaaa'
```
* **httpPost request example**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'content-type: multipart/form-data' \
--form fun=/key/sendkey \
--form id=5C:F7:E6:CE:65:22 \
--form fn_key=win+h
```
* **httpPost json request example \[websocket can also send the same json request]**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{"fun": "/key/sendkey","data": {"id": "1C:5C:F2:BC:D0:CC","fn_key":"WIN+h"}
}'
```
### Response
```
{
"data": {
"code": 0,
"id": "5C:F7:E6:CE:65:22",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/key/sendkey"
}
```
| hotkeys | illustrate |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| WIN+h | Home screen |
| Home | Home screen (This fixes an issue that caused problems on iOS versions 26.1 and later; kernel version 2026.2.27 or later is required) |
| TAB+b | Return (not supported by all apps) |
| AppSwitch | app switching |
| ControlBar | Control Center |
| NoticeBar | Notification Center |
| TAB+l | Lock screen |
| OPENKeyboard | Open the on-screen keyboard |
| shift+win+3 | screenshot |
| shift+win+4 | Screenshot and edit |
| CTRL+ALT+SHIFT+WIN+r | Restart |
| CTRL+ALT+WIN+p | Pass-through mode (turn full keyboard on or off) |
| WIN+c | copy |
| WIN+v | Paste |
| WIN+a | Select All |
| WIN+x | Cut |
| SwitchIme | Switch input method |
| BACKSPACE | Backspace key |
| | The space bar (it's just one space). |
| TAB | TAB Key |
| ENTER | Enter key |
| UpArrow | Direction |
| DownArrow | Downward |
| LeftArrow | Direction left |
| RightArrow | Direction right |
| MuteSoundSwitch | mute switch |
| VolumeUp | Sound + |
| VolumeDown | sound- |
| Play/Pause | Play/Pause |
* **Response data data field description**\
None
## 9.Keyboard pop-up
### Calling
* **Request Parameters**
| parameter | type | illustrate | Remark |
| --------- | ------ | ------------------- | ------------------------------------------------------------------------------------------ |
| fun | String | /key/up | Request function name |
| id | String | Device unique ID | Separate multiple devices with commas |
| key | String | Pop-up keyboard key | Only supports English, numbers and English characters, hotkeys (only supports single keys) |
* **httpGet request example**
```
curl --request GET \
--url 'http://192.168.9.9:9911/api/key/up?id=5C:F7:E6:CE:65:22&key=a'
```
* **httpPost request example**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'content-type: multipart/form-data' \
--form fun=/key/up \
--form id=5C:F7:E6:CE:65:22 \
--form key=a
```
* **httpPost json request example \[websocket can also send the same json request]**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{
"fun": "/key/up",
"data": {
"id": "1C:5C:F2:BC:D0:CC",
"key": "a"
}
}'
```
### Response
```
{
"data": {
"code": 0,
"id": "5C:F7:E6:CE:65:22",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/key/up"
}
```
* **Response data data field description**\
None
## 10.Keyboard pops up all
### Calling
* **Request Parameters**
| parameter | type | illustrate | Remark |
| --------- | ------ | ---------------- | ------------------------------------- |
| fun | String | /key/upall | Request function name |
| id | String | Device unique ID | Separate multiple devices with commas |
* **httpGet request example**
```
curl --request GET \
--url 'http://192.168.9.9:9911/api/key/upall?id=5C:F7:E6:CE:65:22'
```
* **httpPost request example**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'content-type: multipart/form-data' \
--form fun=/key/upall \
--form id=5C:F7:E6:CE:65:22
```
* **httpPost json request example \[websocket can also send the same json request]**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{
"fun": "/key/upall",
"data": {
"id": "1C:5C:F2:BC:D0:CC"
}
}'
```
### Response
```
{
"data": {
"code": 0,
"id": "5C:F7:E6:CE:65:22",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/key/upall"
}
```
* **Response data data field description**\
None
## 11.Keyboard Input
### Calling
* **Request Parameters**
| parameter | type | illustrate | Remark |
| --------- | ------ | ---------------- | ---------------------------------------------------------- |
| fun | String | /key/sendkey | Request function name |
| id | String | Device unique ID | Separate multiple devices with commas |
| key | String | character | Only English, numbers and English characters are supported |
| fn\_key | String | Hotkeys | When using hotkeys, please leave the key parameter empty |
* **httpGet request example**
```
curl --request GET \
--url 'http://192.168.9.9:9911/api/key/sendkey?id=1C:5C:F2:BC:D0:CC&key=aaaa'
```
* **httpPost request example**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'content-type: multipart/form-data' \
--form fun=/key/sendkey \
--form id=5C:F7:E6:CE:65:22 \
--form fn_key=win+h
```
* **httpPost json request example \[websocket can also send the same json request]**
```
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{"fun": "/key/sendkey","data": {"id": "1C:5C:F2:BC:D0:CC","fn_key":"WIN+h"}
}'
```
### Response
```
{
"data": {
"code": 0,
"id": "5C:F7:E6:CE:65:22",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/key/sendkey"
}
```
* **Common hotkey list**
| Hotkeys | illustrate |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| WIN+h | Home Screen |
| Home | Home Screen (Fixes the malfunction issue in iOS 26.1 and subsequent versions; the kernel must be version 2026.2.27 or later) |
| TAB+b | Return (not supported by all apps) |
| AppSwitch | App Switcher |
| ControlBar | Control Center |
| NoticeBar | Notification Center |
| TAB+l | Lock screen |
| OPENKeyboard | Open the on-screen keyboard |
| shift+win+3 | screenshot |
| shift+win+4 | Screen capture and editing |
| CTRL+ALT+SHIFT+WIN+r | Restart |
| CTRL+ALT+WIN+p | Pass-through mode (turn the full keyboard on or off) |
| WIN+c | copy |
| WIN+v | Paste |
| WIN+a | Select All |
| WIN+x | Cut |
| SwitchIme | Switch input method |
| BACKSPACE | Backspace key |
| | Spacebar (just a space) |
| TAB | TAB key |
| ENTER | Enter key |
| UpArrow | Direction |
| DownArrow | Direction Down |
| LeftArrow | Direction Left |
| RightArrow | Direction Right |
| MuteSoundSwitch | Mute Toggle |
| VolumeUp | Voice+ |
| VolumeDown | Voice- |
| Play/Pause | Play/Pause |
* **Response data data field description**\
None
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://doc.some3c.com/iphone-farm-setup/xp-api-documentation/keyboard-and-mouse.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.