点击节点
<h1>点击节点</h1>
<h2>功能描述</h2>
<p>本功能用于查找并点击指定的节点,支持多种点击方式和参数配置。</p>
<h2>输入参数</h2>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>必填</th>
<th>默认值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>ID</td>
<td>字符串</td>
<td>否</td>
<td>空</td>
<td>节点resource-id</td>
</tr>
<tr>
<td>文本</td>
<td>字符串</td>
<td>否</td>
<td>空</td>
<td>支持模糊匹配(如<code>登录</code>匹配包含“登录”的文本)</td>
</tr>
<tr>
<td>类名</td>
<td>字符串</td>
<td>否</td>
<td>空</td>
<td>节点className</td>
</tr>
<tr>
<td>包名</td>
<td>字符串</td>
<td>否</td>
<td>空</td>
<td>应用packageName</td>
</tr>
<tr>
<td>描述</td>
<td>字符串</td>
<td>否</td>
<td>空</td>
<td>支持模糊匹配(如<code>未读</code>匹配包含“未读”的文本)</td>
</tr>
<tr>
<td>查找范围</td>
<td>字符串</td>
<td>否</td>
<td>全屏</td>
<td>格式"x,y,width,height"</td>
</tr>
<tr>
<td>点击节点位置</td>
<td>数字</td>
<td>否</td>
<td>1</td>
<td>指定点击目标在数组中的位置(从1开始,负数表示倒数)</td>
</tr>
<tr>
<td>点击模式</td>
<td>字符串</td>
<td>否</td>
<td>指定位置</td>
<td>可选值:<code>指定位置</code>(中心点)、<code>随机位置</code>(区域内随机)、<code>所有位置</code>(点击所有匹配节点)</td>
</tr>
<tr>
<td>点击/等待时长</td>
<td>字符串</td>
<td>否</td>
<td>0.5-1</td>
<td>格式为<code>点击时长-等待时长</code>(单位:秒)</td>
</tr>
</tbody>
</table>
<h2>使用示例</h2>
<h3>基础点击</h3>
<pre><code class="language-javascript">// 点击登录按钮
ID = &quot;com.example:id/login_btn&quot;
类名 = &quot;android.widget.Button&quot;</code></pre>
<h3>模糊匹配点击</h3>
<pre><code class="language-javascript">// 点击包含“未读”字样的文本
文本 = &quot;未读&quot;</code></pre>
<h3>指定位置点击</h3>
<pre><code class="language-javascript">// 点击第二个匹配的节点
点击节点位置 = 2</code></pre>
<h3>随机位置点击</h3>
<pre><code class="language-javascript">// 在匹配节点的区域内随机点击
点击模式 = &quot;随机位置&quot;</code></pre>
<h2>返回值</h2>
<ul>
<li><code>true</code>:点击成功</li>
<li><code>false</code>:未找到节点或点击失败</li>
</ul>
<h2>日志输出</h2>
<ul>
<li>✔ 找到节点时输出节点信息</li>
<li>✘ 未找到节点时输出条件详情</li>
<li>➤ 调试模式下显示完整查找条件</li>
</ul>
<h2>注意事项</h2>
<ol>
<li>多个条件为AND关系。</li>
<li>模糊匹配支持简单文本(如<code>登录</code>),复杂匹配由代码自动处理。</li>
<li>范围参数为空时搜索全屏。</li>
<li>性能建议:优先使用ID定位。</li>
</ol>