zm.SetFindStr 设置FindStr默认参数

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

功能

修改 zm.FindStr 超级找字 的默认参数值。

语法

默认值 = zm.SetFindStr(属性表)

参数

参数 数据类型 解释
属性表 按照指定格式对表中的键值对进行赋值, 例如{“sim”:0.8, “showlog”:”显示”}表示修改相似度默认为0.8, 日志输出默认为显示, 更多属性见下面表格
属性 默认值 数据类型 解释
x1 0 数值型 查找范围左上角x坐标
y1 0 数值型 查找范围左上角y坐标
x2 0 数值型 查找范围右下角x坐标
y2 0 数值型 查找范围右下角y坐标
color “000000” 字符串 默认文字颜色
sim 0.9 数值型 默认相似度, 取值范围[0, 1.0], 越高越相似
autosim “” 字符串 默认智能相似度, 格式为”最低相似度-最高相似度-相似度步长”
timeout 1 数值型 默认超时时间, 默认1毫秒
delaytime 10 数值型 循环查找间隔时间, 开启超时时间参数后, 如果发现设备出现卡顿, 可加大delaytime
delaytap 0 数值型 找到后如果要点击, 则延时一段时间再点击
tap false 布尔型 找到后是否点击, 默认不点击
showlog “隐藏” 字符串 日志输出显示, 可选 ["显示","显示找到","显示没找到","隐藏","show", "showfind", "shownofind","hide"] 这几个值
ret null 数组型 参数返回值, 只能写数组变量名, 设置后, 若命令不带参数返回值, 则默认返回到此变量中

返回值

, 返回所有默认属性值, 可使用 For Each 遍历查看

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
Import "zm.luae" //导入插件,只需执行一次
zm.Init //初始化插件,只需执行一次

Dim IXYs() //预定义默认参数返回数组
//设置默认参数返回值IXYs, 若找字命令不填写参数返回值, 则默认保存在该变量中
//设置默认日志输出为显示状态, 后面所有 超级找字 都默认输出调试信息
zm.SetFindStr {"ret":IXYs, "showlog":"显示"}
If zm.FindStr("紫猫|学院", "FBFBFB-202020", "0", "mq_soft.txt") Then
TracePrint "可以用以下3种格式获取返回值"
TracePrint "找到序号" & IXYs(0), "x=" & IXYs(1), "y=" & IXYs(2)
TracePrint "找到序号" & IXYs[1], "x=" & IXYs[2], "y=" & IXYs[3]
TracePrint "找到序号" & IXYs["id"], "x=" & IXYs["x"], "y=" & IXYs["y"]
End If

//默认值改动后, 效果会一直存在, 并且可以随时增加新的变化
//此处改动相似度默认为0.8, 超时时间为5000毫秒, 并将日志改为隐藏, 找到后自动点击一次
Dim t = {"sim":0.8, "timeout":5000, "tap":true, "showlog":"hide"}
Dim ret = zm.SetFindStr(t)
//可以通过For Each查看目前所有默认属性值, 参数列表中未出现的属性不建议修改
TracePrint "属性名:属性值"
For Each k , v In ret
TracePrint k, ":", v
Next

备注

  • 请严格按照参数列表的属性名与数据类型进行赋值改动
  • V1.1741: 加入命令
  • V1.1745: 查找次数参数修改为超时参数, 加入自定义日志备注与行号, 其中设置相关的属性也有所变动
  • V3.1835: 加入循环查找间隔时间
  • V3.1849:
    • 加入延时点击属性delaytap
    • 修改循环间隔时间默认为10毫秒
  • V4.2042: 日志参数 showlog 加入 ["显示找到","显示没找到","showfind","shownofind"] 选项