Hamibot 提供了多种 API 接口，可用于脚本开发和功能调用。以下是一些常见的 API 接口：

1. 全局 API：

   • requiresApi(api)：确保脚本运行的 Android API 版本不低于指定版本。
   • requiresHamibotVersion(version)：确保脚本运行的 Hamibot 版本不低于指定版本。
   • random(min, max)：生成一个在 [min, max] 区间内的随机数。
   • hamibot.exit()：立即停止脚本运行。
   • waitForPackage(packageName)：等待当前界面为指定的应用包名。

2. 定时器 API：

   • setTimeout(function, delay)：在指定时间后执行一次函数。
   • setInterval(function, delay)：每隔指定时间重复执行函数。

3. 应用操作 API：

   • app.sendEmail(options)：根据选项调用邮箱应用发送邮件。
   • app.startActivity(name)：启动 Hamibot 的特定界面，例如日志界面。

4. REST API：

   • 所有 API 访问都通过 HTTPS 进行，地址为 https://api.hamibot.com/ 或 https://api.hamibot.cn/（已备案）。
   • 身份验证通过个人访问令牌（在标头中发送）。

这些 API 可以帮助你更灵活地开发和控制脚本的行为。如果需要更详细的文档或示例，请参考 Hamibot 的官方文档。

补充回答 1

通过 Hamibot 的 API 接口发送的消息，可以通过以下方式接收和响应：

1. 接收消息

• 使用 /v1/message/send 接口发送的消息，会推送到 通知管理 中选择的设备。
• 控制台会收到通知，方便信息回看。

2. 响应消息

• 发送消息的接口本身没有直接的响应机制，但你可以通过以下方法实现响应：
  • 在脚本中监听通知：在脚本中使用 notification.on() 监听通知，当收到特定通知时触发相应操作。
  • 结合其他 API：例如，可以在接收到消息后，调用其他 API（如 app.startActivity()）执行具体操作。

示例代码

// 监听通知
notification.on("your_notification_tag", function (notification) {
    // 处理接收到的消息
    toast("收到消息: " + notification.text);
});

注意事项

• 确保设备已正确配置通知管理。
• 消息内容支持 Markdown 格式，可以丰富消息展示。

如果你需要更详细的示例或有其他问题，请随时提问！

补充回答 2

getPackageName 是 Hamibot 中的一个函数，用于根据应用名称获取对应的应用包名。

语法

var packageName = getPackageName(appName);

参数

• appName：应用名称（字符串类型），例如 "微信"。

返回值

• 返回应用的包名（字符串类型），例如 "com.tencent.mm"。
• 如果找不到对应的应用，返回 null。

示例

var packageName = getPackageName("微信");
log(packageName); // 输出：com.tencent.mm

注意事项

• 如果传入的是包名而不是应用名称，getPackageName 可能无法正确识别，此时可以使用 getAppName 函数反向获取应用名称。
• 该函数也可以作为全局函数直接调用。

如果你有其他关于 Hamibot API 的问题，欢迎继续提问！