点击图片
<h1>点击图片</h1>
<h2>功能描述</h2>
<p>本功能用于在屏幕上查找指定图片并执行点击操作，支持多种点击方式和参数配置。</p>
<h2>输入参数</h2>
<ol>
<li>
<p><strong>主图片</strong>（必填）：
- 描述：需要点击的图片名称，支持以下格式：
- 单张图片：<code>图片1</code>
- 多张图片：<code>图片1|图片2-{3}|图片3-{*}</code>
- 通配符格式说明：
- <code>-{*}</code>：无限通配（如<code>图片-{*}</code>匹配所有以"图片-"开头的图片）
- <code>-{n}</code>：固定数量通配（如<code>图片-{5}</code>匹配以"图片-"开头且后面有5个字符的图片）
- <code>{*}</code>：简单通配（如<code>图片{*}</code>匹配包含"图片"的任意图片）
- <code>{n}</code>：固定长度通配（如<code>图片{3}</code>匹配包含"图片"且后面有3个字符的图片）
- 无通配符：精确匹配（如<code>img</code>只匹配完全相同的图片）
- 示例：<code>按钮|按钮-{5}|按钮-{*}</code></p>
</li>
<li>
<p><strong>状态图片</strong>（可选）：
- 描述：用于判断当前状态的图片，格式同主图片
- 默认值：空
- 示例：<code>状态_正常</code></p>
</li>
<li>
<p><strong>查找范围</strong>（可选）：
- 描述：指定检测的区域范围，格式为<code>x,y,width,height</code>，支持多范围用<code>|</code>分隔
- 默认值：全屏检测
- 示例：<code>100,200,300,400|500,600,200,200</code></p>
</li>
<li>
<p><strong>偏移范围</strong>（可选）：
- 描述：对检测到的坐标进行偏移调整，格式为<code>x,y,width,height-x_offset,y_offset</code>
- 默认值：空
- 示例：<code>128,72,1024,576-128,72</code></p>
</li>
<li>
<p><strong>点击目标</strong>（可选）：
- 描述：指定点击目标，可选值：<code>主图片</code>、<code>状态图片</code>、<code>无状态主图</code>
- 默认值：<code>主图片</code></p>
</li>
<li>
<p><strong>目标分组</strong>（可选）：
- 描述：匹配结果的分组处理方式：
- <code>按图分组</code>：保持原始图片分组结构
- <code>合并分组</code>：将所有匹配结果合并为一组
- 默认值：<code>按图分组</code></p>
</li>
<li>
<p><strong>点击模式</strong>（可选）：
- 描述：点击行为模式，可选值：
- <code>指定位置</code>：点击图片中心位置
- <code>随机位置</code>：在图片区域内随机点击
- <code>所有位置</code>：点击所有匹配到的图片位置
- 默认值：<code>指定位置</code></p>
</li>
<li>
<p><strong>数组位置</strong>（可选）：
- 描述：指定点击目标在数组中的位置（从1开始）
- 默认值：<code>1</code></p>
</li>
<li>
<p><strong>坐标合并</strong>（可选）：
- 描述：是否合并多个坐标，<code>true</code>或<code>false</code>
- 默认值：<code>true</code></p>
</li>
<li>
<p><strong>排序方式</strong>（可选）：
- 描述：坐标排序方式，可选值：
- <code>按名称优先级</code>：按图片名称排序
- <code>按相似度优先级</code>：按匹配相似度排序
- 默认值：<code>按名称优先级</code></p>
</li>
<li>
<p><strong>点击/等待时长</strong>（可选）：
- 描述：点击持续时间和操作间隔（单位：毫秒和秒），格式为<code>点击时长-等待时长</code>
- 默认值：<code>20-40,1-1</code>（点击20-40毫秒，等待1秒）
- 示例：<code>20,1</code>（点击20毫秒，等待1秒）</p>
</li>
<li>
<p><strong>运行模式</strong>（可选）：
- 描述：执行方式：
- <code>单事件模式</code>：只执行一次点击
- <code>顺序模式</code>：按顺序执行所有匹配
- 默认值：<code>顺序模式</code></p>
</li>
<li>
<p><strong>更新截图</strong>（可选）：
- 描述：是否更新截图，<code>true</code>或<code>false</code>
- 默认值：<code>true</code></p>
</li>
<li>
<p><strong>点击范围</strong>（可选）：
- 描述：指定点击的范围模式，可选值：
- <code>随机范围</code>：在区域内随机点击
- <code>固定范围</code>：在区域内固定位置点击
- 默认值：<code>随机范围</code></p>
</li>
<li><strong>点击次数</strong>（可选）：
- 描述：指定点击的次数
- 默认值：<code>1</code></li>
</ol>
<h2>输出结果</h2>
<ul>
<li><strong>点击坐标</strong>：实际点击的位置坐标</li>
<li><strong>匹配数量</strong>：成功匹配的图片数量</li>
<li><strong>日志输出</strong>：
- 成功：<code>✔ [时间] 点击成功 坐标[x,y]</code>
- 失败：<code>✘ [时间] 点击失败 原因[...]</code></li>
</ul>
<h2>典型场景</h2>
<ol>
<li>
<p><strong>基础点击</strong>
- 输入：主图片=<code>确定按钮</code>，点击目标=<code>主图片</code>
- 行为：点击按钮中心位置</p>
</li>
<li>
<p><strong>状态判断点击</strong>
- 输入：主图片=<code>提交按钮</code>，状态图片=<code>提交成功</code>，点击目标=<code>主图片</code>
- 行为：当提交成功图片存在时才点击提交按钮</p>
</li>
<li>
<p><strong>通配符点击</strong>
- 输入：主图片=<code>菜单-{*}</code>，点击目标=<code>主图片</code>
- 行为：点击所有匹配的菜单项</p>
</li>
<li>
<p><strong>长按操作</strong>
- 输入：主图片=<code>长按按钮</code>，点击时长=<code>2000,1</code>，点击目标=<code>主图片</code>
- 行为：长按2000毫秒（即2秒），长按后等待1秒</p>
</li>
<li>
<p><strong>条件点击</strong>
- 输入：主图片=<code>下一步</code>，状态图片=<code>!错误提示</code>，点击目标=<code>主图片</code>
- 行为：当没有错误提示时才点击下一步</p>
</li>
<li>
<p><strong>多范围查找</strong>
- 输入：查找范围=<code>100,200,300,400|500,600,200,200</code>，点击目标=<code>主图片</code>
- 行为：在多个指定区域内查找图片</p>
</li>
<li>
<p><strong>状态图片不存在</strong>
- 输入：主图片=<code>确定按钮</code>，状态图片=<code>加载中</code>，点击目标=<code>主图片</code>
- 行为：当加载中图片不存在时点击确定按钮</p>
</li>
<li>
<p><strong>偏移点击</strong>
- 输入：主图片=<code>按钮</code>，偏移范围=<code>128,72,1024,576-128,72</code>，点击目标=<code>主图片</code>
- 行为：在检测到的坐标基础上应用偏移点击</p>
</li>
<li>
<p><strong>状态图片存在时点击主图</strong>
- 输入：主图片=<code>提交按钮</code>，状态图片=<code>提交成功</code>，点击目标=<code>主图片</code>
- 行为：仅当检测到“提交成功”状态图片时，才点击“提交按钮”</p>
</li>
<li>
<p><strong>状态图片不存在时点击主图</strong>
- 输入：主图片=<code>确定按钮</code>，状态图片=<code>加载中</code>，点击目标=<code>主图片</code>
- 行为：当“加载中”状态图片不存在时，点击“确定按钮”</p>
</li>
<li>
<p><strong>无状态主图点击</strong>
- 输入：主图片=<code>关闭按钮</code>，状态图片=<code>加载中</code>，点击目标=<code>无状态主图</code>
- 行为：当“加载中”状态图片不存在时，点击“关闭按钮”</p>
</li>
<li><strong>多状态判断</strong>
- 输入：主图片=<code>下一步</code>，状态图片=<code>!错误提示|!警告提示</code>，点击目标=<code>主图片</code>
- 行为：当“错误提示”和“警告提示”均不存在时，点击“下一步”</li>
</ol>
<h2>注意事项</h2>
<ol>
<li>通配符匹配优先级：精确匹配 > 固定数量通配 > 无限通配</li>
<li>坐标偏移计算基于图片检测区域</li>
<li>日志详细记录在审计日志中</li>
</ol>