ms-vite-plugin 1.4.43 → 1.4.46
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/dotocr.md +116 -43
- package/docs/api/global.md +70 -15
- package/docs/api/node.md +29 -27
- package/docs/apicn/dotocr.md +120 -48
- package/docs/apicn/global.md +65 -10
- package/docs/apicn/node.md +29 -27
- package/docs/apipython/dotocr.md +121 -47
- package/docs/apipython/g.md +74 -23
- package/docs/apipython/node.md +29 -26
- package/docs/httpapi/api.md +190 -189
- package/package.json +1 -1
package/docs/api/dotocr.md
CHANGED
|
@@ -1,71 +1,100 @@
|
|
|
1
|
-
# 点阵 OCR
|
|
1
|
+
# 点阵 OCR 模块 (dotOcr)
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
点阵 OCR 模块基于图色工具生成的固定像素点阵字库，提供精确的文字识别与查找功能。字库保存在项目的 `res/fonts` 目录，使用前需先加载字库取得字库 ID，再复用该 ID 进行识别，使用完毕后释放。
|
|
4
4
|
|
|
5
5
|
点阵模板按照制作时的原始像素尺寸匹配，不会自动缩放到其他分辨率。目标文字的字号、缩放比例或像素形状发生变化时，应制作对应的字库特征。
|
|
6
6
|
|
|
7
7
|
## 功能概览
|
|
8
8
|
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
-
|
|
13
|
-
-
|
|
9
|
+
- **字库管理**: 加载、缓存和释放项目字库
|
|
10
|
+
- **文字识别**: 返回按阅读顺序排列的识别结果数组
|
|
11
|
+
- **文本查找**: 先识别再按行定位目标串，返回命中位置的绝对坐标
|
|
12
|
+
- **多源输入**: 支持屏幕截图、图片文件、URL 或 imageId
|
|
13
|
+
- **区域识别**: 支持指定区域的精确文字识别
|
|
14
|
+
- **绝对坐标**: 裁剪区域内的结果会映射回原图或全屏坐标
|
|
15
|
+
- **资源控制**: 完整的字库生命周期管理
|
|
14
16
|
|
|
15
17
|
## 数据类型
|
|
16
18
|
|
|
17
19
|
### OCRChar
|
|
18
20
|
|
|
21
|
+
识别结果的数据结构，包含完整的文本信息和位置数据：
|
|
22
|
+
|
|
19
23
|
```typescript
|
|
20
24
|
interface OCRChar {
|
|
25
|
+
/** 识别的文本内容 */
|
|
21
26
|
text: string;
|
|
27
|
+
/** 识别置信度 (0-1) */
|
|
22
28
|
confidence: number;
|
|
29
|
+
/** 文本区域左上角 x 坐标 */
|
|
23
30
|
x: number;
|
|
31
|
+
/** 文本区域左上角 y 坐标 */
|
|
24
32
|
y: number;
|
|
33
|
+
/** 文本区域右下角 x 坐标 */
|
|
25
34
|
ex: number;
|
|
35
|
+
/** 文本区域右下角 y 坐标 */
|
|
26
36
|
ey: number;
|
|
37
|
+
/** 文本区域宽度 */
|
|
27
38
|
width: number;
|
|
39
|
+
/** 文本区域高度 */
|
|
28
40
|
height: number;
|
|
41
|
+
/** 文本区域中心点 x 坐标 */
|
|
29
42
|
centerX: number;
|
|
43
|
+
/** 文本区域中心点 y 坐标 */
|
|
30
44
|
centerY: number;
|
|
31
45
|
}
|
|
32
46
|
```
|
|
33
47
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
|
37
|
-
|
|
|
38
|
-
| `
|
|
39
|
-
| `
|
|
40
|
-
| `
|
|
41
|
-
| `
|
|
48
|
+
**数据结构说明：**
|
|
49
|
+
|
|
50
|
+
| 字段 | 类型 | 描述 |
|
|
51
|
+
| ------------------ | ------ | -------------------------------------------------------- |
|
|
52
|
+
| `text` | string | 识别出的文本内容；查找结果中为命中的目标字符串 |
|
|
53
|
+
| `confidence` | number | 识别置信度，范围 0-1，值越高表示识别越准确 |
|
|
54
|
+
| `x, y, ex, ey` | number | 文本区域的坐标，分别为左上角和右下角的 x、y 绝对坐标 |
|
|
55
|
+
| `width, height` | number | 文本区域的宽度和高度 |
|
|
56
|
+
| `centerX, centerY` | number | 文本区域的中心点绝对坐标 |
|
|
42
57
|
|
|
43
58
|
## API 参考
|
|
44
59
|
|
|
45
60
|
### 字库管理
|
|
46
61
|
|
|
47
|
-
#### loadFont -
|
|
62
|
+
#### loadFont - 加载并缓存点阵字库。
|
|
63
|
+
|
|
64
|
+
加载字库是使用点阵识别功能的前提。建议在脚本初始化时加载一次并保存 `fontId`，后续识别时复用，不要每次识别都重新加载。
|
|
48
65
|
|
|
49
66
|
```typescript
|
|
50
67
|
function loadFont(fontPath: string): string | null;
|
|
51
68
|
```
|
|
52
69
|
|
|
70
|
+
**参数:**
|
|
71
|
+
|
|
53
72
|
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
54
73
|
| ---------- | ------ | -------- | ------ | --------------------------------------------------------------------------- |
|
|
55
74
|
| `fontPath` | string | 是 | | 资源路径，运行时会自动处理 `res` 目录解析；常见写法如 `/fonts/default.json` |
|
|
56
75
|
|
|
57
|
-
|
|
76
|
+
**返回值:**
|
|
77
|
+
|
|
78
|
+
| 类型 | 描述 |
|
|
79
|
+
| ---------------- | ----------------------------------------- |
|
|
80
|
+
| `string \| null` | 加载成功返回字库 ID 字符串，失败返回 null |
|
|
81
|
+
|
|
82
|
+
**示例:**
|
|
58
83
|
|
|
59
84
|
```javascript
|
|
60
85
|
const fontId = dotOcr.loadFont("/fonts/default.json");
|
|
61
|
-
if (!fontId)
|
|
86
|
+
if (!fontId) {
|
|
87
|
+
logi("字库加载失败");
|
|
88
|
+
return;
|
|
89
|
+
}
|
|
90
|
+
logi(`字库加载成功: ${fontId}`);
|
|
62
91
|
```
|
|
63
92
|
|
|
64
|
-
建议在脚本初始化时加载一次并保存 `fontId`，后续识别时复用，不要每次识别都重新加载。
|
|
65
|
-
|
|
66
93
|
### 文字识别
|
|
67
94
|
|
|
68
|
-
#### recognizeAbs -
|
|
95
|
+
#### recognizeAbs - 执行点阵 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
|
|
96
|
+
|
|
97
|
+
传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。结果按行从上到下、同一行从左到右排列。颜色按字库各字自带的前景色/偏色匹配，无需额外传色。
|
|
69
98
|
|
|
70
99
|
```typescript
|
|
71
100
|
function recognizeAbs(
|
|
@@ -75,28 +104,44 @@ function recognizeAbs(
|
|
|
75
104
|
y?: number,
|
|
76
105
|
ex?: number,
|
|
77
106
|
ey?: number,
|
|
78
|
-
confidenceThreshold?: number
|
|
107
|
+
confidenceThreshold?: number,
|
|
79
108
|
): OCRChar[];
|
|
80
109
|
```
|
|
81
110
|
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
|
85
|
-
|
|
|
86
|
-
| `
|
|
87
|
-
| `
|
|
88
|
-
| `
|
|
111
|
+
**参数:**
|
|
112
|
+
|
|
113
|
+
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
114
|
+
| --------------------- | ------ | -------- | ------ | --------------------------------------------------------------------------------------------- |
|
|
115
|
+
| `fontId` | string | 是 | | 字库 ID，通过 `loadFont` 获取 |
|
|
116
|
+
| `input` | string | 是 | | 输入源，支持 `"screen"`、图片文件路径、URL 或 imageId |
|
|
117
|
+
| `x` | number | 否 | 0 | 裁剪区域左上角 x 坐标；全屏识别传 0 |
|
|
118
|
+
| `y` | number | 否 | 0 | 裁剪区域左上角 y 坐标；全屏识别传 0 |
|
|
119
|
+
| `ex` | number | 否 | 0 | 裁剪区域右下角 x 坐标；全屏识别传 0；为 0 时使用图像宽度 |
|
|
120
|
+
| `ey` | number | 否 | 0 | 裁剪区域右下角 y 坐标；全屏识别传 0；为 0 时使用图像高度 |
|
|
121
|
+
| `confidenceThreshold` | number | 否 | 0.8 | 相似度下限；`<=0` 时按 `0.8`；低于阈值的字符会被过滤；`>0.95` 时要求像素完全一致 |
|
|
89
122
|
|
|
90
|
-
|
|
123
|
+
**返回值:**
|
|
124
|
+
|
|
125
|
+
| 类型 | 描述 |
|
|
126
|
+
| ----------- | ---------------------------------------------- |
|
|
127
|
+
| `OCRChar[]` | 识别结果数组，坐标为原图或全屏绝对坐标 |
|
|
128
|
+
|
|
129
|
+
**示例:**
|
|
91
130
|
|
|
92
131
|
```javascript
|
|
93
132
|
const chars = dotOcr.recognizeAbs(fontId, "screen", 100, 200, 600, 280, 0.8);
|
|
94
|
-
|
|
133
|
+
logi(`识别数量: ${chars.length}`);
|
|
134
|
+
if (chars.length > 0) {
|
|
135
|
+
logi(`文本: ${chars[0].text}, 坐标: (${chars[0].x}, ${chars[0].y})`);
|
|
136
|
+
action.click(chars[0].centerX, chars[0].centerY);
|
|
137
|
+
}
|
|
95
138
|
```
|
|
96
139
|
|
|
97
140
|
### 文本查找
|
|
98
141
|
|
|
99
|
-
#### findTextAbs -
|
|
142
|
+
#### findTextAbs - 查找目标文本，并将结果坐标映射为原图/全屏绝对坐标。
|
|
143
|
+
|
|
144
|
+
先识别再按行定位目标串。传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。每个目标最多返回一次命中（最先匹配到的行），每项的 `text` 是目标字符串。
|
|
100
145
|
|
|
101
146
|
```typescript
|
|
102
147
|
function findTextAbs(
|
|
@@ -108,21 +153,31 @@ function findTextAbs(
|
|
|
108
153
|
ex?: number,
|
|
109
154
|
ey?: number,
|
|
110
155
|
confidenceThreshold?: number,
|
|
111
|
-
exactMatch?: boolean
|
|
156
|
+
exactMatch?: boolean,
|
|
112
157
|
): OCRChar[];
|
|
113
158
|
```
|
|
114
159
|
|
|
160
|
+
**参数:**
|
|
161
|
+
|
|
115
162
|
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
116
163
|
| --------------------- | -------- | -------- | ------ | --------------------------------------------------------------------- |
|
|
117
|
-
| `fontId` | string | 是 | | `loadFont`
|
|
164
|
+
| `fontId` | string | 是 | | 字库 ID，通过 `loadFont` 获取 |
|
|
118
165
|
| `input` | string | 是 | | 输入源，支持 `"screen"`、图片文件路径、URL 或 imageId |
|
|
119
166
|
| `targetTexts` | string[] | 是 | | 要查找的字符串数组，例如 `["商店", "背包"]` |
|
|
120
|
-
| `x
|
|
121
|
-
| `
|
|
167
|
+
| `x` | number | 否 | 0 | 裁剪区域左上角 x 坐标；全屏识别传 0 |
|
|
168
|
+
| `y` | number | 否 | 0 | 裁剪区域左上角 y 坐标；全屏识别传 0 |
|
|
169
|
+
| `ex` | number | 否 | 0 | 裁剪区域右下角 x 坐标；全屏识别传 0；为 0 时使用图像宽度 |
|
|
170
|
+
| `ey` | number | 否 | 0 | 裁剪区域右下角 y 坐标；全屏识别传 0；为 0 时使用图像高度 |
|
|
122
171
|
| `confidenceThreshold` | number | 否 | 0.8 | 单字符识别相似度下限；语义同 `recognizeAbs` |
|
|
123
|
-
| `exactMatch` | boolean | 否 | false
|
|
172
|
+
| `exactMatch` | boolean | 否 | false | `false` 为行内子串包含匹配；`true` 要求某一整行文本完全等于目标字符串 |
|
|
173
|
+
|
|
174
|
+
**返回值:**
|
|
175
|
+
|
|
176
|
+
| 类型 | 描述 |
|
|
177
|
+
| ----------- | ------------------------------------------------------ |
|
|
178
|
+
| `OCRChar[]` | 命中结果数组，坐标为原图或全屏绝对坐标 |
|
|
124
179
|
|
|
125
|
-
|
|
180
|
+
**示例:**
|
|
126
181
|
|
|
127
182
|
```javascript
|
|
128
183
|
const hits = dotOcr.findTextAbs(
|
|
@@ -136,25 +191,43 @@ const hits = dotOcr.findTextAbs(
|
|
|
136
191
|
0.8,
|
|
137
192
|
false,
|
|
138
193
|
);
|
|
139
|
-
if (hits.length > 0)
|
|
194
|
+
if (hits.length > 0) {
|
|
195
|
+
action.click(hits[0].centerX, hits[0].centerY);
|
|
196
|
+
}
|
|
140
197
|
```
|
|
141
198
|
|
|
142
199
|
### 资源管理
|
|
143
200
|
|
|
144
|
-
#### free -
|
|
201
|
+
#### free - 释放指定字库的资源。
|
|
145
202
|
|
|
146
203
|
```typescript
|
|
147
204
|
function free(fontId: string): void;
|
|
148
205
|
```
|
|
149
206
|
|
|
150
|
-
|
|
207
|
+
**参数:**
|
|
208
|
+
|
|
209
|
+
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
210
|
+
| -------- | ------ | -------- | ------ | --------------- |
|
|
211
|
+
| `fontId` | string | 是 | | 要释放的字库 ID |
|
|
212
|
+
|
|
213
|
+
**示例:**
|
|
214
|
+
|
|
215
|
+
```javascript
|
|
216
|
+
if (fontId) {
|
|
217
|
+
dotOcr.free(fontId);
|
|
218
|
+
logi(`字库 ${fontId} 资源已释放`);
|
|
219
|
+
}
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
#### freeAll - 释放全部已加载点阵字库的资源。
|
|
151
223
|
|
|
152
224
|
```typescript
|
|
153
225
|
function freeAll(): void;
|
|
154
226
|
```
|
|
155
227
|
|
|
228
|
+
**示例:**
|
|
229
|
+
|
|
156
230
|
```javascript
|
|
157
|
-
dotOcr.free(fontId);
|
|
158
|
-
// 或在需要清理全部已加载的点阵字库时：
|
|
159
231
|
dotOcr.freeAll();
|
|
232
|
+
logi("所有点阵字库资源已释放");
|
|
160
233
|
```
|
package/docs/api/global.md
CHANGED
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
- **脚本生命周期**: 设置停止回调、异常回调、重启脚本等
|
|
13
13
|
- **时间工具**: 获取时间戳
|
|
14
14
|
- **应用控制**: 切换应用到前台
|
|
15
|
-
- **Agent 设置**: 读取和设置 Agent
|
|
15
|
+
- **Agent 设置**: 读取和设置 Agent 触控模式
|
|
16
16
|
|
|
17
17
|
## 全局常量
|
|
18
18
|
|
|
@@ -309,7 +309,7 @@ logi("应用已切换到前台");
|
|
|
309
309
|
|
|
310
310
|
### setAgentFastMode
|
|
311
311
|
|
|
312
|
-
设置 Agent
|
|
312
|
+
设置 Agent 快速模式（兼容旧接口）。开启对应模式 `1`，关闭对应模式 `0`。推荐改用 `setAgentTouchMode`。设置会持久化。
|
|
313
313
|
|
|
314
314
|
```typescript
|
|
315
315
|
function setAgentFastMode(enabled: boolean): boolean;
|
|
@@ -336,7 +336,7 @@ logi(`Agent 快速模式: ${enabled}`);
|
|
|
336
336
|
|
|
337
337
|
### getAgentFastMode
|
|
338
338
|
|
|
339
|
-
获取 Agent
|
|
339
|
+
获取 Agent 快速模式当前状态（兼容旧接口）。
|
|
340
340
|
|
|
341
341
|
```typescript
|
|
342
342
|
function getAgentFastMode(): boolean;
|
|
@@ -356,6 +356,58 @@ if (getAgentFastMode()) {
|
|
|
356
356
|
}
|
|
357
357
|
```
|
|
358
358
|
|
|
359
|
+
### setAgentTouchMode
|
|
360
|
+
|
|
361
|
+
设置 Agent 触控模式。默认 `1`，设置会持久化。
|
|
362
|
+
|
|
363
|
+
- `0` 标准：等待完整执行完成
|
|
364
|
+
- `1` 快速：更快的执行速度
|
|
365
|
+
- `2` 真实点击：更接近真实手指触控
|
|
366
|
+
|
|
367
|
+
```typescript
|
|
368
|
+
function setAgentTouchMode(mode: number): number;
|
|
369
|
+
```
|
|
370
|
+
|
|
371
|
+
**参数:**
|
|
372
|
+
|
|
373
|
+
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
374
|
+
| ------ | -------- | -------- | ------ | ---------------------------- |
|
|
375
|
+
| `mode` | `number` | 是 | - | 0 标准 / 1 快速 / 2 真实点击 |
|
|
376
|
+
|
|
377
|
+
**返回值:**
|
|
378
|
+
|
|
379
|
+
| 类型 | 描述 |
|
|
380
|
+
| -------- | -------------- |
|
|
381
|
+
| `number` | 实际生效的模式 |
|
|
382
|
+
|
|
383
|
+
**示例:**
|
|
384
|
+
|
|
385
|
+
```javascript
|
|
386
|
+
const mode = setAgentTouchMode(1);
|
|
387
|
+
logi(`Agent 触控模式: ${mode}`);
|
|
388
|
+
```
|
|
389
|
+
|
|
390
|
+
### getAgentTouchMode
|
|
391
|
+
|
|
392
|
+
获取 Agent 触控模式。默认 `1`，设置会持久化。
|
|
393
|
+
|
|
394
|
+
```typescript
|
|
395
|
+
function getAgentTouchMode(): number;
|
|
396
|
+
```
|
|
397
|
+
|
|
398
|
+
**返回值:**
|
|
399
|
+
|
|
400
|
+
| 类型 | 描述 |
|
|
401
|
+
| -------- | ----------------- |
|
|
402
|
+
| `number` | 当前模式（0/1/2） |
|
|
403
|
+
|
|
404
|
+
**示例:**
|
|
405
|
+
|
|
406
|
+
```javascript
|
|
407
|
+
const mode = getAgentTouchMode();
|
|
408
|
+
logi(`当前触控模式: ${mode}`);
|
|
409
|
+
```
|
|
410
|
+
|
|
359
411
|
### setCpuAutoThrottle
|
|
360
412
|
|
|
361
413
|
设置脚本 CPU 自动限流。默认开启。开启后，脚本 API 在 CPU 占用接近系统杀进程阈值时会轻微让步，降低被系统终止的风险。
|
|
@@ -410,21 +462,24 @@ if (getCpuAutoThrottle()) {
|
|
|
410
462
|
设置 CPU 限流单次 sleep 延迟范围（毫秒）。默认 `minMs=3`、`maxMs=30`。仅在 CPU 自动限流开启且触发限流时生效。
|
|
411
463
|
|
|
412
464
|
```typescript
|
|
413
|
-
function setCpuThrottleDelay(
|
|
465
|
+
function setCpuThrottleDelay(
|
|
466
|
+
minMs: number,
|
|
467
|
+
maxMs: number,
|
|
468
|
+
): { minMs: number; maxMs: number };
|
|
414
469
|
```
|
|
415
470
|
|
|
416
471
|
**参数:**
|
|
417
472
|
|
|
418
|
-
| 参数名
|
|
419
|
-
|
|
|
420
|
-
| `minMs`
|
|
421
|
-
| `maxMs`
|
|
473
|
+
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
474
|
+
| ------- | -------- | -------- | ------ | --------------------------------------- |
|
|
475
|
+
| `minMs` | `number` | 是 | - | 最低延迟（毫秒） |
|
|
476
|
+
| `maxMs` | `number` | 是 | - | 最高延迟（毫秒）；小于 minMs 时自动对齐 |
|
|
422
477
|
|
|
423
478
|
**返回值:**
|
|
424
479
|
|
|
425
|
-
| 类型
|
|
426
|
-
|
|
|
427
|
-
| `{ minMs: number; maxMs: number }` | 实际生效的延迟范围
|
|
480
|
+
| 类型 | 描述 |
|
|
481
|
+
| ---------------------------------- | ------------------ |
|
|
482
|
+
| `{ minMs: number; maxMs: number }` | 实际生效的延迟范围 |
|
|
428
483
|
|
|
429
484
|
**示例:**
|
|
430
485
|
|
|
@@ -443,8 +498,8 @@ function getCpuThrottleDelay(): { minMs: number; maxMs: number };
|
|
|
443
498
|
|
|
444
499
|
**返回值:**
|
|
445
500
|
|
|
446
|
-
| 类型
|
|
447
|
-
|
|
|
501
|
+
| 类型 | 描述 |
|
|
502
|
+
| ---------------------------------- | ------------------ |
|
|
448
503
|
| `{ minMs: number; maxMs: number }` | 当前最低与最高延迟 |
|
|
449
504
|
|
|
450
505
|
**示例:**
|
|
@@ -466,8 +521,8 @@ function setStopCallback(
|
|
|
466
521
|
|
|
467
522
|
**参数:**
|
|
468
523
|
|
|
469
|
-
| 参数名 | 类型
|
|
470
|
-
| ---------- |
|
|
524
|
+
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|
|
525
|
+
| ---------- | --------------------------------------------------- | -------- | ------ | ------------ |
|
|
471
526
|
| `callback` | (status: "success" \| "error" \| "stopped") => void | 是 | - | 停止回调函数 |
|
|
472
527
|
|
|
473
528
|
**说明:**
|
package/docs/api/node.md
CHANGED
|
@@ -73,15 +73,15 @@ const listPage = createNodeSelector({ mode: 2 });
|
|
|
73
73
|
| 方法 | 说明 |
|
|
74
74
|
| --- | --- |
|
|
75
75
|
| `hittable()` | 当前是否可点击（可见且未被挡住） |
|
|
76
|
-
| `scrollToVisible()` |
|
|
77
|
-
| `tap()` |
|
|
78
|
-
| `doubleTap()` |
|
|
79
|
-
| `press(duration?)` | 长按，`duration` 单位毫秒，默认 500 |
|
|
80
|
-
| `clickCenter()` |
|
|
81
|
-
| `clickRandom()` |
|
|
82
|
-
| `clearInput()` |
|
|
83
|
-
| `input(text)` |
|
|
84
|
-
| `setValue(text)` |
|
|
76
|
+
| `scrollToVisible()` | 仅滚动到可见，不点击；一般不必手动调用 |
|
|
77
|
+
| `tap()` | 单击；不可见时会先自动滚到可见 |
|
|
78
|
+
| `doubleTap()` | 双击；不可见时会先自动滚到可见 |
|
|
79
|
+
| `press(duration?)` | 长按，`duration` 单位毫秒，默认 500；不可见时会先自动滚到可见 |
|
|
80
|
+
| `clickCenter()` | 点击中心坐标（坐标点击，不会自动滚动） |
|
|
81
|
+
| `clickRandom()` | 在节点范围内随机点击（坐标点击，不会自动滚动） |
|
|
82
|
+
| `clearInput()` | 清空输入内容（内部会先 `tap` 聚焦，因而也会自动滚到可见） |
|
|
83
|
+
| `input(text)` | 追加输入（不先清空；内部会先 `tap` 聚焦） |
|
|
84
|
+
| `setValue(text)` | 设置值（见下方；不可见时会先自动滚到可见） |
|
|
85
85
|
| `parent()` | 父节点 |
|
|
86
86
|
| `child(index)` | 第 `index` 个子节点 |
|
|
87
87
|
| `allChildren()` | 全部子节点 |
|
|
@@ -170,28 +170,29 @@ selector
|
|
|
170
170
|
|
|
171
171
|
### 是否可点 / 滚到可见
|
|
172
172
|
|
|
173
|
+
`tap` / `doubleTap` / `press` / `setValue`（以及内部会先 `tap` 的 `clearInput` / `input`）在元素当前不可见时，会**自动**先滚到可见再操作，一般不用手写滚动：
|
|
174
|
+
|
|
173
175
|
```typescript
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
}
|
|
176
|
+
// 推荐：直接操作，不可见时会自动滚到可见
|
|
177
|
+
node.tap();
|
|
178
|
+
node.doubleTap();
|
|
179
|
+
node.press(800);
|
|
180
|
+
node.setValue("hello");
|
|
180
181
|
```
|
|
181
182
|
|
|
182
|
-
- `hittable()
|
|
183
|
-
- `scrollToVisible()
|
|
184
|
-
- `
|
|
183
|
+
- `hittable()`：当前能否点到（可见且未被挡住），用于排查“点了没反应”
|
|
184
|
+
- `scrollToVisible()`：只滚到可见、不点击；仅在你想先露出元素、稍后再操作时使用
|
|
185
|
+
- `clickCenter()` / `clickRandom()`：按坐标点击，**不会**自动滚动
|
|
185
186
|
|
|
186
187
|
### 点击
|
|
187
188
|
|
|
188
189
|
| 方法 | 说明 |
|
|
189
190
|
| --- | --- |
|
|
190
|
-
| `tap()` |
|
|
191
|
-
| `doubleTap()` |
|
|
192
|
-
| `press(ms?)` | 长按，默认 500ms |
|
|
193
|
-
| `clickCenter()` |
|
|
194
|
-
| `clickRandom()` |
|
|
191
|
+
| `tap()` | 推荐，单击；不可见时自动滚到可见 |
|
|
192
|
+
| `doubleTap()` | 双击；不可见时自动滚到可见 |
|
|
193
|
+
| `press(ms?)` | 长按，默认 500ms；不可见时自动滚到可见 |
|
|
194
|
+
| `clickCenter()` | 点中心坐标，不自动滚动 |
|
|
195
|
+
| `clickRandom()` | 范围内随机点，不自动滚动 |
|
|
195
196
|
|
|
196
197
|
```typescript
|
|
197
198
|
const btn = selector
|
|
@@ -210,15 +211,15 @@ if (btn) {
|
|
|
210
211
|
|
|
211
212
|
| 方法 | 说明 |
|
|
212
213
|
| --- | --- |
|
|
213
|
-
| `clearInput()` |
|
|
214
|
-
| `input(text)` |
|
|
215
|
-
| `setValue(text)` |
|
|
214
|
+
| `clearInput()` | 清空（内部先 `tap` 聚焦，不可见时也会自动滚到可见） |
|
|
215
|
+
| `input(text)` | 追加输入，不清空原内容（内部先 `tap` 聚焦） |
|
|
216
|
+
| `setValue(text)` | 按控件类型设置；不可见时会先自动滚到可见 |
|
|
216
217
|
|
|
217
218
|
**`setValue` 行为**
|
|
218
219
|
|
|
219
220
|
| 控件类型 | 传参 | 效果 |
|
|
220
221
|
| --- | --- | --- |
|
|
221
|
-
| `PickerWheel` | 选项文案，如 `"1小时"` |
|
|
222
|
+
| `PickerWheel` | 选项文案，如 `"1小时"` | 滚到该选项（控件本身不可见时也会先自动滚到可见） |
|
|
222
223
|
| 文本框类（TextField 等） | 字符串 | 聚焦后追加输入，不先清空 |
|
|
223
224
|
|
|
224
225
|
覆盖原内容请先清空：
|
|
@@ -234,6 +235,7 @@ field.input("hello");
|
|
|
234
235
|
```typescript
|
|
235
236
|
const wheel = selector.type("XCUIElementTypePickerWheel").getOneNodeInfo(3000);
|
|
236
237
|
if (wheel) {
|
|
238
|
+
// 不可见时会自动滚到可见，再调到目标选项
|
|
237
239
|
wheel.setValue("1小时");
|
|
238
240
|
}
|
|
239
241
|
```
|