当需要同时控制多台安卓设备运行脚本时，手动逐台操作不仅耗时费力，还容易出现操作失误，影响脚本运行效率。按键精灵安卓小精灵推出的HTTP服务模块，为批量控制脚本提供了便捷解决方案——通过简单的API接口调用，即可实现多设备脚本的统一启停、运行状态查询、配置参数修改，提升自动化运营效率。
软件版本要求
批量控制功能依赖特定版本的软件支持，务必提前确认以下版本达标：
安卓小精灵：6.7.5及以上版本（低于该版本将无法使用HTTP服务模块）；
按键精灵手机助手：4.6.0及以上版本（用于脚本打包与设备管理）；
统一响应格式
所有 API 响应均采用统一的 JSON 格式：
| code | message | 说明 |
| 200 | success | 请求成功 |
| 400 | 请求参数错误 | 参数缺失或无效 |
| 404 | 未找到对应的API接口 | API不存在 |
| 408 | 执行超时 | 请求处理超时 |
| 500 | 错误信息 | 服务器内部错误 |
基础接口
| 接口 | 方法 | 说明 |
| / 或 /health | GET | 健康检查，返回服务器运行状态 |
响应状态码
系统信息接口
GET
/api/v1/system/env
获取设备环境信息
响应示例
-
{
-
"code": 200,
-
"message": "success",
-
"data": {
-
"hasRoot": true,
-
"systemVersion": "Android 10",
-
"sdkVersion": 29,
-
"resolution": "1080x1920",
-
"width": 1080,
-
"height": 1920,
-
"dpi": 480,
-
"deviceModel": "Pixel 4",
-
"brand": "Google"
-
}
-
}
GET
/api/v1/script/info
获取脚本信息
响应示例
-
{
-
"code": 200,
-
"message": "success",
-
"data": {
-
"id": "script_001",
-
"name": "自动化脚本",
-
"status": "running",
-
"version": "1.0.0",
-
"appVersion": "2.5.1"
-
}
-
}
/api/v1/script/execute
执行脚本
请求参数
-
{
-
"delayTime": 2, // 延迟执行时间（秒），可选
-
"timeout": 60 // 超时时间（秒），可选
-
}
-
{
-
"code": 200,
-
"message": "Script executed successfully",
-
"data": {
-
"status": "completed",
-
"startTime": "2026-04-17T10:30:00Z"
-
}
-
}
POST
/api/v1/script/pause
暂停脚本
响应示例
-
{
-
"code": 200,
-
"message": "脚本已暂停",
-
"data": {
-
"status": "paused",
-
"pauseTime": "2026-04-17T10:35:00Z"
-
}
-
}
/api/v1/script/stop
停止脚本
响应示例
-
{
-
"code": 200,
-
"message": "脚本已停止",
-
"data": {
-
"status": "stopped",
-
"stopTime": "2026-04-17T10:40:00Z"
-
}
-
}
/api/v1/script/config
设置脚本配置
请求参数
-
{
-
"configKey1": "configValue1",
-
"configKey2": "configValue2"
-
}
-
{
-
"code": 200,
-
"message": "配置更新成功",
-
"data": {
-
"updateTime": "2026-04-17T10:45:00Z"
-
}
-
}
使用示例
通过 ADB 命令启动服务
-
# 启动HTTP服务器（默认端口8080）
-
adb shell am startservice -a HTTPD_ACTION_START_SERVER com.cyjh.elfin/.nanohttpd.service.HttpServerService
-
-
# 指定端口启动HTTP服务器
-
adb shell am startservice -a HTTPD_ACTION_START_SERVER --ei port 9000 com.cyjh.elfin/.nanohttpd.service.HttpServerService
-
-
# 停止HTTP服务器
-
adb shell am startservice -a HTTPD_ACTION_STOP_SERVER com.cyjh.elfin/.nanohttpd.service.HttpServerService
-
-
# 端口转发
-
adb forward tcp:8080 tcp:8080
-
-
# 移除端口转发
-
adb forward --remove tcp:8080
-
-
# 移除所有端口转发
-
adb forward --remove-all
HTTP 请求示例
-
# 健康检查
-
curl http://localhost:8080/health
-
-
# 获取系统环境信息
-
curl http://localhost:8080/api/v1/system/env
-
-
# 获取脚本信息
-
curl http://localhost:8080/api/v1/script/info
-
-
# 执行脚本（带延迟）
-
curl -X POST http://localhost:8080/api/v1/script/execute \\
-
-H "Content-Type: application/json" \\
-
-d '{"delayTime": 2}'
-
-
# 暂停脚本
-
curl -X POST http://localhost:8080/api/v1/script/pause
-
-
# 停止脚本
-
curl -X POST http://localhost:8080/api/v1/script/stop
-
-
# 设置脚本配置
-
curl -X POST http://localhost:8080/api/v1/script/config \\
-
-H "Content-Type: application/json" \\
-
-d '{"speed": "fast", "loopCount": 10}'
依托按键精灵安卓小精灵 HTTP 服务，我们可以轻松实现多设备脚本集中管控。依靠简易的接口调用，即可完成脚本批量启停、运行状态监控与自定义参数修改，轻松摆脱人工逐台操作的麻烦，显著提升日常运维效率。
该方案兼容性强，个人单机多开、工作室集群设备都能直接套用。后续还可按需拓展异常告警、自动重跑等进阶功能，进一步实现脚本运行全流程智能化管理。
按键精灵自动化脚本、iOS 越狱版与免越狱版脚本、root 及免 root 无障碍脚本、iOS15/iOS16 系统脚本，搭配手机群控、微信群控、游戏群控、手机投屏、手机云控及电脑控制手机软件，一站式满足 iOS 自动化与设备管控需求。