zm.FindStrTapYouTu 优图找字点击
🎯功能
与zm.FindStrYouTu 优图找字类似, 区别在于本命令内置找到后点击. 由于查找与点击是两个动作组成, 为方便代码阅读理解, 故新增本命令
📜语法
结果 = zm.FindStrTapYouTu([对象][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}
, 没找到或出错返回null
, 使用方法请看示例
💡示例
Import "zm.luae" //导入插件,只需执行一次
zm.Init //初始化插件,只需执行一次
If zm.OcrYouTuInit("请修改成你的AppID", "请修改成你的AppKey") Then
TracePrint "设置优图AI识别成功"
Else
TracePrint "设置优图AI识别失败"
End If
//本命令内置找到后点击, 其他用法例子与zm.FindStrYouTu()相同
Dim ret
ret = zm.FindStrTapYouTu("紫猫学园")
If ret Then
TracePrint "文字找到并执行了点击"
Else
TracePrint "没有找到文字, 不执行点击"
End If
📘备注
- 本命令调用腾讯优图OCR的识别功能, 与百度云识别相比, 目前优图OCR完全免费使用
- 本命令只适合正常屏幕方向使用, 横屏情况推荐使用zm.FindStrBaiDu 百度云找字
- 获取优图AppID和AppKey的步骤:
- V3.1839: 加入命令
- V3.1849: 支持超级缩放