matchTemplatesInDisplay

abstract fun matchTemplatesInDisplay(displayId: Int, templatePath: String, similarity: Int?, limit: Int?, config: MatchTemplatesConfig.() -> Unit): Results<RegionResult>

在屏幕中查找匹配的模板(自动申请权限)。

结合屏幕截图与模板匹配功能,直接在指定屏幕中搜索与模板相似的区域。 适用于界面元素定位、自动化操作等场景。

Return

包含所有匹配区域的Results对象,每个结果包含区域坐标和相似度

Parameters

displayId

屏幕标识符:0表示物理屏幕镜像,其他值表示虚拟屏幕

templatePath

模板图像文件路径(小图),作为搜索目标

similarity

匹配相似度阈值(0-100),值越高匹配要求越严格;null使用默认值

limit

最大返回结果数量,null表示无限制

config

配置构建器,用于设置高级匹配参数

See also

了解更多配置选项

Throws

当相似度超出范围、文件路径无效或屏幕ID不存在时抛出

当自动申请权限失败时抛出