ms-vite-plugin 1.4.17 → 1.4.19

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.
Files changed (18) hide show
  1. package/docs/AGENTS.md +1 -1
  2. package/docs/api/appleocr.md +46 -164
  3. package/docs/api/image.md +16 -84
  4. package/docs/api/media.md +6 -7
  5. package/docs/api/paddleocr.md +77 -123
  6. package/docs/api/yolo.md +52 -96
  7. package/docs/apicn/appleocr.md +47 -169
  8. package/docs/apicn/image.md +15 -81
  9. package/docs/apicn/media.md +6 -7
  10. package/docs/apicn/paddleocr.md +77 -130
  11. package/docs/apicn/yolo.md +52 -101
  12. package/docs/apipython/appleocr.md +45 -155
  13. package/docs/apipython/image.md +17 -77
  14. package/docs/apipython/media.md +7 -8
  15. package/docs/apipython/paddleocr.md +78 -104
  16. package/docs/apipython/yolo.md +36 -85
  17. package/docs/mcp-agent-description.md +1 -1
  18. package/package.json +1 -1
package/docs/apicn/appleocr.md CHANGED
@@ -59,94 +59,38 @@ interface OCR识别结果 {
59
59
 
60
60
  ### 文字识别
61
61
 
62
- #### 识别
62
+ #### 识别绝对坐标 - 执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
63
63
 
64
- 执行通用 OCR 文字识别，支持多种输入源和指定识别区域。
64
+ 执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
65
+ 传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。
65
66
 
66
67
  ```typescript
67
- function 识别(
68
+ function 识别绝对坐标(
68
69
  输入源: 字符串,
69
70
  图片边界框左上角x坐标?: 数字,
70
71
  图片边界框左上角y坐标?: 数字,
71
72
  图片边界框右下角x坐标?: 数字,
72
73
  图片边界框右下角y坐标?: 数字,
73
- 识别语言数组?: Array<字符串>,
74
+ 识别语言数组?: 数组<字符串>,
74
75
  ): 数组<OCR识别结果>;
75
76
  ```
76
77
 
77
78
  **参数:**
78
79
 
79
- | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
80
- | ----------------------- | -------- | -------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
81
- | `输入源` | string | 是 | - | 输入源，支持以下类型：<br>- `"screen"` - 当前屏幕截图<br>- `string` - 图片文件路径或 URL<br>- `imageId` - 图片 ID（通过 image 模块获取） |
82
- | `图片边界框左上角x坐标` | number | 否 | - | 识别区域左上角 x 坐标 |
83
- | `图片边界框左上角y坐标` | number | 否 | - | 识别区域左上角 y 坐标 |
84
- | `图片边界框右下角x坐标` | number | 否 | - | 识别区域右下角 x 坐标 |
85
- | `图片边界框右下角y坐标` | number | 否 | - | 识别区域右下角 y 坐标 |
86
- | `识别语言数组` | string[] | 否 | ["zh-Hans", "en-US"] | 可选，指定识别语言列表，如 ["zh-Hans", "en-US"] |
80
+ | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
81
+ | ----------------------- | ------------ | -------- | ----------------------- | ---------------------------------------------------------------------------------------------------------- |
82
+ | `输入源` | 字符串 | 是 | | 输入源，支持 `"screen"`、图片文件路径、URL 字符串或 imageId |
83
+ | `图片边界框左上角x坐标` | 数字 | 否 | 0 | 裁剪区域左上角 x 坐标；全屏识别传 0 |
84
+ | `图片边界框左上角y坐标` | 数字 | 否 | 0 | 裁剪区域左上角 y 坐标；全屏识别传 0 |
85
+ | `图片边界框右下角x坐标` | 数字 | 否 | 0 | 裁剪区域右下角 x 坐标；全屏识别传 0 |
86
+ | `图片边界框右下角y坐标` | 数字 | 否 | 0 | 裁剪区域右下角 y 坐标；全屏识别传 0 |
87
+ | `识别语言数组` | 数组<字符串> | 否 | `["zh-Hans", "en-US"]` | 识别语言数组，支持 `["en-US", "fr-FR", "it-IT", "de-DE", "es-ES", "pt-BR", "zh-Hans", "zh-Hant"]` |
87
88
 
88
89
  **返回值:**
89
90
 
90
- | 类型 | 描述 |
91
- | ------------------ | ---------------------- |
92
- | 数组<OCR 识别结果> | 匹配的文本识别结果数组 |
93
-
94
- **使用示例:**
95
-
96
- ```javascript
97
- // 识别整个屏幕
98
- const 全屏识别结果 = $苹果OCR.识别("screen", 0, 0, 0, 0);
99
- logi(`识别到 ${全屏识别结果.length} 个文本区域`);
100
- 全屏识别结果.forEach((result, index) => {
101
- logi(`文本 ${index + 1}: ${result.text} (置信度: ${result.confidence})`);
102
- logi(`位置: (${result.x}, ${result.y}) - (${result.ex}, ${result.ey})`);
103
- logi(`中心点: (${result.centerX}, ${result.centerY})`);
104
- });
105
-
106
- // 识别屏幕指定区域
107
- const 区域识别结果 = $苹果OCR.识别("screen", 100, 100, 500, 300);
108
- logi(`指定区域识别结果: ${JSON.stringify(区域识别结果)}`);
109
-
110
- // 识别图片文件
111
- const 图片识别结果 = $苹果OCR.识别("/path/to/image.png", 0, 0, 800, 600);
112
- if (图片识别结果.length > 0) {
113
- logi("图片文字识别成功");
114
- 图片识别结果.forEach((result) => {
115
- logi(`识别文字: ${result.text}`);
116
- logi(`区域: ${result.width}x${result.height}`);
117
- });
118
- } else {
119
- logi("图片中未识别到文字");
120
- }
121
-
122
- // 指定识别语言
123
- const 中英文识别结果 = $苹果OCR.识别("screen", 0, 0, 1920, 1080, [
124
- "zh-Hans",
125
- "en-US",
126
- ]);
127
- logi(`中英文识别结果: ${JSON.stringify(中英文识别结果)}`);
128
-
129
- // 识别当前屏幕
130
- const 屏幕识别结果 = $苹果OCR.识别("screen", 0, 0, 1920, 1080);
131
- logi(`屏幕识别结果: ${JSON.stringify(屏幕识别结果)}`);
132
- ```
133
-
134
- #### 识别绝对坐标
135
-
136
- 执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
137
-
138
- 参数与 `识别` 相同。传入裁剪区域时，返回坐标可直接用于全屏点击。
139
-
140
- ```typescript
141
- function 识别绝对坐标(
142
- 输入源: 字符串,
143
- 图片边界框左上角x坐标?: 数字,
144
- 图片边界框左上角y坐标?: 数字,
145
- 图片边界框右下角x坐标?: 数字,
146
- 图片边界框右下角y坐标?: 数字,
147
- 识别语言数组?: 数组<字符串>,
148
- ): 数组<OCR识别结果>;
149
- ```
91
+ | 类型 | 描述 |
92
+ | ----------------- | ------------------------------------------------ |
93
+ | 数组<OCR识别结果> | 识别结果数组，坐标为原图或全屏绝对坐标 |
150
94
 
151
95
  **示例:**
152
96
 
@@ -159,14 +103,15 @@ if (绝对坐标结果.length > 0) {
159
103
 
160
104
  ### 数字识别
161
105
 
162
- #### 识别数字
106
+ #### 识别数字绝对坐标 - 执行数字 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
163
107
 
164
- 执行专门的数字 OCR 识别，针对数字识别进行了优化，提高数字识别的准确性。
108
+ 执行数字 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
109
+ 传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。
165
110
 
166
111
  **支持字符**: 0-9 数字、逗号(,)、小数点(.)、加号(+)、减号(-)
167
112
 
168
113
  ```typescript
169
- function 识别数字(
114
+ function 识别数字绝对坐标(
170
115
  输入源: 字符串,
171
116
  图片边界框左上角x坐标?: 数字,
172
117
  图片边界框左上角y坐标?: 数字,
@@ -177,49 +122,19 @@ function 识别数字(
177
122
 
178
123
  **参数:**
179
124
 
180
- | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
181
- | ----------------------- | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------ |
182
- | `输入源` | string | 是 | - | 输入源，支持以下类型： <br>-`"screen"` 当前屏幕截图 <br>- `string` 图片文件路径或 URL <br>- `imageId` 图片 ID（通过 image 模块获取） |
183
- | `图片边界框左上角x坐标` | number | 否 | - | 识别区域左上角 x 坐标 |
184
- | `图片边界框左上角y坐标` | number | 否 | - | 识别区域左上角 y 坐标 |
185
- | `图片边界框右下角x坐标` | number | 否 | - | 识别区域右下角 x 坐标 |
186
- | `图片边界框右下角y坐标` | number | 否 | - | 识别区域右下角 y 坐标 |
125
+ | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
126
+ | ----------------------- | ------ | -------- | ------ | --------------------------------------------------- |
127
+ | `输入源` | 字符串 | 是 | | 输入源，支持 `"screen"`、图片文件路径、URL 字符串或 imageId |
128
+ | `图片边界框左上角x坐标` | 数字 | 否 | 0 | 裁剪区域左上角 x 坐标；全屏识别传 0 |
129
+ | `图片边界框左上角y坐标` | 数字 | 否 | 0 | 裁剪区域左上角 y 坐标；全屏识别传 0 |
130
+ | `图片边界框右下角x坐标` | 数字 | 否 | 0 | 裁剪区域右下角 x 坐标；全屏识别传 0 |
131
+ | `图片边界框右下角y坐标` | 数字 | 否 | 0 | 裁剪区域右下角 y 坐标；全屏识别传 0 |
187
132
 
188
133
  **返回值:**
189
134
 
190
- | 类型 | 描述 |
191
- | ------------------- | ---------------------- |
192
- | `数组<OCR识别结果>` | 匹配的数字识别结果数组 |
193
-
194
- **使用示例:**
195
-
196
- ```javascript
197
- // 识别屏幕中的数字
198
- const 数字识别结果 = 识别数字("screen", 100, 100, 500, 300);
199
- $打印信息日志(`识别到 ${数字识别结果.length} 个数字区域`);
200
-
201
- 数字识别结果.forEach((result, index) => {
202
- $打印信息日志(`数字 ${index + 1}: ${result.text}`);
203
- $打印信息日志(`置信度: ${result.confidence}`);
204
- $打印信息日志(`位置: (${result.centerX}, ${result.centerY})`);
205
- });
206
- ```
207
-
208
- #### 识别数字绝对坐标
209
-
210
- 执行数字 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
211
-
212
- 参数与 `识别数字` 相同。传入裁剪区域时，返回坐标可直接用于全屏点击。
213
-
214
- ```typescript
215
- function 识别数字绝对坐标(
216
- 输入源: 字符串,
217
- 图片边界框左上角x坐标?: 数字,
218
- 图片边界框左上角y坐标?: 数字,
219
- 图片边界框右下角x坐标?: 数字,
220
- 图片边界框右下角y坐标?: 数字,
221
- ): 数组<OCR识别结果>;
222
- ```
135
+ | 类型 | 描述 |
136
+ | ----------------- | ---------------------------------------------------------- |
137
+ | 数组<OCR识别结果> | 数字识别结果数组，坐标为原图或全屏绝对坐标 |
223
138
 
224
139
  **示例:**
225
140
 
@@ -232,12 +147,13 @@ if (绝对坐标数字结果.length > 0) {
232
147
 
233
148
  ### 文本查找
234
149
 
235
- #### 查找文本
150
+ #### 查找文本绝对坐标 - 查找目标子串，并将子串结果坐标映射为原图/全屏绝对坐标。
236
151
 
237
- 执行指定文本查找，在识别结果中查找目标子串，并返回目标子串的坐标。
152
+ 查找目标子串，并将子串结果坐标映射为原图/全屏绝对坐标。
153
+ 传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。
238
154
 
239
155
  ```typescript
240
- function 查找文本(
156
+ function 查找文本绝对坐标(
241
157
  输入源: 字符串,
242
158
  要查找的文本数组: 数组<字符串>,
243
159
  图片边界框左上角x坐标?: 数字,
@@ -251,60 +167,22 @@ function 查找文本(
251
167
 
252
168
  **参数:**
253
169
 
254
- | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
255
- | ----------------------- | ------------ | -------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
256
- | `输入源` | string | 是 | - | 输入源，支持以下类型： <br>-`"screen"` 当前屏幕截图 <br>- `string` 图片文件路径或 URL <br>- `imageId` 图片 ID（通过 image 模块获取） |
257
- | `要查找的文本数组` | 数组<字符串> | 是 | - | 要查找的目标文本数组，支持匹配识别结果中的子串 |
258
- | `图片边界框左上角x坐标` | number | 否 | - | 识别区域左上角 x 坐标 |
259
- | `图片边界框左上角y坐标` | number | 否 | - | 识别区域左上角 y 坐标 |
260
- | `图片边界框右下角x坐标` | number | 否 | - | 识别区域右下角 x 坐标 |
261
- | `图片边界框右下角y坐标` | number | 否 | - | 识别区域右下角 y 坐标 |
262
- | `识别语言数组` | 数组<字符串> | 否 | ["zh-Hans", "en-US"] | 可选，指定识别语言列表，如 ["zh-Hans", "en-US"] |
263
- | `是否完整匹配` | boolean | 否 | false | 是否完整匹配；`false` 表示包含匹配，`true` 表示整条 OCR 识别结果文本必须等于目标文本 |
170
+ | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
171
+ | ----------------------- | ------------ | -------- | ----------------------- | --------------------------------------------------------------------------------------- |
172
+ | `输入源` | 字符串 | 是 | | 输入源，支持 `"screen"`、图片文件路径、URL 字符串或 imageId |
173
+ | `要查找的文本数组` | 数组<字符串> | 是 | | 要查找的目标文本数组，可匹配识别结果中的子串 |
174
+ | `图片边界框左上角x坐标` | 数字 | 否 | 0 | 裁剪区域左上角 x 坐标；全屏识别传 0 |
175
+ | `图片边界框左上角y坐标` | 数字 | 否 | 0 | 裁剪区域左上角 y 坐标；全屏识别传 0 |
176
+ | `图片边界框右下角x坐标` | 数字 | 否 | 0 | 裁剪区域右下角 x 坐标；全屏识别传 0 |
177
+ | `图片边界框右下角y坐标` | 数字 | 否 | 0 | 裁剪区域右下角 y 坐标；全屏识别传 0 |
178
+ | `识别语言数组` | 数组<字符串> | 否 | `["zh-Hans", "en-US"]` | 识别语言数组 |
179
+ | `是否完整匹配` | 布尔值 | 否 | false | 是否完整匹配；`false` 表示包含匹配，`true` 要求整条 OCR 识别结果文本等于目标文本 |
264
180
 
265
181
  **返回值:**
266
182
 
267
- | 类型 | 描述 |
268
- | ------------------- | ---------------------- |
269
- | `数组<OCR识别结果>` | 命中子串的文本识别结果数组 |
270
-
271
- **使用示例:**
272
-
273
- ```javascript
274
- // 在“开始执行”中查找“开始”，返回“开始”子串区域
275
- const 文本识别结果 = 查找文本("screen", ["开始"], 0, 0, 100, 100);
276
- // 不指定识别语言但启用完整匹配时，用 null 占位识别语言数组
277
- const 全字命中结果 = 查找文本("screen", ["开始"], 0, 0, 100, 100, null, true);
278
- $打印信息日志(`识别到 ${文本识别结果.length} 个文本区域`);
279
- 文本识别结果.forEach((result, index) => {
280
- $打印信息日志(
281
- `文本 ${index + 1}: ${result.text} (置信度: ${result.confidence})`,
282
- );
283
- $打印信息日志(
284
- `位置: (${result.x}, ${result.y}) - (${result.ex}, ${result.ey})`,
285
- );
286
- $打印信息日志(`中心点: (${result.centerX}, ${result.centerY})`);
287
- });
288
- ```
289
-
290
- #### 查找文本绝对坐标
291
-
292
- 查找目标子串，并将子串结果坐标映射为原图/全屏绝对坐标。
293
-
294
- 参数与 `查找文本` 相同。传入裁剪区域时，返回坐标可直接用于全屏点击。
295
-
296
- ```typescript
297
- function 查找文本绝对坐标(
298
- 输入源: 字符串,
299
- 要查找的文本数组: 数组<字符串>,
300
- 图片边界框左上角x坐标?: 数字,
301
- 图片边界框左上角y坐标?: 数字,
302
- 图片边界框右下角x坐标?: 数字,
303
- 图片边界框右下角y坐标?: 数字,
304
- 识别语言数组?: 数组<字符串>,
305
- 是否完整匹配?: 布尔值,
306
- ): 数组<OCR识别结果>;
307
- ```
183
+ | 类型 | 描述 |
184
+ | ----------------- | ---------------------------------------------------------- |
185
+ | 数组<OCR识别结果> | 命中子串的识别结果数组，坐标为原图或全屏绝对坐标 |
308
186
 
309
187
  **示例:**
310
188
 
package/docs/apicn/image.md CHANGED
@@ -45,7 +45,7 @@ function 截取屏幕(
45
45
  **示例：**
46
46
 
47
47
  ```javascript
48
- // 截取全屏
48
+ // 全屏截图
49
49
  const 图片ID = $图片.截取屏幕();
50
50
  // 获取手机文档目录
51
51
  const 文档目录 = $文件.获取内部目录("documents");
@@ -70,72 +70,6 @@ if (图片ID) {
70
70
  }
71
71
  ```
72
72
 
73
- ### 截取全屏 - 截取设备全屏。
74
-
75
- ```typescript
76
- function 截取全屏(): 字符串 | null;
77
- ```
78
-
79
- **返回值：**
80
-
81
- | 类型 | 描述 |
82
- | -------- | -------------------------------- |
83
- | `字符串` | 截图的图片 ID，失败时返回 `null` |
84
-
85
- **示例：**
86
-
87
- ```javascript
88
- const 图片ID = $图片.截取全屏();
89
- // 获取手机文档目录
90
- const 文档目录 = $文件.获取内部目录("documents");
91
- if (图片ID) {
92
- $打印信息日志("截图成功");
93
- $图片.保存图片(图片ID, `${文档目录}/screenshot.jpg`);
94
- $图片.释放图片(图片ID); // 记得释放内存
95
- } else {
96
- $打印错误日志("截图失败");
97
- }
98
- ```
99
-
100
- ### 截取区域 - 截取设备指定区域。
101
-
102
- ```typescript
103
- function 截取区域(
104
- 区域左上角X坐标: 数字,
105
- 区域左上角Y坐标: 数字,
106
- 区域右下角X坐标: 数字,
107
- 区域右下角Y坐标: 数字,
108
- ): 字符串 | null;
109
- ```
110
-
111
- **参数：**
112
-
113
- | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
114
- | ----------------- | ---- | -------- | ------ | ----------------- |
115
- | `区域左上角X坐标` | 数字 | 是 | - | 区域左上角 X 坐标 |
116
- | `区域左上角Y坐标` | 数字 | 是 | - | 区域左上角 Y 坐标 |
117
- | `区域右下角X坐标` | 数字 | 是 | - | 区域右下角 X 坐标 |
118
- | `区域右下角Y坐标` | 数字 | 是 | - | 区域右下角 Y 坐标 |
119
-
120
- **返回值：**
121
-
122
- | 类型 | 描述 |
123
- | -------- | -------------------------------- |
124
- | `字符串` | 截图的图片 ID，失败时返回 `null` |
125
-
126
- **示例：**
127
-
128
- ```javascript
129
- const 图片ID = $图片.截取区域(100, 100, 200, 200);
130
- if (图片ID) {
131
- $打印信息日志("截图成功");
132
- // 使用图片...
133
- $图片.释放图片(图片ID);
134
- } else {
135
- $打印错误日志("截图失败");
136
- }
137
- ```
138
-
139
73
  ### 读取图片 - 从文件路径或图片ID读取图片。
140
74
 
141
75
  ```typescript
@@ -189,7 +123,7 @@ function 保存图片(图片ID: 字符串, 保存路径: 字符串): 布尔值;
189
123
  **示例：**
190
124
 
191
125
  ```javascript
192
- const 图片ID = $图片.截取全屏();
126
+ const 图片ID = $图片.截取屏幕();
193
127
  // 获取手机文档目录
194
128
  const 文档目录 = $文件.获取内部目录("documents");
195
129
  if (图片ID) {
@@ -239,7 +173,7 @@ function 图片是否被释放(图片ID: 字符串): 布尔值;
239
173
  **示例：**
240
174
 
241
175
  ```javascript
242
- const 图片ID = $图片.截取全屏();
176
+ const 图片ID = $图片.截取屏幕();
243
177
  if (图片ID) {
244
178
  $打印信息日志(`释放前: ${$图片.图片是否被释放(图片ID)}`); // false
245
179
  $图片.释放图片(图片ID);
@@ -270,7 +204,7 @@ function 获取图片大小(图片ID: 字符串): { width: 数字; height: 数
270
204
  **示例：**
271
205
 
272
206
  ```javascript
273
- const 图片ID = $图片.截取全屏();
207
+ const 图片ID = $图片.截取屏幕();
274
208
  if (图片ID) {
275
209
  const 图片尺寸 = $图片.获取图片大小(图片ID);
276
210
  if (图片尺寸) {
@@ -303,7 +237,7 @@ function 取像素颜色(图片ID: 字符串, 坐标x: 数字, 坐标y: 数字):
303
237
  **示例：**
304
238
 
305
239
  ```javascript
306
- const 图片ID = $图片.截取全屏();
240
+ const 图片ID = $图片.截取屏幕();
307
241
  if (图片ID) {
308
242
  const 颜色值 = $图片.取像素颜色(图片ID, 100, 100);
309
243
  const 颜色Hex = $图片.颜色转16进制字符串(颜色值);
@@ -371,7 +305,7 @@ function 单点找色(
371
305
  **示例：**
372
306
 
373
307
  ```javascript
374
- const 图片ID = $图片.截取全屏();
308
+ const 图片ID = $图片.截取屏幕();
375
309
  if (图片ID) {
376
310
  // 查找蓝色按钮
377
311
  const 坐标数组 = $图片.单点找色(
@@ -437,7 +371,7 @@ function 多点找色(
437
371
  **示例：**
438
372
 
439
373
  ```javascript
440
- const 图片ID = $图片.截取全屏();
374
+ const 图片ID = $图片.截取屏幕();
441
375
  if (图片ID) {
442
376
  // 查找特定的颜色组合（如按钮的特征颜色）
443
377
  const 坐标数组 = $图片.多点找色(
@@ -500,7 +434,7 @@ function 统计颜色数量(
500
434
  **示例：**
501
435
 
502
436
  ```javascript
503
- const 图片ID = $图片.截取全屏();
437
+ const 图片ID = $图片.截取屏幕();
504
438
  if (图片ID) {
505
439
  const 数量 = $图片.统计颜色数量(
506
440
  图片ID,
@@ -540,7 +474,7 @@ function 多点比色(图片ID: 字符串, 颜色点: 字符串, 阈值: 数字)
540
474
  **示例：**
541
475
 
542
476
  ```javascript
543
- const 图片ID = $图片.截取全屏();
477
+ const 图片ID = $图片.截取屏幕();
544
478
  if (图片ID) {
545
479
  // 检查特定区域是否为预期颜色
546
480
  const isMatch = $图片.多点比色(
@@ -673,7 +607,7 @@ function 裁剪图片(
673
607
  **示例：**
674
608
 
675
609
  ```javascript
676
- const 图片ID = $图片.截取全屏();
610
+ const 图片ID = $图片.截取屏幕();
677
611
  // 获取手机文档目录
678
612
  const dir = $文件.获取内部目录("documents");
679
613
  if (图片ID) {
@@ -787,7 +721,7 @@ function 二值化图片(图片ID: 字符串, 阈值: 数字): 字符串;
787
721
  **示例：**
788
722
 
789
723
  ```javascript
790
- const 图片ID = $图片.截取全屏();
724
+ const 图片ID = $图片.截取屏幕();
791
725
  // 获取手机文档目录
792
726
  const dir = $文件.获取内部目录("documents");
793
727
  if (图片ID) {
@@ -830,7 +764,7 @@ function 绘制矩形(
830
764
  // 获取手机文档目录
831
765
  const dir = $文件.获取内部目录("documents");
832
766
 
833
- const 图片ID = $图片.截取全屏();
767
+ const 图片ID = $图片.截取屏幕();
834
768
  if (图片ID) {
835
769
  $图片.绘制矩形(图片ID, 100, 100, 200, 100, "#FF0000", 2);
836
770
  $图片.保存图片(图片ID, `${dir}/test.jpg`);
@@ -859,7 +793,7 @@ function 扫描条码(图片ID: 字符串): 字符串 | null;
859
793
  **示例：**
860
794
 
861
795
  ```javascript
862
- const 图片ID = $图片.截取全屏();
796
+ const 图片ID = $图片.截取屏幕();
863
797
  if (图片ID) {
864
798
  const 扫码结果 = $图片.扫描条码(图片ID);
865
799
  if (扫码结果) {
@@ -929,7 +863,7 @@ function 图片转base64(图片ID: 字符串, 格式: 字符串, 质量: 数字)
929
863
  **示例：**
930
864
 
931
865
  ```javascript
932
- const 图片ID = $图片.截取全屏();
866
+ const 图片ID = $图片.截取屏幕();
933
867
  if (图片ID) {
934
868
  const base64 = $图片.图片转base64(图片ID, "jpg", 90);
935
869
  $打印信息日志(`Base64 数据: ${base64.substring(0, 100)}...`);
@@ -962,7 +896,7 @@ function 获取Bitmap(图片ID: 字符串): 任意类型;
962
896
  **示例：**
963
897
 
964
898
  ```javascript
965
- const 图片ID = $图片.截取全屏();
899
+ const 图片ID = $图片.截取屏幕();
966
900
  if (图片ID) {
967
901
  const bitmap = $图片.获取Bitmap(图片ID);
968
902
  $打印信息日志(`Bitmap 对象: ${bitmap}`);
package/docs/apicn/media.md CHANGED
@@ -219,18 +219,17 @@ if (是否停止成功) {
219
219
  }
220
220
  ```
221
221
 
222
- #### 同步播放 MP3 音乐 - 同步播放 MP3 音频文件（等待播放结束）。
222
+ #### 同步播放 MP3 音乐 - 同步播放 MP3 音频文件（播放一次并等待结束）。
223
223
 
224
224
  ```typescript
225
- function 同步播放MP3音乐(文件路径: 字符串, 是否循环播放: 布尔值): 布尔值;
225
+ function 同步播放MP3音乐(文件路径: 字符串): 布尔值;
226
226
  ```
227
227
 
228
228
  **参数:**
229
229
 
230
- | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
231
- | -------------- | ------ | -------- | ------ | -------------------------------------------------------------------- |
232
- | `文件路径` | 字符串 | 是 | | MP3 文件路径 |
233
- | `是否循环播放` | 布尔值 | 是 | | 是否循环播放 注意：循环播放会阻塞线程，慎用，不要在主线程设置为 true |
230
+ | 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
231
+ | ---------- | ------ | -------- | ------ | ------------ |
232
+ | `文件路径` | 字符串 | 是 | | MP3 文件路径 |
234
233
 
235
234
  **返回值:**
236
235
 
@@ -243,7 +242,7 @@ function 同步播放MP3音乐(文件路径: 字符串, 是否循环播放: 布
243
242
  ```javascript
244
243
  // 同步播放音频，等待播放完成
245
244
  $打印信息日志("开始播放音频...");
246
- const 是否播放成功 = $媒体.同步播放MP3音乐("/path/to/notification.mp3", false);
245
+ const 是否播放成功 = $媒体.同步播放MP3音乐("/path/to/notification.mp3");
247
246
  if (是否播放成功) {
248
247
  $打印信息日志("音频播放完成");
249
248
  } else {