手机屏幕解锁
手机屏幕解锁 用于解锁当前设备的屏幕（点亮并解除锁屏），让后续的点击、输入、滑动等操作可以正常执行。它通常放在流程开头，作为操作设备前的准备步骤。
指令标识：MobileUnLockScreen
指令类型：手机指令
指令描述：手机屏幕解锁
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。手机屏幕解锁 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐先学） | 拖入「手机屏幕解锁」节点，通常放在流程开头，无需额外参数 | 大多数用户，零代码，适合快速搭建和调试 |
| 代码编排（Python） | 在脚本中调用 bots.mobileUnLockScreen() | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。
什么时候用？
Section titled “什么时候用？”- 设备处于锁屏或息屏状态，需要先解锁才能操作。
- 流程开始前统一保证设备处于可操作状态，减少环境差异。
- 长时间无操作导致设备自动锁屏后，恢复操作前先解锁。
- 当前流程已经连接并占用了一台可用的手机设备。
- 设备未设置复杂的密码/图案锁，或已通过其他方式处理锁屏密码。
- 设备允许通过自动化方式解锁。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”下面用一个常见场景演示：流程开始时先解锁屏幕，再打开目标应用。按 3 步即可跑起来：
- 在工作流画布中添加 手机屏幕解锁 指令，放在连接设备之后、操作之前。
- 该指令无需配置业务参数，直接保留默认即可。
- 点击运行，确认屏幕已点亮并进入主屏幕，再继续后续的 打开应用 等操作。
【图片占位 | command-mobileunlockscreen-config】
截图内容建议： 截一张可视化编排页面，画布选中「手机屏幕解锁」节点，右侧属性面板显示无业务参数需要配置。
标注建议： 用 ① 标出画布中的节点，用 ② 标出运行按钮，用 ③ 标出运行后设备屏幕已解锁的状态。
用户看完应能明白： 这个指令通常放在流程开头，不需要填写参数，运行后设备屏幕被解锁。
该指令无业务输入参数，仅依赖已连接的设备上下文。
该指令无输出参数。是否成功建议通过运行日志与后续操作能否正常执行来判断。
手机屏幕解锁节点运行结束后状态为成功。- 运行日志中没有参数缺失、超时或执行失败等错误。
- 后续节点能够继续执行，流程没有因为该节点异常中断。
| 现象 / 报错原文 | 可能原因 | 处理建议 |
|---|---|---|
日志报 Mobile device not configured | 流程未连接设备 | 先执行连接/占用设备节点，或在全局变量中配置设备上下文 |
日志报 Mobile API ... business error | 移动端服务异常或设备失联 | 检查设备在线状态与移动端服务连通性，重连设备后重试 |
| 屏幕点亮但仍停留在锁屏页 | 设备设置了密码/图案锁 | 关闭设备锁屏密码，或在解锁后增加输入密码、滑动等处理步骤 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。
# 解锁手机屏幕bots.mobileUnLockScreen()如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。
Q1：能解锁有密码的设备吗？
Section titled “Q1：能解锁有密码的设备吗？”A： 该指令负责点亮并解除滑动锁屏。如果设备设置了 PIN、密码或图案锁，需要在解锁后再配合输入密码、滑动等操作处理，建议在测试设备上关闭复杂锁屏。
Q2：设备本来就是亮屏的，再执行会有问题吗？
Section titled “Q2：设备本来就是亮屏的，再执行会有问题吗？”A： 不会。设备已处于解锁状态时再次执行通常不会产生副作用，仍会保持可操作状态。