蓝牙 BLE 接口

说明

本页由企业版 OpenAPI 文档整理，模块：自动化接口/蓝牙BLE动作。

设置缩放比

POST /openapi/bleSetScale

设置鼠标补偿比率：鼠标移动 1 单位时，像素移动多少单位，默认是 2.0。

机型	分辨率	建议缩放比	说明
iPhone 6/7/8	375 × 667	2.0	标准 16:9，无安全区干扰
iPhone 11 / XR	414 × 896	1.96	屏幕变长，系统加速补偿 Y 轴
iPhone X/XS/11 Pro	375 × 812	1.98	纵横比 19.5:9，存在微小加速
iPhone 12/13/14/15	390 × 844	1.97	逻辑点数与 11 不同，加速曲线略有变动
Plus / Max 系列	414 × 896 / 430 × 932	1.94 ~ 1.95	屏幕最高，系统为了操作效率会大幅增加 Y 轴增益

适配 EC iOS USB 9.20.0+。参数 xScale / yScale 为浮点数。需要动态计算时，可参考脚本 bleEvent.getIPhoneScale。

请求 Body

1
{
2
    "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
    "xScale":2.0,
4
    "yScale": 1.96
5
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
5
  "xScale": 2.0,
6
  "yScale": 1.96
7
}
8
r = requests.post("http://127.0.0.1:8019/openapi/bleSetScale", json=body, timeout=30)
9
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
  "xScale": 2.0,
4
  "yScale": 1.96
5
};
6
const res = await fetch("http://127.0.0.1:8019/openapi/bleSetScale", {
7
  method: "POST",
8
  headers: { "Content-Type": "application/json" },
9
  body: JSON.stringify(body),
10
});
11
const data = await res.json();
12
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleSetScale" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d","xScale":2.0,"yScale":1.96}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\",\"xScale\":2.0,\"yScale\":1.96}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleSetScale", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» xScale	body	number	是	x的缩放比，浮点型例如1.98	none
» yScale	body	number	是	y的缩放比，浮点型例如1.98	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	true	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

点击坐标

POST /openapi/bleClickPoint

点击指定坐标。适配 EC iOS USB 9.20.0+。

参数：x / y 为坐标。

请求 Body

1
{
2
    "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
    "x": 36,
4
    "y": 34
5
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
5
  "x": 36,
6
  "y": 34
7
}
8
r = requests.post("http://127.0.0.1:8019/openapi/bleClickPoint", json=body, timeout=30)
9
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
  "x": 36,
4
  "y": 34
5
};
6
const res = await fetch("http://127.0.0.1:8019/openapi/bleClickPoint", {
7
  method: "POST",
8
  headers: { "Content-Type": "application/json" },
9
  body: JSON.stringify(body),
10
});
11
const data = await res.json();
12
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleClickPoint" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d","x":36,"y":34}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\",\"x\":36,\"y\":34}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleClickPoint", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» x	body	number	是	x坐标	none
» y	body	number	是	y坐标	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

设置屏幕尺寸

POST /openapi/bleSetScreenSize

设置屏幕逻辑尺寸，避免鼠标移出屏幕导致偏移。适配 EC iOS USB 9.20.0+。

参数：w / h 为宽高。若未知尺寸，可用全屏截图（如 image.captureFullScreenNoAuto）后取图片宽高。

请求 Body

1
{
2
       "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3

4
    "w": 1000,
5
    "h": 2000
6
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
5
  "w": 1000,
6
  "h": 2000
7
}
8
r = requests.post("http://127.0.0.1:8019/openapi/bleSetScreenSize", json=body, timeout=30)
9
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
  "w": 1000,
4
  "h": 2000
5
};
6
const res = await fetch("http://127.0.0.1:8019/openapi/bleSetScreenSize", {
7
  method: "POST",
8
  headers: { "Content-Type": "application/json" },
9
  body: JSON.stringify(body),
10
});
11
const data = await res.json();
12
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleSetScreenSize" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d","w":1000,"h":2000}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\",\"w\":1000,\"h\":2000}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleSetScreenSize", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» w	body	number	是	宽度	none
» h	body	number	是	高度	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

打开串口通信

POST /openapi/bleOpenSerial

打开与开发板的串口通信。适配 EC iOS USB 9.20.0+。

参数：timeout 为超时时间（毫秒），默认 15000。

请求 Body

1
{
2
    "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
    "timeout": 15000
4
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
5
  "timeout": 15000
6
}
7
r = requests.post("http://127.0.0.1:8019/openapi/bleOpenSerial", json=body, timeout=30)
8
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
  "timeout": 15000
4
};
5
const res = await fetch("http://127.0.0.1:8019/openapi/bleOpenSerial", {
6
  method: "POST",
7
  headers: { "Content-Type": "application/json" },
8
  body: JSON.stringify(body),
9
});
10
const data = await res.json();
11
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleOpenSerial" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d","timeout":15000}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\",\"timeout\":15000}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleOpenSerial", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» timeout	body	number	是	串口通信超时时间单位是毫秒默认是15秒	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

设置通信方式

POST /openapi/bleSetSendCmdType

设置与开发板的通信方式：串口或网络，默认串口。适配 EC iOS USB 9.20.0+。

参数：tt 为 1（串口）或 2（网络）。

请求 Body

1
{
2

3
    "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
4

5
    "tt": 2
6
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
5
  "tt": 2
6
}
7
r = requests.post("http://127.0.0.1:8019/openapi/bleSetSendCmdType", json=body, timeout=30)
8
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
  "tt": 2
4
};
5
const res = await fetch("http://127.0.0.1:8019/openapi/bleSetSendCmdType", {
6
  method: "POST",
7
  headers: { "Content-Type": "application/json" },
8
  body: JSON.stringify(body),
9
});
10
const data = await res.json();
11
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleSetSendCmdType" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d","tt":2}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\",\"tt\":2}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleSetSendCmdType", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» tt	body	number	是	1 串口 2 网络	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

设置网络信息

POST /openapi/bleSetWifiInfo

为开发板配置 Wi-Fi，便于联网。适配 EC iOS USB 9.20.0+。

参数：name 为 Wi-Fi 名称，pwd 为密码。

请求 Body

1
{
2
    "deviceId": "00008030-001529902ED0402E",
3
    "name": "mynet",
4
    "pwd": "kof.2156.com"
5
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "00008030-001529902ED0402E",
5
  "name": "mynet",
6
  "pwd": "kof.2156.com"
7
}
8
r = requests.post("http://127.0.0.1:8019/openapi/bleSetWifiInfo", json=body, timeout=30)
9
print(r.json())

1
const body = {
2
  "deviceId": "00008030-001529902ED0402E",
3
  "name": "mynet",
4
  "pwd": "kof.2156.com"
5
};
6
const res = await fetch("http://127.0.0.1:8019/openapi/bleSetWifiInfo", {
7
  method: "POST",
8
  headers: { "Content-Type": "application/json" },
9
  body: JSON.stringify(body),
10
});
11
const data = await res.json();
12
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleSetWifiInfo" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"00008030-001529902ED0402E","name":"mynet","pwd":"kof.2156.com"}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"00008030-001529902ED0402E\",\"name\":\"mynet\",\"pwd\":\"kof.2156.com\"}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleSetWifiInfo", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» name	body	string	是	WiFi名称	none
» pwd	body	string	是	WiFi 密码	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

重启开发板

POST /openapi/bleResetBle

重启开发板（相当于按下 RST）。适配 EC iOS USB 9.20.0+。

请求 Body

1
{
2
    "deviceId": "00008030-001529902ED0402E"
3
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "00008030-001529902ED0402E"
5
}
6
r = requests.post("http://127.0.0.1:8019/openapi/bleResetBle", json=body, timeout=30)
7
print(r.json())

1
const body = {
2
  "deviceId": "00008030-001529902ED0402E"
3
};
4
const res = await fetch("http://127.0.0.1:8019/openapi/bleResetBle", {
5
  method: "POST",
6
  headers: { "Content-Type": "application/json" },
7
  body: JSON.stringify(body),
8
});
9
const data = await res.json();
10
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleResetBle" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"00008030-001529902ED0402E"}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"00008030-001529902ED0402E\"}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleResetBle", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

关闭串口通信

POST /openapi/bleCloseSerial

关闭与开发板的串口通信。适配 EC iOS USB 9.20.0+。

请求 Body

1
{
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d"
3
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d"
5
}
6
r = requests.post("http://127.0.0.1:8019/openapi/bleCloseSerial", json=body, timeout=30)
7
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d"
3
};
4
const res = await fetch("http://127.0.0.1:8019/openapi/bleCloseSerial", {
5
  method: "POST",
6
  headers: { "Content-Type": "application/json" },
7
  body: JSON.stringify(body),
8
});
9
const data = await res.json();
10
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleCloseSerial" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d"}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\"}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleCloseSerial", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

移动鼠标

POST /openapi/bleMouseMove

仅移动鼠标指针到指定坐标，不触发按下。适配 EC iOS USB 9.20.0+。

参数：x / y 为坐标。

请求 Body

1
{
2
  "deviceId": "00008030-001529902ED0402E",
3
    "x": 166,
4
    "y": 193
5
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "00008030-001529902ED0402E",
5
  "x": 166,
6
  "y": 193
7
}
8
r = requests.post("http://127.0.0.1:8019/openapi/bleMouseMove", json=body, timeout=30)
9
print(r.json())

1
const body = {
2
  "deviceId": "00008030-001529902ED0402E",
3
  "x": 166,
4
  "y": 193
5
};
6
const res = await fetch("http://127.0.0.1:8019/openapi/bleMouseMove", {
7
  method: "POST",
8
  headers: { "Content-Type": "application/json" },
9
  body: JSON.stringify(body),
10
});
11
const data = await res.json();
12
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleMouseMove" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"00008030-001529902ED0402E","x":166,"y":193}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"00008030-001529902ED0402E\",\"x\":166,\"y\":193}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleMouseMove", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» x	body	integer	是	x坐标	none
» y	body	integer	是	y坐标	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

鼠标归零

POST /openapi/bleResetZero

将鼠标移回屏幕右上角原点 (0, 0)。适配 EC iOS USB 9.20.0+。

请求 Body

1
{
2
    "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d"
3
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d"
5
}
6
r = requests.post("http://127.0.0.1:8019/openapi/bleResetZero", json=body, timeout=30)
7
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d"
3
};
4
const res = await fetch("http://127.0.0.1:8019/openapi/bleResetZero", {
5
  method: "POST",
6
  headers: { "Content-Type": "application/json" },
7
  body: JSON.stringify(body),
8
});
9
const data = await res.json();
10
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleResetZero" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d"}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\"}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleResetZero", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

开关软键盘

POST /openapi/bleToggleSoftKeyboard

尝试开关软键盘。部分旧机型（如 iPhone 7）在蓝牙连接后输入框无法弹出软键盘，可配合脱机主程序输入时使用；较新机型通常不需要。若不使用脱机主程序作为输入法，可忽略本接口。适配 EC iOS USB 9.20.0+。

请求 Body

1
{
2
      "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d"
3
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d"
5
}
6
r = requests.post("http://127.0.0.1:8019/openapi/bleToggleSoftKeyboard", json=body, timeout=30)
7
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d"
3
};
4
const res = await fetch("http://127.0.0.1:8019/openapi/bleToggleSoftKeyboard", {
5
  method: "POST",
6
  headers: { "Content-Type": "application/json" },
7
  body: JSON.stringify(body),
8
});
9
const data = await res.json();
10
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleToggleSoftKeyboard" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d"}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\"}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleToggleSoftKeyboard", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

按下坐标点

POST /openapi/bleTouchDown

在指定坐标按下。适配 EC iOS USB 9.20.0+。

参数：x / y 为坐标。

请求 Body

1
{
2
    "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
    "x": 200,
4
    "y": 300
5
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
5
  "x": 200,
6
  "y": 300
7
}
8
r = requests.post("http://127.0.0.1:8019/openapi/bleTouchDown", json=body, timeout=30)
9
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
  "x": 200,
4
  "y": 300
5
};
6
const res = await fetch("http://127.0.0.1:8019/openapi/bleTouchDown", {
7
  method: "POST",
8
  headers: { "Content-Type": "application/json" },
9
  body: JSON.stringify(body),
10
});
11
const data = await res.json();
12
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleTouchDown" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d","x":200,"y":300}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\",\"x\":200,\"y\":300}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleTouchDown", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» x	body	integer	是	x坐标	none
» y	body	integer	是	y坐标	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

移动坐标点

POST /openapi/bleTouchMove

在按住状态下移动到指定坐标。适配 EC iOS USB 9.20.0+。

参数：x / y 为坐标。

请求 Body

1
{
2
    "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
    "x": 300,
4
    "y": 400
5
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
5
  "x": 300,
6
  "y": 400
7
}
8
r = requests.post("http://127.0.0.1:8019/openapi/bleTouchMove", json=body, timeout=30)
9
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
  "x": 300,
4
  "y": 400
5
};
6
const res = await fetch("http://127.0.0.1:8019/openapi/bleTouchMove", {
7
  method: "POST",
8
  headers: { "Content-Type": "application/json" },
9
  body: JSON.stringify(body),
10
});
11
const data = await res.json();
12
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleTouchMove" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d","x":300,"y":400}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\",\"x\":300,\"y\":400}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleTouchMove", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» x	body	integer	是	x坐标	none
» y	body	integer	是	y坐标	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

抬起坐标点

POST /openapi/bleTouchUp

在指定坐标抬起。适配 EC iOS USB 9.20.0+。

参数：x / y 为坐标。

请求 Body

1
{
2
    "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
    "x": 200,
4
    "y": 300
5
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
5
  "x": 200,
6
  "y": 300
7
}
8
r = requests.post("http://127.0.0.1:8019/openapi/bleTouchUp", json=body, timeout=30)
9
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
  "x": 200,
4
  "y": 300
5
};
6
const res = await fetch("http://127.0.0.1:8019/openapi/bleTouchUp", {
7
  method: "POST",
8
  headers: { "Content-Type": "application/json" },
9
  body: JSON.stringify(body),
10
});
11
const data = await res.json();
12
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleTouchUp" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d","x":200,"y":300}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\",\"x\":200,\"y\":300}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleTouchUp", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» x	body	integer	是	x坐标	none
» y	body	integer	是	y坐标	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

长按坐标

POST /openapi/blePress

长按指定坐标。适配 EC iOS USB 9.20.0+。

参数：x / y 为坐标，delay 为长按时长（毫秒）。

请求 Body

1
{
2
    "deviceId": "00008030-001529902ED0402E",
3
    "x": 300,
4
    "y": 400,
5
    "delay": 5000
6
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "00008030-001529902ED0402E",
5
  "x": 300,
6
  "y": 400,
7
  "delay": 5000
8
}
9
r = requests.post("http://127.0.0.1:8019/openapi/blePress", json=body, timeout=30)
10
print(r.json())

1
const body = {
2
  "deviceId": "00008030-001529902ED0402E",
3
  "x": 300,
4
  "y": 400,
5
  "delay": 5000
6
};
7
const res = await fetch("http://127.0.0.1:8019/openapi/blePress", {
8
  method: "POST",
9
  headers: { "Content-Type": "application/json" },
10
  body: JSON.stringify(body),
11
});
12
const data = await res.json();
13
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/blePress" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"00008030-001529902ED0402E","x":300,"y":400,"delay":5000}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"00008030-001529902ED0402E\",\"x\":300,\"y\":400,\"delay\":5000}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/blePress", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» x	body	integer	是	x坐标	none
» y	body	integer	是	y坐标	none
» delay	body	integer	是	长按时间毫秒	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

双击坐标

POST /openapi/bleDoubleClickPoint

双击指定坐标。适配 EC iOS USB 9.20.0+。

参数：x / y 为坐标。

请求 Body

1
{
2
    "deviceId": "00008030-001529902ED0402E",
3
    "x": 494,
4
    "y": 671
5
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "00008030-001529902ED0402E",
5
  "x": 494,
6
  "y": 671
7
}
8
r = requests.post("http://127.0.0.1:8019/openapi/bleDoubleClickPoint", json=body, timeout=30)
9
print(r.json())

1
const body = {
2
  "deviceId": "00008030-001529902ED0402E",
3
  "x": 494,
4
  "y": 671
5
};
6
const res = await fetch("http://127.0.0.1:8019/openapi/bleDoubleClickPoint", {
7
  method: "POST",
8
  headers: { "Content-Type": "application/json" },
9
  body: JSON.stringify(body),
10
});
11
const data = await res.json();
12
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleDoubleClickPoint" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"00008030-001529902ED0402E","x":494,"y":671}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"00008030-001529902ED0402E\",\"x\":494,\"y\":671}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleDoubleClickPoint", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» x	body	integer	是	x坐标	none
» y	body	integer	是	y坐标	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

滑动

POST /openapi/bleSwipeToPoint

从起点滑动到终点。适配 EC iOS USB 9.20.0+。

参数：startX / startY 为起点，endX / endY 为终点，duration 为持续时长（毫秒）。

请求 Body

1
{
2
    "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
    "x": 94,
4
    "y": 67,
5
    "ex": 264,
6
    "ey": 265,
7
    "duration": 1000
8
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
5
  "x": 94,
6
  "y": 67,
7
  "ex": 264,
8
  "ey": 265,
9
  "duration": 1000
10
}
11
r = requests.post("http://127.0.0.1:8019/openapi/bleSwipeToPoint", json=body, timeout=30)
12
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
  "x": 94,
4
  "y": 67,
5
  "ex": 264,
6
  "ey": 265,
7
  "duration": 1000
8
};
9
const res = await fetch("http://127.0.0.1:8019/openapi/bleSwipeToPoint", {
10
  method: "POST",
11
  headers: { "Content-Type": "application/json" },
12
  body: JSON.stringify(body),
13
});
14
const data = await res.json();
15
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleSwipeToPoint" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d","x":94,"y":67,"ex":264,"ey":265,"duration":1000}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\",\"x\":94,\"y\":67,\"ex\":264,\"ey\":265,\"duration\":1000}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleSwipeToPoint", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» x	body	integer	是	x坐标	none
» y	body	integer	是	y坐标	none
» ex	body	integer	是	结束x坐标	none
» ey	body	integer	是	结束y坐标	none
» duration	body	integer	否	持续时长单位毫秒	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

系统按键

POST /openapi/bleSystemKey

触发系统按键。适配 EC iOS USB 9.20.0+。

参数：key 目前支持 home、recents（最近任务）。

请求 Body

1
{
2
    "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
    "key": "recents"
4
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
5
  "key": "recents"
6
}
7
r = requests.post("http://127.0.0.1:8019/openapi/bleSystemKey", json=body, timeout=30)
8
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
  "key": "recents"
4
};
5
const res = await fetch("http://127.0.0.1:8019/openapi/bleSystemKey", {
6
  method: "POST",
7
  headers: { "Content-Type": "application/json" },
8
  body: JSON.stringify(body),
9
});
10
const data = await res.json();
11
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleSystemKey" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d","key":"recents"}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\",\"key\":\"recents\"}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleSystemKey", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» key	body	string	否	目前有 home	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

按键

POST /openapi/bleKeyPress

按键（ASCII 码）。适配 EC iOS USB 9.20.0+。

参数：prefix 为可选组合键（alt / ctrl / gui（Win 或 Command）/ r_ctrl / r_shift / shift，可空）；code 为整型 ASCII 码（如 65），可参考 ASCII 对照表。

请求 Body

1
{
2
   "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
    "prefix": "",
4
    "code": 9
5
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
5
  "prefix": "",
6
  "code": 9
7
}
8
r = requests.post("http://127.0.0.1:8019/openapi/bleKeyPress", json=body, timeout=30)
9
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
  "prefix": "",
4
  "code": 9
5
};
6
const res = await fetch("http://127.0.0.1:8019/openapi/bleKeyPress", {
7
  method: "POST",
8
  headers: { "Content-Type": "application/json" },
9
  body: JSON.stringify(body),
10
});
11
const data = await res.json();
12
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleKeyPress" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d","prefix":"","code":9}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\",\"prefix\":\"\",\"code\":9}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleKeyPress", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» prefix	body	string¦null	否	组合键，可以为空 alt=alt按键，ctrl=CTRL按键,gui=win或者command键，r_ctrl=右侧CTRL键，r_shift=右侧shift键，shift=shift键	none
» code	body	integer	是		none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

字符按键

POST /openapi/bleKeyPressChar

按字符键。适配 EC iOS USB 9.20.0+。

参数：prefix 为可选组合键（同「按键」接口）；code 为字符，例如 a。

请求 Body

1
{
2
    "deviceId": "00008030-001529902ED0402E",
3
    "prefix": "",
4
    "code": "4"
5
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "00008030-001529902ED0402E",
5
  "prefix": "",
6
  "code": "4"
7
}
8
r = requests.post("http://127.0.0.1:8019/openapi/bleKeyPressChar", json=body, timeout=30)
9
print(r.json())

1
const body = {
2
  "deviceId": "00008030-001529902ED0402E",
3
  "prefix": "",
4
  "code": "4"
5
};
6
const res = await fetch("http://127.0.0.1:8019/openapi/bleKeyPressChar", {
7
  method: "POST",
8
  headers: { "Content-Type": "application/json" },
9
  body: JSON.stringify(body),
10
});
11
const data = await res.json();
12
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleKeyPressChar" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"00008030-001529902ED0402E","prefix":"","code":"4"}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"00008030-001529902ED0402E\",\"prefix\":\"\",\"code\":\"4\"}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleKeyPressChar", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» prefix	body	string¦null	否	组合键，可以为空 alt=alt按键，ctrl=CTRL按键,gui=win或者command键，r_ctrl=右侧CTRL键，r_shift=右侧shift键，shift=shift键	none
» code	body	string	是	字符，例如 a	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none

多点触摸

POST /openapi/bleMultiTouch

多点触摸。适配 EC iOS USB 9.20.0+。

触摸点字段：

action：一般 0 按下、1 抬起、2 移动
x / y：坐标
pointer：第几个手指（1、2、3…）
delay：该动作延迟执行的毫秒数

参数：touch1 等为触摸点数组；timeout 为整段多点触摸超时（毫秒）。

请求 Body

1
{
2
    "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
    "finger1": [
4
        {
5
            "action": 0,
6
            "x": 500,
7
            "y": 200,
8
            "pointer": 1,
9
            "delay": 1
10
        },
11
        {
12
            "action": 2,
13
            "x": 500,
14
            "y": 200,
15
            "pointer": 1,
16
            "delay": 20
17
        },
18
        {
19
            "action": 2,
20
            "x": 500,
21
            "y": 300,
22
            "pointer": 1,
23
            "delay": 20
24
        }
25
    ],
26
    "delay": 10000
27
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
5
  "finger1": [
6
    {
7
      "action": 0,
8
      "x": 500,
9
      "y": 200,
10
      "pointer": 1,
11
      "delay": 1
12
    },
13
    {
14
      "action": 2,
15
      "x": 500,
16
      "y": 200,
17
      "pointer": 1,
18
      "delay": 20
19
    },
20
    {
21
      "action": 2,
22
      "x": 500,
23
      "y": 300,
24
      "pointer": 1,
25
      "delay": 20
26
    }
27
  ],
28
  "delay": 10000
29
}
30
r = requests.post("http://127.0.0.1:8019/openapi/bleMultiTouch", json=body, timeout=30)
31
print(r.json())

1
const body = {
2
  "deviceId": "90e2f3834c0977205e441aa664916a9bdde81e8d",
3
  "finger1": [
4
    {
5
      "action": 0,
6
      "x": 500,
7
      "y": 200,
8
      "pointer": 1,
9
      "delay": 1
10
    },
11
    {
12
      "action": 2,
13
      "x": 500,
14
      "y": 200,
15
      "pointer": 1,
16
      "delay": 20
17
    },
18
    {
19
      "action": 2,
20
      "x": 500,
21
      "y": 300,
22
      "pointer": 1,
23
      "delay": 20
24
    }
25
  ],
26
  "delay": 10000
27
};
28
const res = await fetch("http://127.0.0.1:8019/openapi/bleMultiTouch", {
29
  method: "POST",
30
  headers: { "Content-Type": "application/json" },
31
  body: JSON.stringify(body),
32
});
33
const data = await res.json();
34
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleMultiTouch" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"90e2f3834c0977205e441aa664916a9bdde81e8d","finger1":[{"action":0,"x":500,"y":200,"pointer":1,"delay":1},{"action":2,"x":500,"y":200,"pointer":1,"delay":20},{"action":2,"x":500,"y":300,"pointer":1,"delay":20}],"delay":10000}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"90e2f3834c0977205e441aa664916a9bdde81e8d\",\"finger1\":[{\"action\":0,\"x\":500,\"y\":200,\"pointer\":1,\"delay\":1},{\"action\":2,\"x\":500,\"y\":200,\"pointer\":1,\"delay\":20},{\"action\":2,\"x\":500,\"y\":300,\"pointer\":1,\"delay\":20}],\"delay\":10000}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleMultiTouch", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	否		none
» deviceId	body	string	是		设备ID
» finger1	body	[object]	是		手指1
»» action	body	integer	是		按下为0，弹起为1，移动为2
»» x	body	integer	是		X坐标
»» y	body	integer	是		Y坐标
»» pointer	body	integer	是		设置第几个手指触摸点，分别是 1，2，3等，代表第n个手指
»» delay	body	integer	是		该动作延迟多少毫秒执行，这个是值当前这个事件先延迟后执行
» delay	body	integer	是	这个没用，为了适配	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	true	none	0是成功	0 成功其他失败
» msg	string	true	none	错误信息	错误消息

设置步伐大小

POST /openapi/bleSetStep

设置鼠标移动步伐：每一步的最大步进值，值越大移动越快。适配 EC iOS USB 9.20.0+。

参数：step 建议范围 10–120，默认约 100。

请求 Body

1
{
2
    "deviceId": "00008030-001529902ED0402E",
3
    "step": 50
4
}

请求示例

1
import requests
2

3
body = {
4
  "deviceId": "00008030-001529902ED0402E",
5
  "step": 50
6
}
7
r = requests.post("http://127.0.0.1:8019/openapi/bleSetStep", json=body, timeout=30)
8
print(r.json())

1
const body = {
2
  "deviceId": "00008030-001529902ED0402E",
3
  "step": 50
4
};
5
const res = await fetch("http://127.0.0.1:8019/openapi/bleSetStep", {
6
  method: "POST",
7
  headers: { "Content-Type": "application/json" },
8
  body: JSON.stringify(body),
9
});
10
const data = await res.json();
11
console.log(data);

1
curl -s -X POST "http://127.0.0.1:8019/openapi/bleSetStep" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"00008030-001529902ED0402E","step":50}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
3
var json = "{\"deviceId\":\"00008030-001529902ED0402E\",\"step\":50}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/bleSetStep", content);
6
var text = await res.Content.ReadAsStringAsync();
7
Console.WriteLine(text);

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	是		none
» deviceId	body	string	是		none
» step	body	number	是	步伐大小，建议 10–120，默认约 100	none

返回示例

200 Response

1
{
2
  "code": 0,
3
  "msg": "string"
4
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	false	none	0是成功其他是失败	none
» msg	string	true	none	失败情况下的错误消息	none