点击Home键
点击Home键 用于在移动设备上模拟用户点击 Home 键，让当前应用切到后台或返回设备主屏幕。它常用于移动端自动化中的应用切换、后台状态验证和流程重置。
指令标识：MobilePressHome
指令类型：移动端指令
指令描述：在设备上执行点击 Home 键操作
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。点击Home键 在两种方式里都能用。该指令无需业务参数，区别主要是你通过界面拖入节点，还是通过 Python 脚本调用。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐先学） | 拖入「点击Home键」节点，连接到需要返回主屏幕的位置 | 大多数用户，零代码，适合快速搭建和调试 |
| 代码编排（Python） | 在脚本中调用 bots.mobilePressHome() | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。
什么时候用？
Section titled “什么时候用？”- 需要把当前应用切到后台，验证后台状态或恢复逻辑。
- 切换到其他应用前，先回到设备主屏幕。
- 移动端流程结束时，需要把设备恢复到主屏幕。
- 需要模拟用户点击 Home 键的真实操作行为。
- 移动设备或云手机已连接，自动化会话处于可执行状态。
- 当前系统支持 Home 键或等效手势，框架会处理 iOS 物理 Home 键与全面屏设备差异。
- 执行后当前应用可能进入后台，后续如果还要操作该应用，需要先重新打开或切回。
- Android 部分厂商桌面启动动画期间可能拒绝再次启动 Activity，必要时在该节点后增加短等待。
【图片占位 | command-mobilepresshome-config】
截图内容建议： 截一张移动端可视化编排页面，画布中选中「点击Home键」节点，右侧属性面板显示该节点无需参数。
标注建议： 用 ① 标出画布中的节点，用 ② 标出移动设备预览区域，用 ③ 标出运行按钮或成功状态。
用户看完应能明白： 这个节点不需要填写参数，执行后设备会回到主屏幕或将应用切到后台。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”下面用一个常见场景演示：在表单应用中完成设置后，点击 Home 键返回主屏幕。按 3 步即可跑起来：
- 先通过移动端节点打开目标应用并完成前置操作。
- 在需要返回主屏幕的位置添加 点击Home键 节点。
- 点击运行，确认设备显示主屏幕，当前应用已切到后台。
该指令无需配置输入参数。
该指令没有输出参数。
- 节点运行成功，日志中没有异常。
- 设备返回主屏幕，或当前应用被切换到后台。
- 后续节点可按预期打开其他应用、重新打开当前应用或继续设备级操作。
运行后你会看到（以上面场景为例）：
- 移动设备预览区域显示主屏幕。
- 当前表单应用不再停留在前台。
【图片占位 | command-mobilepresshome-success】
建议放一张运行成功截图：移动设备已回到主屏幕，节点状态为成功。图片用于说明这个节点执行后的设备状态。
| 现象 / 报错原文 | 可能原因 | 处理建议 |
|---|---|---|
| 节点执行失败 | 移动设备未连接或会话不可用 | 检查设备连接状态，重新连接云手机或本地设备 |
| 执行后应用仍在前台 | 系统拦截、设备状态异常或动画未完成 | 稍等后重试；必要时在该节点后增加短等待 |
| 后续打开应用失败 | Android 桌面启动动画未结束 | 在点击 Home 键后等待 1~2 秒再启动 Activity |
| 后续还想操作原应用但找不到元素 | 应用已被切到后台 | 先使用打开应用或切回应用相关指令，再继续查找元素 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。
# 点击 Home 键，返回设备桌面bots.mobilePressHome()该指令无需任何参数，直接调用即可。
如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。
Q1：该指令需要参数吗？
Section titled “Q1：该指令需要参数吗？”A： 该指令无需任何参数，直接调用即可。在移动端自动化环境下，需确保设备已连接且页面已加载完成。
Q2：iOS设备如何处理？
Section titled “Q2：iOS设备如何处理？”A： iOS 物理 Home 键设备与全面屏设备实现方式不同，框架已做兼容处理。
Q3：执行后应用会怎样？
Section titled “Q3：执行后应用会怎样？”A： 执行 Home 键操作后，应用将被切换到后台或返回桌面，注意后续自动化流程的衔接。
Q4：Android 设备有什么特殊处理？
Section titled “Q4：Android 设备有什么特殊处理？”A： Android 部分厂商在桌面启动动画期间拒绝再次启动 Activity，建议调用后等待 1~2 秒。