ms-vite-plugin 1.3.0 → 1.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/docs/api/action.md +4 -2
- package/docs/api/device.md +47 -2
- package/docs/api/global.md +50 -16
- package/docs/api/hid.md +23 -2
- package/docs/api/http.md +2 -2
- package/docs/apicn/action.md +4 -2
- package/docs/apicn/device.md +47 -2
- package/docs/apicn/global.md +50 -16
- package/docs/apicn/hid.md +25 -2
- package/docs/apicn/http.md +3 -3
- package/docs/apipython/action.md +4 -2
- package/docs/apipython/device.md +46 -2
- package/docs/apipython/g.md +48 -1
- package/docs/apipython/hid.md +20 -2
- package/docs/httpapi/api.md +68 -1
- package/package.json +1 -1
package/docs/api/action.md
CHANGED
|
@@ -529,14 +529,16 @@ function completeTaskAndGoHome() {
|
|
|
529
529
|
### pressButton - 按下系统按钮
|
|
530
530
|
|
|
531
531
|
```typescript
|
|
532
|
-
function pressButton(
|
|
532
|
+
function pressButton(
|
|
533
|
+
button: "home" | "volumeup" | "volumedown" | "brightnessup" | "brightnessdown",
|
|
534
|
+
): boolean;
|
|
533
535
|
```
|
|
534
536
|
|
|
535
537
|
**参数说明:**
|
|
536
538
|
|
|
537
539
|
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
538
540
|
| -------- | ------ | -------- | ------ | ------------------------------------------------------------------------------------------ |
|
|
539
|
-
| `button` | string | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 |
|
|
541
|
+
| `button` | string | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 |
|
|
540
542
|
|
|
541
543
|
**返回值:**
|
|
542
544
|
|
package/docs/api/device.md
CHANGED
|
@@ -111,7 +111,6 @@ logi(`服务器设备ID: ${serverDeviceId}`);
|
|
|
111
111
|
|
|
112
112
|
### getECID - 获取设备 ECID。
|
|
113
113
|
|
|
114
|
-
|
|
115
114
|
```typescript
|
|
116
115
|
function getECID(): string;
|
|
117
116
|
```
|
|
@@ -132,7 +131,6 @@ logi(`ECID: ${ecid}`);
|
|
|
132
131
|
|
|
133
132
|
### getUDID - 获取设备 UDID。
|
|
134
133
|
|
|
135
|
-
|
|
136
134
|
```typescript
|
|
137
135
|
function getUDID(): string;
|
|
138
136
|
```
|
|
@@ -271,6 +269,53 @@ const scale = device.getScreenScale();
|
|
|
271
269
|
logi(`屏幕缩放比例: ${scale}`);
|
|
272
270
|
```
|
|
273
271
|
|
|
272
|
+
### getScreenBrightness - 获取屏幕亮度。
|
|
273
|
+
|
|
274
|
+
```typescript
|
|
275
|
+
function getScreenBrightness(): number;
|
|
276
|
+
```
|
|
277
|
+
|
|
278
|
+
**返回值:**
|
|
279
|
+
|
|
280
|
+
| 类型 | 描述 |
|
|
281
|
+
| -------- | ------------------------ |
|
|
282
|
+
| `number` | 屏幕亮度,范围 `0.0-1.0` |
|
|
283
|
+
|
|
284
|
+
**示例:**
|
|
285
|
+
|
|
286
|
+
```typescript
|
|
287
|
+
// 获取屏幕亮度
|
|
288
|
+
const brightness = device.getScreenBrightness();
|
|
289
|
+
logi(`屏幕亮度: ${brightness}`);
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
### setScreenBrightness - 设置屏幕亮度。
|
|
293
|
+
|
|
294
|
+
设置设备屏幕亮度,亮度范围为 `0.0-1.0`。
|
|
295
|
+
|
|
296
|
+
```typescript
|
|
297
|
+
function setScreenBrightness(brightness: number): boolean;
|
|
298
|
+
```
|
|
299
|
+
|
|
300
|
+
**参数说明:**
|
|
301
|
+
|
|
302
|
+
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
303
|
+
| ------------ | -------- | -------- | ------ | ---------------------------- |
|
|
304
|
+
| `brightness` | `number` | 是 | - | 目标屏幕亮度,范围 `0.0-1.0` |
|
|
305
|
+
|
|
306
|
+
**返回值:**
|
|
307
|
+
|
|
308
|
+
| 类型 | 描述 |
|
|
309
|
+
| --------- | ------------------------ |
|
|
310
|
+
| `boolean` | 是否设置成功 |
|
|
311
|
+
|
|
312
|
+
**示例:**
|
|
313
|
+
|
|
314
|
+
```typescript
|
|
315
|
+
// 设置屏幕亮度到 50%
|
|
316
|
+
device.setScreenBrightness(0.5);
|
|
317
|
+
```
|
|
318
|
+
|
|
274
319
|
### getOrientation - 获取屏幕方向。
|
|
275
320
|
|
|
276
321
|
**注意事项**
|
package/docs/api/global.md
CHANGED
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
- **脚本生命周期**: 设置停止回调、异常回调、重启脚本等
|
|
13
13
|
- **时间工具**: 获取时间戳
|
|
14
14
|
- **应用控制**: 切换应用到前台
|
|
15
|
+
- **Agent 设置**: 读取和设置 Agent 快速模式
|
|
15
16
|
|
|
16
17
|
## 全局常量
|
|
17
18
|
|
|
@@ -31,22 +32,6 @@ declare const __runMode__: "agent" | "hid";
|
|
|
31
32
|
logi(`运行模式: ${__runMode__}`);
|
|
32
33
|
```
|
|
33
34
|
|
|
34
|
-
### 是否使用内置Agent
|
|
35
|
-
|
|
36
|
-
#### **isSupportBuiltAgent**
|
|
37
|
-
|
|
38
|
-
是否使用内置 Agent。
|
|
39
|
-
|
|
40
|
-
```typescript
|
|
41
|
-
declare const __isSupportBuiltAgent__: boolean;
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
**示例:**
|
|
45
|
-
|
|
46
|
-
```javascript
|
|
47
|
-
logi(`是否使用内置Agent: ${__isSupportBuiltAgent__}`);
|
|
48
|
-
```
|
|
49
|
-
|
|
50
35
|
### 调试和状态
|
|
51
36
|
|
|
52
37
|
#### **debug**
|
|
@@ -308,6 +293,55 @@ takeMeToFront();
|
|
|
308
293
|
logi("应用已切换到前台");
|
|
309
294
|
```
|
|
310
295
|
|
|
296
|
+
### setAgentFastMode
|
|
297
|
+
|
|
298
|
+
设置 Agent 快速模式。快速模式默认开启,设置会持久化。开启后,Agent 执行动作响应更快,但开始执行时电量可能快速消耗。
|
|
299
|
+
|
|
300
|
+
```typescript
|
|
301
|
+
function setAgentFastMode(enabled: boolean): boolean;
|
|
302
|
+
```
|
|
303
|
+
|
|
304
|
+
**参数:**
|
|
305
|
+
|
|
306
|
+
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
307
|
+
| --------- | --------- | -------- | ------ | ---------------- |
|
|
308
|
+
| `enabled` | `boolean` | 是 | - | 是否开启快速模式 |
|
|
309
|
+
|
|
310
|
+
**返回值:**
|
|
311
|
+
|
|
312
|
+
| 类型 | 描述 |
|
|
313
|
+
| --------- | -------------------- |
|
|
314
|
+
| `boolean` | 实际是否开启快速模式 |
|
|
315
|
+
|
|
316
|
+
**示例:**
|
|
317
|
+
|
|
318
|
+
```javascript
|
|
319
|
+
const enabled = setAgentFastMode(true);
|
|
320
|
+
logi(`Agent 快速模式: ${enabled}`);
|
|
321
|
+
```
|
|
322
|
+
|
|
323
|
+
### getAgentFastMode
|
|
324
|
+
|
|
325
|
+
获取 Agent 快速模式当前状态。快速模式默认开启,设置会持久化。
|
|
326
|
+
|
|
327
|
+
```typescript
|
|
328
|
+
function getAgentFastMode(): boolean;
|
|
329
|
+
```
|
|
330
|
+
|
|
331
|
+
**返回值:**
|
|
332
|
+
|
|
333
|
+
| 类型 | 描述 |
|
|
334
|
+
| --------- | -------------------- |
|
|
335
|
+
| `boolean` | 当前是否开启快速模式 |
|
|
336
|
+
|
|
337
|
+
**示例:**
|
|
338
|
+
|
|
339
|
+
```javascript
|
|
340
|
+
if (getAgentFastMode()) {
|
|
341
|
+
logi("Agent 快速模式已开启");
|
|
342
|
+
}
|
|
343
|
+
```
|
|
344
|
+
|
|
311
345
|
### setStopCallback
|
|
312
346
|
|
|
313
347
|
设置停止回调函数(仅主线程调用)。
|
package/docs/api/hid.md
CHANGED
|
@@ -761,7 +761,22 @@ hid.enter();
|
|
|
761
761
|
|
|
762
762
|
```typescript
|
|
763
763
|
function pressButton(
|
|
764
|
-
button:
|
|
764
|
+
button:
|
|
765
|
+
| "home"
|
|
766
|
+
| "volumeup"
|
|
767
|
+
| "volumedown"
|
|
768
|
+
| "mute"
|
|
769
|
+
| "playpause"
|
|
770
|
+
| "next"
|
|
771
|
+
| "prev"
|
|
772
|
+
| "eject"
|
|
773
|
+
| "globe"
|
|
774
|
+
| "search"
|
|
775
|
+
| "brightnessup"
|
|
776
|
+
| "brightnessdown"
|
|
777
|
+
| "power"
|
|
778
|
+
| "menu"
|
|
779
|
+
| "snapshot",
|
|
765
780
|
): boolean;
|
|
766
781
|
```
|
|
767
782
|
|
|
@@ -769,7 +784,7 @@ function pressButton(
|
|
|
769
784
|
|
|
770
785
|
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
771
786
|
| -------- | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
|
|
772
|
-
| `button` | string | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"eject"` 显示/隐藏键盘 |
|
|
787
|
+
| `button` | string | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"menu"` Home/Menu 键 <br>- `"snapshot"` 系统截图键 |
|
|
773
788
|
|
|
774
789
|
**返回值:**
|
|
775
790
|
|
|
@@ -789,6 +804,12 @@ hid.pressButton("volumeup");
|
|
|
789
804
|
// 调低音量
|
|
790
805
|
hid.pressButton("volumedown");
|
|
791
806
|
|
|
807
|
+
// 调高屏幕亮度
|
|
808
|
+
hid.pressButton("brightnessup");
|
|
809
|
+
|
|
810
|
+
// 触发系统截图
|
|
811
|
+
hid.pressButton("snapshot");
|
|
812
|
+
|
|
792
813
|
// 连续调节音量
|
|
793
814
|
for (let i = 0; i < 5; i++) {
|
|
794
815
|
hid.pressButton("volumeup");
|
package/docs/api/http.md
CHANGED
|
@@ -13,7 +13,7 @@ function request(params: {
|
|
|
13
13
|
method?: string;
|
|
14
14
|
proxy?: { host: string; port: number };
|
|
15
15
|
followRedirects?: boolean;
|
|
16
|
-
requestBody?: string;
|
|
16
|
+
requestBody?: string | ArrayBuffer;
|
|
17
17
|
userAgent?: string;
|
|
18
18
|
ignoreContentType?: boolean;
|
|
19
19
|
ignoreHttpErrors?: boolean;
|
|
@@ -44,7 +44,7 @@ function request(params: {
|
|
|
44
44
|
| `method` | string | 否 | GET | 请求方法(GET、POST 等) |
|
|
45
45
|
| `proxy` | object | 否 | - | 代理服务器配置 |
|
|
46
46
|
| `followRedirects` | boolean | 否 | true | 是否跟随重定向 |
|
|
47
|
-
| `requestBody` | string
|
|
47
|
+
| `requestBody` | string \| ArrayBuffer | 否 | - | 请求体,JSON 对象需先 JSON.stringify |
|
|
48
48
|
| `userAgent` | string | 否 | - | 用户代理字符串 |
|
|
49
49
|
| `ignoreContentType` | boolean | 否 | false | 是否忽略内容类型 |
|
|
50
50
|
| `ignoreHttpErrors` | boolean | 否 | false | 是否忽略 HTTP 错误 |
|
package/docs/apicn/action.md
CHANGED
|
@@ -520,14 +520,16 @@ function completeTaskAndGoHome() {
|
|
|
520
520
|
### 按键 - 按下系统按钮
|
|
521
521
|
|
|
522
522
|
```typescript
|
|
523
|
-
function 按键(
|
|
523
|
+
function 按键(
|
|
524
|
+
按键: "home" | "volumeup" | "volumedown" | "brightnessup" | "brightnessdown",
|
|
525
|
+
): 布尔值;
|
|
524
526
|
```
|
|
525
527
|
|
|
526
528
|
**参数说明:**
|
|
527
529
|
|
|
528
530
|
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
529
531
|
| ------ | ------ | -------- | ------ | ------------------------------------------------------------------------------------------ |
|
|
530
|
-
| `按键` | 字符串 | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 |
|
|
532
|
+
| `按键` | 字符串 | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 |
|
|
531
533
|
|
|
532
534
|
**返回值:**
|
|
533
535
|
|
package/docs/apicn/device.md
CHANGED
|
@@ -111,7 +111,6 @@ $打印信息日志(`服务器设备ID: ${serverDeviceId}`);
|
|
|
111
111
|
|
|
112
112
|
### 获取 ECID
|
|
113
113
|
|
|
114
|
-
|
|
115
114
|
```typescript
|
|
116
115
|
function 获取ECID(): 字符串;
|
|
117
116
|
```
|
|
@@ -132,7 +131,6 @@ $打印信息日志(`ECID: ${ecid}`);
|
|
|
132
131
|
|
|
133
132
|
### 获取 UDID
|
|
134
133
|
|
|
135
|
-
|
|
136
134
|
```typescript
|
|
137
135
|
function 获取UDID(): 字符串;
|
|
138
136
|
```
|
|
@@ -285,6 +283,53 @@ const scale = $设备.获取屏幕缩放比例();
|
|
|
285
283
|
$打印信息日志(`屏幕缩放比例: ${scale}`);
|
|
286
284
|
```
|
|
287
285
|
|
|
286
|
+
### 获取屏幕亮度
|
|
287
|
+
|
|
288
|
+
```typescript
|
|
289
|
+
function 获取屏幕亮度(): 数字;
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
**返回值:**
|
|
293
|
+
|
|
294
|
+
| 类型 | 描述 |
|
|
295
|
+
| ---- | ------------------------ |
|
|
296
|
+
| 数字 | 屏幕亮度,范围 `0.0-1.0` |
|
|
297
|
+
|
|
298
|
+
**示例:**
|
|
299
|
+
|
|
300
|
+
```typescript
|
|
301
|
+
// 获取屏幕亮度
|
|
302
|
+
const 屏幕亮度 = $设备.获取屏幕亮度();
|
|
303
|
+
$打印信息日志(`屏幕亮度: ${屏幕亮度}`);
|
|
304
|
+
```
|
|
305
|
+
|
|
306
|
+
### 设置屏幕亮度
|
|
307
|
+
|
|
308
|
+
设置设备屏幕亮度,亮度范围为 `0.0-1.0`。
|
|
309
|
+
|
|
310
|
+
```typescript
|
|
311
|
+
function 设置屏幕亮度(亮度: 数字): 布尔值;
|
|
312
|
+
```
|
|
313
|
+
|
|
314
|
+
**参数说明:**
|
|
315
|
+
|
|
316
|
+
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
317
|
+
| ------ | ---- | -------- | ------ | ---------------------------- |
|
|
318
|
+
| `亮度` | 数字 | 是 | - | 目标屏幕亮度,范围 `0.0-1.0` |
|
|
319
|
+
|
|
320
|
+
**返回值:**
|
|
321
|
+
|
|
322
|
+
| 类型 | 描述 |
|
|
323
|
+
| ------ | ------------------------ |
|
|
324
|
+
| 布尔值 | 是否设置成功 |
|
|
325
|
+
|
|
326
|
+
**示例:**
|
|
327
|
+
|
|
328
|
+
```typescript
|
|
329
|
+
// 设置屏幕亮度到 50%
|
|
330
|
+
$设备.设置屏幕亮度(0.5);
|
|
331
|
+
```
|
|
332
|
+
|
|
288
333
|
### 获取屏幕方向
|
|
289
334
|
|
|
290
335
|
**注意事项**
|
package/docs/apicn/global.md
CHANGED
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
- **脚本生命周期**: 设置停止回调、异常回调、重启脚本等
|
|
13
13
|
- **时间工具**: 获取时间戳
|
|
14
14
|
- **应用控制**: 切换应用到前台
|
|
15
|
+
- **Agent 设置**: 读取和设置 Agent 快速模式
|
|
15
16
|
|
|
16
17
|
## 全局常量
|
|
17
18
|
|
|
@@ -33,22 +34,6 @@ declare const $运行模式: "agent" | "hid";
|
|
|
33
34
|
$打印信息日志(`运行模式: ${$运行模式}`);
|
|
34
35
|
```
|
|
35
36
|
|
|
36
|
-
### 是否使用内置Agent
|
|
37
|
-
|
|
38
|
-
#### **$是否内置Agent**
|
|
39
|
-
|
|
40
|
-
是否使用内置 Agent。
|
|
41
|
-
|
|
42
|
-
```typescript
|
|
43
|
-
declare const $是否内置Agent: 布尔值;
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
**示例:**
|
|
47
|
-
|
|
48
|
-
```javascript
|
|
49
|
-
$打印信息日志(`是否使用内置Agent: ${$是否内置Agent}`);
|
|
50
|
-
```
|
|
51
|
-
|
|
52
37
|
### 调试和状态
|
|
53
38
|
|
|
54
39
|
#### **$是否调试**
|
|
@@ -309,6 +294,55 @@ $APP切入前台();
|
|
|
309
294
|
$打印信息日志("应用已切换到前台");
|
|
310
295
|
```
|
|
311
296
|
|
|
297
|
+
### $设置 Agent 快速模式
|
|
298
|
+
|
|
299
|
+
设置 Agent 快速模式。快速模式默认开启,设置会持久化。开启后,Agent 执行动作响应更快,但开始执行时电量可能快速消耗。
|
|
300
|
+
|
|
301
|
+
```typescript
|
|
302
|
+
declare function $设置Agent快速模式(是否开启: 布尔值): 布尔值;
|
|
303
|
+
```
|
|
304
|
+
|
|
305
|
+
**参数:**
|
|
306
|
+
|
|
307
|
+
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
308
|
+
| ---------- | -------- | -------- | ------ | ---------------- |
|
|
309
|
+
| `是否开启` | `布尔值` | 是 | - | 是否开启快速模式 |
|
|
310
|
+
|
|
311
|
+
**返回值:**
|
|
312
|
+
|
|
313
|
+
| 类型 | 描述 |
|
|
314
|
+
| -------- | -------------------- |
|
|
315
|
+
| `布尔值` | 实际是否开启快速模式 |
|
|
316
|
+
|
|
317
|
+
**示例:**
|
|
318
|
+
|
|
319
|
+
```javascript
|
|
320
|
+
const 是否开启 = $设置Agent快速模式(true);
|
|
321
|
+
$打印信息日志(`Agent 快速模式: ${是否开启}`);
|
|
322
|
+
```
|
|
323
|
+
|
|
324
|
+
### $获取 Agent 快速模式
|
|
325
|
+
|
|
326
|
+
获取 Agent 快速模式当前状态。快速模式默认开启,设置会持久化。
|
|
327
|
+
|
|
328
|
+
```typescript
|
|
329
|
+
declare function $获取Agent快速模式(): 布尔值;
|
|
330
|
+
```
|
|
331
|
+
|
|
332
|
+
**返回值:**
|
|
333
|
+
|
|
334
|
+
| 类型 | 描述 |
|
|
335
|
+
| -------- | -------------------- |
|
|
336
|
+
| `布尔值` | 当前是否开启快速模式 |
|
|
337
|
+
|
|
338
|
+
**示例:**
|
|
339
|
+
|
|
340
|
+
```javascript
|
|
341
|
+
if ($获取Agent快速模式()) {
|
|
342
|
+
$打印信息日志("Agent 快速模式已开启");
|
|
343
|
+
}
|
|
344
|
+
```
|
|
345
|
+
|
|
312
346
|
### $设置停止回调
|
|
313
347
|
|
|
314
348
|
设置停止回调函数(仅主线程调用)。
|
package/docs/apicn/hid.md
CHANGED
|
@@ -760,14 +760,31 @@ $HID.回车键();
|
|
|
760
760
|
### 按键 - 按下系统按钮
|
|
761
761
|
|
|
762
762
|
```typescript
|
|
763
|
-
function 按键(
|
|
763
|
+
function 按键(
|
|
764
|
+
按键:
|
|
765
|
+
| "home"
|
|
766
|
+
| "volumeup"
|
|
767
|
+
| "volumedown"
|
|
768
|
+
| "mute"
|
|
769
|
+
| "playpause"
|
|
770
|
+
| "next"
|
|
771
|
+
| "prev"
|
|
772
|
+
| "eject"
|
|
773
|
+
| "globe"
|
|
774
|
+
| "search"
|
|
775
|
+
| "brightnessup"
|
|
776
|
+
| "brightnessdown"
|
|
777
|
+
| "power"
|
|
778
|
+
| "menu"
|
|
779
|
+
| "snapshot",
|
|
780
|
+
): 布尔值;
|
|
764
781
|
```
|
|
765
782
|
|
|
766
783
|
**参数说明:**
|
|
767
784
|
|
|
768
785
|
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
769
786
|
| ------ | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
|
|
770
|
-
| `按键` | 字符串 | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"eject"` 显示/隐藏键盘 |
|
|
787
|
+
| `按键` | 字符串 | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"menu"` Home/Menu 键 <br>- `"snapshot"` 系统截图键 |
|
|
771
788
|
|
|
772
789
|
**返回值:**
|
|
773
790
|
|
|
@@ -787,6 +804,12 @@ $HID.按键("volumeup");
|
|
|
787
804
|
// 调低音量
|
|
788
805
|
$HID.按键("volumedown");
|
|
789
806
|
|
|
807
|
+
// 调高屏幕亮度
|
|
808
|
+
$HID.按键("brightnessup");
|
|
809
|
+
|
|
810
|
+
// 触发系统截图
|
|
811
|
+
$HID.按键("snapshot");
|
|
812
|
+
|
|
790
813
|
// 连续调节音量
|
|
791
814
|
for (let i = 0; i < 5; i++) {
|
|
792
815
|
const 是否成功 = $HID.按键("volumeup");
|
package/docs/apicn/http.md
CHANGED
|
@@ -38,9 +38,9 @@ function 发送请求(params: {
|
|
|
38
38
|
*/
|
|
39
39
|
followRedirects?: 布尔值;
|
|
40
40
|
/**
|
|
41
|
-
*
|
|
41
|
+
* 请求体,支持字符串或二进制数据;JSON 对象需要先 JSON.stringify
|
|
42
42
|
*/
|
|
43
|
-
requestBody?:
|
|
43
|
+
requestBody?: 字符串 | ArrayBuffer;
|
|
44
44
|
/**
|
|
45
45
|
* 请求头
|
|
46
46
|
*/
|
|
@@ -122,7 +122,7 @@ function 发送请求(params: {
|
|
|
122
122
|
| `method` | 字符串 | 否 | GET | 请求方法(GET、POST 等) |
|
|
123
123
|
| `proxy` | 对象 | 否 | - | 代理服务器配置 |
|
|
124
124
|
| `followRedirects` | 布尔值 | 否 | true | 是否跟随重定向 |
|
|
125
|
-
| `requestBody` | 字符串
|
|
125
|
+
| `requestBody` | 字符串 \| ArrayBuffer | 否 | - | 请求体,JSON 对象需先 JSON.stringify |
|
|
126
126
|
| `userAgent` | 字符串 | 否 | - | 用户代理字符串 |
|
|
127
127
|
| `ignoreContentType` | 布尔值 | 否 | false | 是否忽略内容类型 |
|
|
128
128
|
| `ignoreHttpErrors` | 布尔值 | 否 | false | 是否忽略 HTTP 错误 |
|
package/docs/apipython/action.md
CHANGED
|
@@ -498,14 +498,16 @@ def completeTaskAndGoHome():
|
|
|
498
498
|
### pressButton - 按下系统按钮
|
|
499
499
|
|
|
500
500
|
```python
|
|
501
|
-
def pressButton(
|
|
501
|
+
def pressButton(
|
|
502
|
+
button: Literal["home", "volumeup", "volumedown", "brightnessup", "brightnessdown"],
|
|
503
|
+
) -> bool
|
|
502
504
|
```
|
|
503
505
|
|
|
504
506
|
**参数说明:**
|
|
505
507
|
|
|
506
508
|
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
507
509
|
| -------- | ------- | -------- | ------ | ------------------------------------------------------------------------------------------ |
|
|
508
|
-
| `button` | Literal | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 |
|
|
510
|
+
| `button` | Literal | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 |
|
|
509
511
|
|
|
510
512
|
**返回值:**
|
|
511
513
|
|
package/docs/apipython/device.md
CHANGED
|
@@ -115,7 +115,6 @@ print(device.getServerDeviceId())
|
|
|
115
115
|
|
|
116
116
|
### getECID - 获取设备 ECID。
|
|
117
117
|
|
|
118
|
-
|
|
119
118
|
```python
|
|
120
119
|
def getECID() -> str
|
|
121
120
|
```
|
|
@@ -135,7 +134,6 @@ print(device.getECID())
|
|
|
135
134
|
|
|
136
135
|
### getUDID - 获取设备 UDID。
|
|
137
136
|
|
|
138
|
-
|
|
139
137
|
```python
|
|
140
138
|
def getUDID() -> str
|
|
141
139
|
```
|
|
@@ -266,6 +264,52 @@ from kuaijs import device
|
|
|
266
264
|
print(device.getScreenScale())
|
|
267
265
|
```
|
|
268
266
|
|
|
267
|
+
### getScreenBrightness - 获取屏幕亮度。
|
|
268
|
+
|
|
269
|
+
```python
|
|
270
|
+
def getScreenBrightness() -> float
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
**返回值:**
|
|
274
|
+
|
|
275
|
+
| 类型 | 描述 |
|
|
276
|
+
| ------- | ------------------------ |
|
|
277
|
+
| `float` | 屏幕亮度,范围 `0.0-1.0` |
|
|
278
|
+
|
|
279
|
+
**示例:**
|
|
280
|
+
|
|
281
|
+
```python
|
|
282
|
+
from kuaijs import device
|
|
283
|
+
print(device.getScreenBrightness())
|
|
284
|
+
```
|
|
285
|
+
|
|
286
|
+
### setScreenBrightness - 设置屏幕亮度。
|
|
287
|
+
|
|
288
|
+
设置设备屏幕亮度,亮度范围为 `0.0-1.0`。
|
|
289
|
+
|
|
290
|
+
```python
|
|
291
|
+
def setScreenBrightness(brightness: float) -> bool
|
|
292
|
+
```
|
|
293
|
+
|
|
294
|
+
**参数说明:**
|
|
295
|
+
|
|
296
|
+
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
297
|
+
| ------------ | ------- | -------- | ------ | ---------------------------- |
|
|
298
|
+
| `brightness` | `float` | 是 | - | 目标屏幕亮度,范围 `0.0-1.0` |
|
|
299
|
+
|
|
300
|
+
**返回值:**
|
|
301
|
+
|
|
302
|
+
| 类型 | 描述 |
|
|
303
|
+
| ------ | ------------------------ |
|
|
304
|
+
| `bool` | 是否设置成功 |
|
|
305
|
+
|
|
306
|
+
**示例:**
|
|
307
|
+
|
|
308
|
+
```python
|
|
309
|
+
from kuaijs import device
|
|
310
|
+
device.setScreenBrightness(0.5)
|
|
311
|
+
```
|
|
312
|
+
|
|
269
313
|
### getOrientation - 获取屏幕方向。
|
|
270
314
|
|
|
271
315
|
**注意事项:**
|
package/docs/apipython/g.md
CHANGED
|
@@ -6,11 +6,11 @@
|
|
|
6
6
|
|
|
7
7
|
- 应用信息常量:版本号/构建号/名称/包名
|
|
8
8
|
- 前台切换:将宿主应用切到前台
|
|
9
|
+
- Agent 设置:读取和设置 Agent 快速模式
|
|
9
10
|
|
|
10
11
|
## 常量
|
|
11
12
|
|
|
12
13
|
- `runMode: str` 运行模式,"agent" 或 "hid"
|
|
13
|
-
- `isSupportBuiltAgent: bool` 是否使用内置Agent
|
|
14
14
|
- `platform: str` 平台信息("ios" 或 "android")
|
|
15
15
|
- `appVersion: str` 应用版本号
|
|
16
16
|
- `appBuildNumber: int` 应用构建号
|
|
@@ -54,6 +54,53 @@ from kuaijs import g
|
|
|
54
54
|
g.takeMeToFront()
|
|
55
55
|
```
|
|
56
56
|
|
|
57
|
+
#### `setAgentFastMode` - 设置 Agent 快速模式
|
|
58
|
+
|
|
59
|
+
快速模式默认开启,设置会持久化。开启后,Agent 执行动作响应更快,但开始执行时电量可能快速消耗。
|
|
60
|
+
|
|
61
|
+
```python
|
|
62
|
+
def setAgentFastMode(enabled: bool) -> bool
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
**参数:**
|
|
66
|
+
| 参数 | 类型 | 必需 | 默认值 | 描述 |
|
|
67
|
+
| ---- | ---- | ---- | ------ | ---- |
|
|
68
|
+
| `enabled` | bool | 是 | - | 是否开启快速模式 |
|
|
69
|
+
|
|
70
|
+
**返回值:**
|
|
71
|
+
|
|
72
|
+
- `bool` 实际是否开启快速模式
|
|
73
|
+
|
|
74
|
+
**示例:**
|
|
75
|
+
|
|
76
|
+
```python
|
|
77
|
+
from kuaijs import g
|
|
78
|
+
|
|
79
|
+
enabled = g.setAgentFastMode(True)
|
|
80
|
+
print(f"Agent 快速模式: {enabled}")
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
#### `getAgentFastMode` - 获取 Agent 快速模式
|
|
84
|
+
|
|
85
|
+
快速模式默认开启,设置会持久化。
|
|
86
|
+
|
|
87
|
+
```python
|
|
88
|
+
def getAgentFastMode() -> bool
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
**返回值:**
|
|
92
|
+
|
|
93
|
+
- `bool` 当前是否开启快速模式
|
|
94
|
+
|
|
95
|
+
**示例:**
|
|
96
|
+
|
|
97
|
+
```python
|
|
98
|
+
from kuaijs import g
|
|
99
|
+
|
|
100
|
+
if g.getAgentFastMode():
|
|
101
|
+
print("Agent 快速模式已开启")
|
|
102
|
+
```
|
|
103
|
+
|
|
57
104
|
#### `restartScript` - 重启脚本
|
|
58
105
|
|
|
59
106
|
```python
|
package/docs/apipython/hid.md
CHANGED
|
@@ -785,14 +785,32 @@ hid.enter()
|
|
|
785
785
|
### pressButton - 按下系统按钮
|
|
786
786
|
|
|
787
787
|
```python
|
|
788
|
-
def pressButton(
|
|
788
|
+
def pressButton(
|
|
789
|
+
button: Literal[
|
|
790
|
+
"home",
|
|
791
|
+
"volumeup",
|
|
792
|
+
"volumedown",
|
|
793
|
+
"mute",
|
|
794
|
+
"playpause",
|
|
795
|
+
"next",
|
|
796
|
+
"prev",
|
|
797
|
+
"eject",
|
|
798
|
+
"globe",
|
|
799
|
+
"search",
|
|
800
|
+
"brightnessup",
|
|
801
|
+
"brightnessdown",
|
|
802
|
+
"power",
|
|
803
|
+
"menu",
|
|
804
|
+
"snapshot",
|
|
805
|
+
],
|
|
806
|
+
) -> bool
|
|
789
807
|
```
|
|
790
808
|
|
|
791
809
|
**参数说明:**
|
|
792
810
|
|
|
793
811
|
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
794
812
|
| -------- | ------- | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
|
|
795
|
-
| `button` | Literal | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"eject"` 显示/隐藏键盘 |
|
|
813
|
+
| `button` | Literal | 是 | - | 按钮类型: <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"menu"` Home/Menu 键 <br>- `"snapshot"` 系统截图键 |
|
|
796
814
|
|
|
797
815
|
**返回值:**
|
|
798
816
|
|
package/docs/httpapi/api.md
CHANGED
|
@@ -1562,6 +1562,74 @@ GET /api/control/openURL
|
|
|
1562
1562
|
|---|---|---|---|---|---|
|
|
1563
1563
|
|» success|boolean|true|none|是否成功|none|
|
|
1564
1564
|
|
|
1565
|
+
## GET 设置 Agent 快速模式
|
|
1566
|
+
|
|
1567
|
+
GET /api/control/setAgentFastMode
|
|
1568
|
+
|
|
1569
|
+
快速模式默认开启,设置会持久化。开启后,Agent 执行动作响应更快,但开始执行时电量可能快速消耗。
|
|
1570
|
+
|
|
1571
|
+
### 请求参数
|
|
1572
|
+
|
|
1573
|
+
|名称|位置|类型|必选|中文名|说明|
|
|
1574
|
+
|---|---|---|---|---|---|
|
|
1575
|
+
|enabled|query|boolean| 是 |是否开启|是否开启 Agent 快速模式|
|
|
1576
|
+
|
|
1577
|
+
> 返回示例
|
|
1578
|
+
|
|
1579
|
+
> 200 Response
|
|
1580
|
+
|
|
1581
|
+
```json
|
|
1582
|
+
{
|
|
1583
|
+
"success": true,
|
|
1584
|
+
"data": true
|
|
1585
|
+
}
|
|
1586
|
+
```
|
|
1587
|
+
|
|
1588
|
+
### 返回结果
|
|
1589
|
+
|
|
1590
|
+
|状态码|状态码含义|说明|数据模型|
|
|
1591
|
+
|---|---|---|---|
|
|
1592
|
+
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
|
|
1593
|
+
|
|
1594
|
+
### 返回数据结构
|
|
1595
|
+
|
|
1596
|
+
状态码 **200**
|
|
1597
|
+
|
|
1598
|
+
|名称|类型|必选|约束|中文名|说明|
|
|
1599
|
+
|---|---|---|---|---|---|
|
|
1600
|
+
|» success|boolean|true|none|是否成功|none|
|
|
1601
|
+
|» data|boolean|true|none|Agent 快速模式|设置后的 Agent 快速模式状态|
|
|
1602
|
+
|
|
1603
|
+
## GET 获取 Agent 快速模式
|
|
1604
|
+
|
|
1605
|
+
GET /api/control/getAgentFastMode
|
|
1606
|
+
|
|
1607
|
+
### 返回示例
|
|
1608
|
+
|
|
1609
|
+
> 200 Response
|
|
1610
|
+
|
|
1611
|
+
```json
|
|
1612
|
+
{
|
|
1613
|
+
"success": true,
|
|
1614
|
+
"data": true
|
|
1615
|
+
}
|
|
1616
|
+
```
|
|
1617
|
+
|
|
1618
|
+
### 返回结果
|
|
1619
|
+
|
|
1620
|
+
|状态码|状态码含义|说明|数据模型|
|
|
1621
|
+
|---|---|---|---|
|
|
1622
|
+
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
|
|
1623
|
+
|
|
1624
|
+
### 返回数据结构
|
|
1625
|
+
|
|
1626
|
+
状态码 **200**
|
|
1627
|
+
|
|
1628
|
+
|名称|类型|必选|约束|中文名|说明|
|
|
1629
|
+
|---|---|---|---|---|---|
|
|
1630
|
+
|» success|boolean|true|none|是否成功|none|
|
|
1631
|
+
|» data|boolean|true|none|Agent 快速模式|当前 Agent 快速模式状态|
|
|
1632
|
+
|
|
1565
1633
|
## POST W3CActions
|
|
1566
1634
|
|
|
1567
1635
|
POST /api/control/w3cActions
|
|
@@ -2408,4 +2476,3 @@ GET /api/hid/mouseUp
|
|
|
2408
2476
|
|orientation|LANDSCAPE|
|
|
2409
2477
|
|serverType|international|
|
|
2410
2478
|
|serverType|domestic|
|
|
2411
|
-
|