输入密码

输入密码 用于向指定的输入框（通常是密码框）输入密码内容。它与普通的文本输入类似，但更适合密码、验证码等敏感字段的录入场景，例如登录、解锁、支付等。

指令标识：MobileInputPassword
指令类型：手机指令
指令描述：输入密码

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「输入密码」节点，在右侧表单填写选择器和密码内容	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `bots.mobileInputPassword(selector="...", password="...")`	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

登录流程需要在密码框中输入密码。
支付、解锁等场景需要输入密码或口令。
需要向敏感输入框录入内容，并希望与普通文本输入区分。

使用前确认

当前流程已经连接并占用了一台可用的手机设备。
目标密码输入框在当前界面可见且可聚焦。
已准备好用于定位输入框的选择器（XPath / 元素 id 等）。
建议通过变量传入密码值，避免在脚本中明文硬编码。

可视化编排：从 0 到跑通

下面用一个常见场景演示：在登录页向密码框输入密码。按 4 步即可跑起来：

在工作流画布中添加 输入密码 指令，通常放在已点击/聚焦密码框之后。
在右侧配置面板的 选择器 中填写密码输入框的定位方式（如 XPath）。
在密码中填写要输入的内容，推荐使用变量引用，例如 ${password}。
点击运行，确认密码已填入输入框，再继续点击登录。

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

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
选择器	`selector`	String	是	-	密码输入框的定位方式，可填写 XPath / 元素 prompt，或从元素库选择元素 id。
密码	`password`	String	是	-	要输入的密码内容。建议通过变量引用（如 `${password}`），避免明文硬编码。
超时时间	`timeout`	Double	否	`5000`	查找输入框元素的最大等待时间，单位毫秒，默认 `5000`。

输出参数

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

成功标准

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

失败排查

现象 / 报错原文	可能原因	处理建议
日志报 `Mobile element task requires "selector" or "selectorId" attribute`	选择器为空	检查「选择器」是否填写；代码编排确认 `selector` 参数已传入
日志报 `Mobile device not configured`	流程未连接设备	先执行连接/占用设备节点，或在全局变量中配置设备上下文
超时未找到输入框	元素未渲染 / 选择器不准确	适当调大超时时间；用获取控件树核对选择器
输入框未填入内容	输入框未获得焦点	先用点击点击输入框确保聚焦后再输入

Python 代码编排

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

# 向密码输入框输入密码
bots.mobileInputPassword(
    selector="//*[@resource-id='password_input']",
    password="${password}",
)

如需调整查找输入框的等待时间，可设置超时：

bots.mobileInputPassword(
    selector="//*[@resource-id='password_input']",
    password="${password}",
    timeout=15000,
)

可视化表单里的「选择器」「密码」「超时时间」分别对应代码里的 selector、password、timeout。

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

常见问题

Q1：和「输入文本」有什么区别？

A：输入文本适用于一般文本录入；输入密码更适合密码、口令等敏感字段，建议配合变量传值，避免明文出现在脚本中。

Q2：怎么避免密码明文暴露？

A：推荐用变量引用（如 ${password}），把真实密码放在受控的变量或配置中，而不是直接写在指令里。