隐藏安卓键盘
隐藏安卓键盘 用于在 Android 移动设备上收起系统软键盘。它常用于输入完成后继续点击按钮、切换表单字段或截图，避免键盘遮挡页面控件。
指令标识：MobileHideKeyboard
指令类型：移动端指令
指令描述：在设备上执行隐藏安卓键盘操作
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。隐藏安卓键盘 在两种方式里都能用。这个指令没有业务入参，核心区别是你通过界面拖入节点，还是通过 Python 脚本调用。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐先学） | 拖入「隐藏安卓键盘」节点，放在输入文本之后 | 大多数用户，零代码，适合快速搭建和调试 |
| 代码编排（Python） | 在脚本中调用 bots.mobileHideKeyboard() | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。由于该指令不需要参数，重点是把它放在正确的位置。
什么时候用？
Section titled “什么时候用？”- 输入文本后，需要点击被键盘遮挡的提交按钮。
- 多输入框表单中，需要先收起键盘再切换区域。
- 截图前需要隐藏键盘，确保页面内容完整。
- 键盘导致页面布局变化，影响后续元素定位。
- 需要模拟用户主动收起软键盘的操作。
- 当前运行环境是 Android 移动设备。
- 设备已连接，且当前页面已加载完成。
- 该节点通常放在输入文本节点之后、点击按钮或截图节点之前。
- 键盘未弹出时调用也可以正常返回，不会影响后续流程。
【图片占位 | command-mobilehidekeyboard-config】
截图内容建议： 截一张移动端可视化编排页面，画布中展示「输入文本」后接「隐藏安卓键盘」再接「点击」节点。右侧属性面板显示该指令无需配置参数。
标注建议： 用 ① 标出输入文本节点，用 ② 标出隐藏键盘节点，用 ③ 标出后续点击节点。
用户看完应能明白： 这个指令不需要填写参数，重点是放在输入完成后的合适位置。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”下面用一个常见场景演示：在移动端登录表单输入账号后收起键盘，再点击提交按钮。按 4 步即可跑起来：
- 在移动端流程中先添加输入文本节点，向账号或备注输入框写入内容。
- 在输入文本节点后添加 隐藏安卓键盘 指令。
- 在后续添加点击按钮、验证元素或截图节点。
- 点击运行，确认键盘被收起，后续点击不会被键盘遮挡。
| 界面名称 | 代码属性名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
| - | - | - | - | - | 该指令无需配置输入参数，直接运行即可。 |
| 界面名称 | 代码属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| - | - | - | - | 该指令没有输出参数。 |
- 节点运行状态为成功。
- Android 设备上的软键盘被收起。
- 后续点击、元素定位或截图不再被键盘遮挡。
- 键盘未弹出时调用也能正常返回。
运行后你会看到（以上面场景为例）：
- 输入框内容保留，系统软键盘消失。
- 提交按钮完整露出，后续点击节点可以继续执行。
【图片占位 | command-mobilehidekeyboard-success】
建议放一张运行成功截图：移动设备画面中输入框已有内容，软键盘已收起，底部按钮可见。
| 现象 / 报错原文 | 可能原因 | 处理建议 |
|---|---|---|
| iOS 设备执行失败 | 该指令仅支持 Android 设备 | 在 iOS 流程中使用平台适配的收起键盘方式 |
| 键盘没有收起 | 第三方输入法拦截或设备状态异常 | 尝试使用 安卓返回键 作为备选方案 |
| 后续点击仍被遮挡 | 页面布局收起后仍未稳定 | 在隐藏键盘后增加短暂等待，再执行点击 |
| 执行前键盘未弹出 | 当前页面没有显示软键盘 | 这是正常情况，指令会直接返回 OK |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。
# 隐藏当前设备的软键盘bots.mobileHideKeyboard()该指令无需任何参数，直接调用即可。
如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。
Q1：该指令支持哪些设备？
Section titled “Q1：该指令支持哪些设备？”A： 该指令仅支持 Android 设备，iOS 设备会抛出异常。在移动端自动化环境下，需确保设备已连接且页面已加载完成。
Q2：键盘未弹出时调用会怎样？
Section titled “Q2：键盘未弹出时调用会怎样？”A： 调用前应确保键盘已显示，若键盘未弹出则指令会直接返回 OK，不会抛出异常。这是正常行为，不影响后续操作。
Q3：第三方输入法如何处理？
Section titled “Q3：第三方输入法如何处理？”A： 部分第三方输入法可能拦截该操作导致失败，可使用安卓返回键或点击坐标指令收起键盘。建议使用 安卓返回键 返回键作为备选方案。
Q4：什么时候应该使用该指令？
Section titled “Q4：什么时候应该使用该指令？”A： 建议在每次输入操作后调用该指令，避免键盘遮挡元素。在截图前、多输入框切换前、点击其他元素前都应该隐藏键盘，确保操作的准确性。