match Templates In Display
abstract fun matchTemplatesInDisplay(displayId: Int, templatePath: String, similarity: Int?, limit: Int?, config: MatchTemplatesConfig.() -> Unit): Results<RegionResult>
在屏幕中查找匹配的模板(自动申请权限)。
结合屏幕截图与模板匹配功能,直接在指定屏幕中搜索与模板相似的区域。 适用于界面元素定位、自动化操作等场景。
Return
包含所有匹配区域的Results对象,每个结果包含区域坐标和相似度
Parameters
display Id
屏幕标识符:0表示物理屏幕镜像,其他值表示虚拟屏幕
template Path
模板图像文件路径(小图),作为搜索目标
similarity
匹配相似度阈值(0-100),值越高匹配要求越严格;null使用默认值
limit
最大返回结果数量,null表示无限制
config
配置构建器,用于设置高级匹配参数
See also
了解更多配置选项
Throws
当相似度超出范围、文件路径无效或屏幕ID不存在时抛出
当自动申请权限失败时抛出