点击文本

点击文本 用于根据界面上显示的文本内容定位并点击对应元素。相比写 XPath 选择器，它更直观——直接填写你在屏幕上看到的文字即可点击，适合按钮、菜单、列表项等带文字的元素。

指令标识：MobileClickText
指令类型：手机指令
指令描述：根据文本定位并点击

先选使用方式

工作流支持「可视化编排」和「代码编排」两种创建方式。点击文本 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「点击文本」节点，在右侧表单填写目标文本和超时时间	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `bots.mobileClickText(text="登录")`	熟悉代码、需要复用脚本或批量生成流程的用户

第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。

什么时候用？

目标元素带有明确、唯一的文字，直接按文字点击更省事。
不方便写选择器，或元素没有稳定的 resource-id。
页面上有多个同名文本时，可通过序号选择第几个。

使用前确认

当前流程已经连接并占用了一台可用的手机设备。
目标文本在当前界面可见且尽量唯一。
如果界面存在多个相同文本，已确认要点击的是第几个（序号从 0 开始）。

可视化编排：从 0 到跑通

下面用一个常见场景演示：在登录页点击「登录」按钮。按 3 步即可跑起来：

在工作流画布中添加 点击文本 指令。
在右侧配置面板的文本中填写要点击的文字，例如 登录；如界面有多个同名文本，可在序号中指定第几个。
点击运行，确认页面已响应点击，再继续后续操作。

【图片占位 | command-mobileclicktext-config】
截图内容建议： 截一张可视化编排页面，画布选中「点击文本」节点，右侧属性面板展示「文本」「序号」「超时时间」三个区域。
标注建议： 用 ① 标出画布中的节点，用 ② 标出「文本」输入框，用 ③ 标出「序号」，用 ④ 标出「超时时间」。
用户看完应能明白： 核心是填写要点击的文字，序号和超时时间是按需配置项。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
需要点击的文案	`text`	String	是	-	要点击的目标文本，填写界面上显示的文字。
文案index	`index`	Integer	否	`0`	当界面存在多个相同文案时，通过 index 索引区分（从 `0` 开始）。
超时时间	`timeout`	Double	否	`5000`	高级选项。查找文本元素的最大等待时间，单位毫秒。
是否发送消息	`sendMsgFlag`	Boolean	否	`True`	是否发送节点消息。

输出参数

该指令无输出参数。是否成功建议通过页面响应与运行日志判断。

成功标准

点击文本 节点运行结束后状态为成功。
运行日志中没有参数缺失、超时或执行失败等错误。
后续节点能够继续执行，流程没有因为该节点异常中断。

失败排查

现象 / 报错原文	可能原因	处理建议
日志报 `Mobile device not configured`	流程未连接设备	先执行连接/占用设备节点，或在全局变量中配置设备上下文
超时未找到文本	文本未渲染 / 文字不完全匹配	适当调大超时时间；确认文本与界面显示完全一致（包括空格、标点）
点击到了错误的元素	界面存在多个相同文本	通过 `index` 指定要点击的序号
文本可见但点击无反应	元素被遮挡或不可点击	改用点击配合更精确的选择器，或先滚动到该元素

Python 代码编排

代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。

# 点击界面上的「登录」文本
bots.mobileClickText(text="登录")

当界面存在多个相同文本时，用序号指定第几个，并可调整超时时间：

bots.mobileClickText(
    text="确定",
    index=1,
    timeout=15000,
)

可视化表单里的「文本」「序号」「超时时间」分别对应代码里的 text、index、timeout。

如果你想在工作流中通过节点动态编排指令，可使用执行指令（XML）节点。

常见问题

Q1：文本需要完全匹配吗？

A：建议与界面显示的文字保持一致（包括标点、空格）。文字不完全匹配时可能找不到元素，可改用点击配合更灵活的选择器。

Q2：序号从几开始？

A：从 0 开始。不填写 index 时默认点击第一个匹配项。

Q3：和「点击」有什么区别？

A：点击通过选择器（XPath / 元素 id 等）定位，更灵活；点击文本直接按可见文字定位，更直观，适合带明确文字的元素。