zm.FindStrTapBaiDu 百度云找字点击

文章目录

1. 功能
2. 语法
3. 参数
4. 返回值
5. 示例
6. 备注

功能

与zm.FindStrBaiDu 百度云找字类似, 区别在于本命令内置找到后点击. 由于查找与点击是两个动作组成, 为方便代码阅读理解, 故新增本命令

语法

结果 = zm.FindStrTapBaiDu([对象][x1, y1, x2, y2, ]文字[, 查找超时][, 点击坐标][, 显示日志][, 输出行号][, 备注][, 等待消失][, 消失超时][, 参数返回值])

参数

参数	数据类型	解释
对象	表	可选, 把所有参数放入一个table中传入, 若后面跟有其他参数, 则会对应覆盖对象数据
x1	数值型	可选, 查找范围的左上角x坐标, 省略默认为0
y1	数值型	可选, 查找范围的左上角y坐标, 省略默认为0
x2	数值型	可选, 查找范围的右下角x坐标, 省略默认为0
y2	数值型	可选, 查找范围的右下角y坐标, 省略默认为0
文字	字符串	可选, 查找的文字内容, 多个文字用“\|”隔开, 可以用`$`开头表示文字参数
超时时间	数值型	可选, 最大查找耗时, 单位毫秒, 如果一次找不到, 可以限时循环查找, 省略默认为`1`
点击坐标	字符串	可选, 点击修改后的坐标, 格式`"±x,±y,t"`, 省略为找到的坐标, `t`是可选的, 表示点击后延时毫秒, 例如`"100,100"`表示固定点击坐标100,100, `"+10,-10"`表示偏移点击找到的x+10,y-10位置, `"10,10,2000"`表示点击10,10坐标后延时2000毫秒, 该参数会受zm.SetTap 设置超级点击影响
显示日志	字符串	可选, 输出调试日志信息, 省略默认为”隐藏”, 支持`["显示","隐藏","show","hide"]`这几个值
输出行号	字符串	可选, 格式为`"_"`开头后跟行号, 比如`"_10"`表示第10行代码, 输出调试信息窗口显示第几行代码, 需开启显示日志才有效
备注	字符串	可选, 格式为`"@"`开头后跟内容, 比如`"@拾取屠龙刀"`, 输出调试信息窗口就会增加这条内容, 若连续两个`"@@"`则表示在浮窗中显示信息, 需要开启显示日志才有效
等待消失	数值型	可选, 填写`-1`禁用或`-2`启用, `-2`表示找到后或点击后继续查找, 直到找不到或消失超时, 省略默认为`-1`, 启用后返回值将有`miss`键名, 值为`true`时表示成功消失, 值为`false`表示未消失
消失超时	数值型	可选, 填写`负数`, 表示等待消失的超时时间, 单位毫秒, 注意必须填写负数, 不可填-1和-2, 省略默认为`-2000`
参数返回值	表	可选, 只能传入数组变量名, 用于保存查找结果, 格式与命令返回值相同

返回值

表 , 找到返回结果保存到表中, 格式为{id, x, y, name, "id":id, "x":x, "y":y, "name":name, "miss":miss, "baidu":原生返回值}, 没找到或出错返回null, 使用方法请看示例

示例

Import "zm.luae" //导入插件,只需执行一次
zm.Init  //初始化插件,只需执行一次

If zm.OcrBaiDuInit("请修改成你的API Key", "请修改成你的Secret Key") Then
  TracePrint "设置百度云识别成功"
Else
  TracePrint "设置百度云识别失败"
End If

//本命令内置找到后点击, 其他用法例子与zm.FindStrBaiDu()相同
Dim ret
ret = zm.FindStrTapBaiDu("紫猫学院")
If ret Then
    TracePrint "文字找到并执行了点击"
Else
    TracePrint "没有找到文字, 不执行点击"
End If

备注

本命令调用百度云的通用文字识别（含位置信息版）功能实现找字, 此命令的任何充值消费行为均与紫猫编程学院无关
请自己注册帐号, 试用后再决定是否充值使用
后台创建步骤:
- 前往百度云AI官网注册并登录
- 打开文字识别控制台
- 点击创建应用, 并输入应用名称与应用描述
- 查看刚刚创建的应用, 就可以查到API Key和Secret Key
- 百度云识别的API接口文档
V3.1839: 加入命令
V3.1849: 支持超级缩放
V3.1902: 优化百度云找字功能, 内部先使用zm.OcrBaiDu()函数查找是否存在文字, 若存在则调用含位置信息版的识别, 以节省次数