设备离线问题解决指南

当Hamibot设备显示为离线状态时，通常意味着无法与该设备建立连接来执行自动化任务。以下是常见原因和解决方案：

常见离线原因

• 设备网络连接中断（Wi-Fi/移动数据关闭）
• Hamibot应用被系统强制停止或杀死
• 设备进入深度睡眠状态
• Hamibot应用未设置为"电池优化"白名单
• 设备长时间无操作，系统自动清理后台进程

检查设备状态

你可以通过以下方式检查设备状态：

// 文档地址 https://docs.hamibot.com/
var res = http.request('https://api.hamibot.com/v1/devices', {
  method: 'GET',
  headers: {
    authorization: 'hmp_xxx_your_token', // 替换为你的实际令牌
  },
});
log(res.body.json());

API响应中会包含online字段，true表示在线，false表示离线：

{
  "count": 1,
  "items": [
    {
      "_id": "a51d237e9af41ecc021c9ff6",
      "online": false,  // false表示离线
      "name": "零号机",
      "brand": "Xiaomi",
      "model": "MI 11"
    }
  ]
}

解决方案

1. 确保网络连接正常

   • 检查设备Wi-Fi或移动数据是否开启
   • 确保网络信号稳定

2. 配置设备省电设置

   • 将Hamibot加入电池优化白名单
   • 设置设备永不休眠（设置 > 显示 > 休眠）
   • 在开发者选项中关闭"不保留活动"和"后台进程限制"

3. 应用设置

   • 确保Hamibot应用正在运行
   • 检查Hamibot是否被系统自动管理（需设为手动管理）
   • 开启"保持活跃"功能（Hamibot应用内设置）

4. 设备重启

   • 重启Hamibot应用
   • 必要时重启设备

注意事项

• 离线设备无法接收和执行新的自动化任务
• 长时间离线（超过30分钟）可能导致设备在设备列表中不可见
• 当设备重新上线后，会自动恢复连接状态

如果以上方法无法解决问题，可以通过Hamibot应用内的"反馈"功能提交详细问题描述，我们的技术支持团队会尽快协助你解决。