自己制作脚本怎么运行

HAMI_7146922754 · 3 天前

回答

Hamibot AI
1
· 3 天前

自己制作的脚本在 Hamibot 平台上主要有三种运行方式:通过在线 IDE 调试运行、通过手机客户端运行、以及通过 API 接口触发运行。以下是具体操作步骤:

1. 通过在线 IDE 调试运行(推荐开发阶段使用)

这种方式适合脚本编写和调试阶段,可以实时查看日志和运行状态。

  1. 登录控制台:访问 Hamibot 控制台并登录你的账号。
  2. 创建或编辑脚本:进入「开发脚本」页面,创建新脚本或编辑已有脚本。
  3. 连接设备:确保你的 Android 设备已安装 Hamibot 客户端,并登录同一账号,保持设备在线。
  4. 运行脚本
    • 在 IDE 界面顶部选择已连接的设备。
    • 点击「运行」或「调试」按钮。
    • 脚本将下发到设备执行,日志会实时显示在控制台下方的「日志」区域。
    • 也可以在「脚本控制台」中直接运行脚本进行调试。

2. 通过手机客户端运行(推荐正式使用)

脚本编写完成并保存后,可以通过手机 App 直接启动。

  1. 保存脚本:在在线 IDE 中点击「保存」,确保脚本已同步到云端。
  2. 打开 App:在 Android 设备上打开 Hamibot 客户端。
  3. 查找脚本:进入「我的脚本」列表,找到你制作的脚本。
  4. 执行运行:点击脚本对应的「运行」按钮。如果需要配置变量,可以在运行前点击设置进行配置。

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());

注意事项与最佳实践

  1. JavaScript 引擎兼容性
    Hamibot 脚本运行在 Rhino 1.7.15 引擎上,编写脚本时请注意以下兼容性限制:

    • 不要使用箭头函数表达式(例如 () => {}),请使用 function 关键字。
    • 不要定义函数默认参数值。
    • 避免使用 ES6 及以上版本特有的语法特性。
  2. 权限授予
    首次运行脚本时,确保 Hamibot 客户端已获得必要的无障碍服务权限、截图权限等,否则脚本可能无法正常运行。

  3. 变量传递
    如果在运行时需要传递参数,建议使用 hamibot.env 对象在脚本内部获取配置变量,这样可以通过 API 或控制台灵活调整脚本行为。

  4. 日志调试
    多使用 log() 函数输出关键信息,便于在控制台排查问题。

如果在运行过程中遇到报错,请检查设备连接状态、权限设置以及代码语法是否符合引擎规范。

ℹ️ 本回答由 AI 生成,内容仅供参考