OCR 模块（ocr）

ocr 模块约定

对当前屏截图识别。全屏：ocr.findStr('登录', 0.5)；区域：四元组在前。text 可用 | 分隔多目标。无默认值，参数均必填。

最短示例：

let t = ocr.findStr('登录', 0.5);
if (t) auto.click(t.centerX, t.centerY);

---

ocr.ocr - 整区识别

function ocr.ocr(lang, level): Promise<OcrLine[]>;
function ocr.ocr(x1,y1,x2,y2, lang, level): Promise<OcrLine[]>;

参数说明：

参数名	类型	是否必填	默认值	描述
lang	string	是	-	如 zh-Hans / en-US
level	string	是	-	fast

返回字段（OcrLine）：

字段	类型	描述
text	string	识别文本
x,y,ex,ey,width,height,centerX,centerY	number	框与中心
confidence	number	置信度

示例：

let lines = ocr.ocr('zh-Hans', 'accurate');
logger.debug(lines.map(l => l.text).join('|'));

---

ocr.findStr - 找字（首个命中）

function ocr.findStr(text, sim, mode): Promise<OcrHit|null>;
function ocr.findStr(x1, y1, x2, y2, text, sim, mode): Promise<OcrHit|null>;

参数说明：

参数名	类型	是否必填	默认值	描述
text	string	是	-	目标字；多目标 `登录
sim	number	是	-	相似度门槛 0～1
mode	string	是	-	includes

返回字段（OcrHit）：

字段	类型	描述
text	string	命中文本
x,y,ex,ey,width,height,centerX,centerY	number	框与中心
confidence	number	置信度

示例：

let t = ocr.findStr('登录|注册', 0.5, 'includes');
if (t) auto.click(t.centerX, t.centerY);

---

ocr.findStrEx - 找字（全部命中）

function ocr.findStrEx(text, sim, mode, limit): Promise<OcrHit[]>;
function ocr.findStrEx(x1, y1, x2, y2, text, sim, mode, limit): Promise<OcrHit[]>;

参数说明：

参数名	类型	是否必填	默认值	描述
text	string	是	-	目标字；多目标可用 `
sim	number	是	-	相似度门槛 0～1
mode	string	是	-	includes
limit	number	是	-	最多条数

返回值：

类型	描述
Promise<OcrHit[]>	全部命中；无则为空数组（字段同 findStr）

示例：

let all = ocr.findStrEx(0, 0, 500, 200, '确定', 0.5, 'includes', 20);
logger.debug('命中数', all.length);