回答
自己制作的脚本在 Hamibot 平台上主要有三种运行方式:通过在线 IDE 调试运行、通过手机客户端运行、以及通过 API 接口触发运行。以下是具体操作步骤:
1. 通过在线 IDE 调试运行(推荐开发阶段使用)
这种方式适合脚本编写和调试阶段,可以实时查看日志和运行状态。
- 登录控制台:访问 Hamibot 控制台并登录你的账号。
- 创建或编辑脚本:进入「开发脚本」页面,创建新脚本或编辑已有脚本。
- 连接设备:确保你的 Android 设备已安装 Hamibot 客户端,并登录同一账号,保持设备在线。
- 运行脚本:
- 在 IDE 界面顶部选择已连接的设备。
- 点击「运行」或「调试」按钮。
- 脚本将下发到设备执行,日志会实时显示在控制台下方的「日志」区域。
- 也可以在「脚本控制台」中直接运行脚本进行调试。
2. 通过手机客户端运行(推荐正式使用)
脚本编写完成并保存后,可以通过手机 App 直接启动。
- 保存脚本:在在线 IDE 中点击「保存」,确保脚本已同步到云端。
- 打开 App:在 Android 设备上打开 Hamibot 客户端。
- 查找脚本:进入「我的脚本」列表,找到你制作的脚本。
- 执行运行:点击脚本对应的「运行」按钮。如果需要配置变量,可以在运行前点击设置进行配置。
3. 通过 API 接口触发运行(适合集成自动化)
如果你需要通过外部系统或另一个脚本来触发开发脚本运行,可以使用 HTTP API。
- 接口地址:
POST /v1/devscripts/开发脚本_id/run - 请求头:需包含 Authorization,值为你的令牌(hmp 开头)。
- 参数:
devices: 要执行脚本的设备列表。vars: 可选,脚本配置变量。
示例代码:
// 文档地址 https://docs.hamibot.com/
var res = http.request('https://api.hamibot.com/v1/devscripts/开发脚本_id/run', {
method: 'POST',
headers: {
authorization: '你的令牌(hmp 开头)',
},
body: {
devices: ['device_id'],
vars: { key: 'value' }
}
});
log(res.body.json());
注意事项与最佳实践
-
JavaScript 引擎兼容性:
Hamibot 脚本运行在 Rhino 1.7.15 引擎上,编写脚本时请注意以下兼容性限制:- 不要使用箭头函数表达式(例如
() => {}),请使用function关键字。 - 不要定义函数默认参数值。
- 避免使用 ES6 及以上版本特有的语法特性。
- 不要使用箭头函数表达式(例如
-
权限授予:
首次运行脚本时,确保 Hamibot 客户端已获得必要的无障碍服务权限、截图权限等,否则脚本可能无法正常运行。 -
变量传递:
如果在运行时需要传递参数,建议使用hamibot.env对象在脚本内部获取配置变量,这样可以通过 API 或控制台灵活调整脚本行为。 -
日志调试:
多使用log()函数输出关键信息,便于在控制台排查问题。
如果在运行过程中遇到报错,请检查设备连接状态、权限设置以及代码语法是否符合引擎规范。
ℹ️ 本回答由 AI 生成,内容仅供参考