Hamibot自动打卡实现方案

自动打卡主要通过Hamibot模拟人工操作来实现，下面提供一个通用的实现方案：

基本实现思路

1. 启动目标APP（如企业微信、钉钉等）
2. 定位打卡界面（通过控件识别或图像识别）
3. 执行打卡操作（点击打卡按钮）
4. 验证打卡结果（确保打卡成功）

具体实现步骤

1. 前置条件设置

// 文档地址 https://docs.hamibot.com/
auto.waitFor(); // 等待无障碍服务启动
requestScreenCapture(); // 请求截图权限（如果需要图像识别）

// 设置脚本超时时间，防止卡死
threads.start(function() {
    sleep(3 * 60 * 1000); // 3分钟后强制退出
    hamibot.exit();
});

2. 启动打卡应用并进入打卡界面

// 以钉钉为例
launchApp("钉钉");
sleep(5000); // 等待应用启动

// 根据实际情况调整等待时间
// 这里可以使用waitForPackage()等待特定界面

3. 定位并点击打卡按钮（两种常用方法）

方法一：通过控件ID定位（推荐）

// 尝试通过控件ID查找打卡按钮
var punchCardBtn = id("打卡按钮ID").findOne(5000);
if (punchCardBtn) {
    punchCardBtn.click();
    toast("找到打卡按钮，正在打卡...");
    sleep(3000);
} else {
    toast("未找到打卡按钮，尝试其他方法");
}

方法二：通过图像识别定位（需要截图权限）

// 截取当前屏幕
var img = captureScreen();
// 假设已保存打卡按钮的模板图片到sdcard
var template = images.read("/sdcard/punch_card_btn.png");
var point = findImage(img, template);

if (point) {
    click(point.x, point.y);
    toast("通过图像识别找到打卡按钮，坐标: " + point.x + "," + point.y);
    sleep(3000);
} else {
    toast("图像识别未找到打卡按钮");
}

4. 验证打卡结果

// 检查打卡成功提示
var successText = text("打卡成功").findOne(3000);
if (successText) {
    toast("打卡成功！");
    // 可以在这里添加通知或其他操作
} else {
    toast("未检测到打卡成功提示，可能打卡失败");
    // 可以添加重试逻辑
}

注意事项

1. 坐标点击注意事项：

   • 如果使用坐标点击，务必在每个操作后添加适当的sleep()，例如：

   Tap(500, 800); // 点击坐标(500,800)
   sleep(1000);   // 等待1秒确保操作完成
   

2. 事件监听：

   • 可以监听Toast消息来确认打卡结果：

   events.observeToast();
   events.onToast(function(toast) {
       var text = toast.getText();
       if (text && (text.includes("成功") || text.includes("打卡"))) {
           log("检测到打卡结果: " + text);
       }
   });
   

3. 异常处理：

   • 添加try-catch处理可能的异常
   • 考虑网络延迟、界面加载等情况，适当增加等待时间

4. 定时执行：

   • 可以使用Hamibot的定时任务功能设置每天固定时间自动运行
   • 或使用device.wakeUp()唤醒屏幕后执行打卡

针对不同打卡系统的调整

• 企业微信/钉钉：主要通过控件ID或文本识别
• 网页版打卡系统：可能需要先启动浏览器，然后模拟滑动、点击等操作
• 复杂打卡系统：可能需要结合图像识别和坐标点击

记得根据实际打卡应用的界面调整代码中的控件ID、坐标或图像模板，首次使用时建议先手动操作一遍，记录关键界面的元素特征。