编写解锁手机屏幕的脚本需要根据你的设备当前的锁屏类型（如滑动解锁、图案、PIN码、指纹等）来决定具体实现方式。以下是几种常见情况的处理方法和示例代码。

✅ 1. 滑动解锁（无密码）

如果设备是滑动解锁，可以直接通过模拟上滑操作完成。

// 文档地址 https://docs.hamibot.com/

// 确保无障碍服务已启用
auto();

// 模拟从屏幕底部向上滑动以解锁
swipe(500, 1800, 500, 500, 500);

// 延时等待解锁完成
sleep(1000);

坐标说明：swipe(x1, y1, x2, y2, duration)
上例假设分辨率为 1080x2340 左右，请根据实际设备调整坐标。

✅ 2. 数字/字母 PIN 码解锁

如果你知道具体的 PIN 码，并且能定位到按键坐标，可以使用 click(x, y) 或 Tap(x, y)（需 root）进行点击。

示例：输入 PIN 码 1234

// 文档地址 https://docs.hamibot.com/

auto();

// 根据实际屏幕坐标点击数字键（以常见九宫格为例）
function clickKey(x, y) {
    click(x, y);
    sleep(300); // 每次点击后延时
}

// 输入 1, 2, 3, 4（请替换为真实坐标）
clickKey(300, 1000); // 1
clickKey(540, 1000); // 2
clickKey(780, 1000); // 3
clickKey(300, 1200); // 4

// 最后点击确认或回车按钮（视系统而定）
clickKey(900, 1800);

⚠️ 提示：你需要先手动测量每个数字键的坐标（可通过开发者选项中的“指针位置”功能获取）。

✅ 3. 图案解锁（不推荐自动化）

图案解锁涉及多个连续触摸点，普通 API 无法可靠实现。非 root 设备无法稳定支持。若设备已 root，可尝试使用 RootAutomator 配合坐标路径绘制。

Root 示例（仅限已 root 设备）：

// 文档地址 https://docs.hamibot.com/

// 注意：此功能需要 root 权限
var ra = new RootAutomator();
ra.swipe(200, 800, 600, 800, 200); // 第一横
ra.swipe(600, 800, 600, 1200, 200); // 向下
ra.swipe(600, 1200, 1000, 1200, 200); // 第二横
ra.exit();

❗ 安全提示：自动解锁可能带来安全风险，请谨慎使用，避免在公共环境中运行此类脚本。

❌ 不支持的情况

• 面容识别 / 指纹解锁：无法通过脚本触发系统级生物识别。
• 加密锁屏（未知密码）：不能绕过安全机制，否则违反法律法规。

🔐 最佳实践建议

1. 若频繁需要解锁，建议将测试设备设置为“无密码”或“滑动解锁”模式以便自动化。
2. 在脚本开始前确保设备未完全休眠，可配合“保持亮屏”功能使用：

   device.wakeUp(); // 尝试唤醒屏幕
   sleep(1000);
   

3. 结合控件查找（如有“滑动解锁”文字）提升兼容性：

   if (text("滑动").exists()) {
       swipe(500, 1800, 500, 500, 500);
   }
   

如需更稳定的方案，建议结合图像识别（需订阅 Pro 功能）或使用物理外设辅助。对于复杂场景，你可以在 Hamibot 项目平台 发布定制需求寻求专业开发者帮助。