按键精灵安卓小精灵推出的HTTP服务模块，为批量控制脚本提供了便捷解决方案
当需要同时控制多台安卓设备运行脚本时，手动逐台操作不仅耗时费力，还容易出现操作失误，影响脚本运行效率。按键精灵安卓小精灵推出的HTTP服务模块，为批量控制脚本提供了便捷解决方案——通过简单的API接口调用，即可实现多设备脚本的统一启停、运行状态查询、配置参数修改，提升自动化运营效率。
软件版本要求
批量控制功能依赖特定版本的软件支持，务必提前确认以下版本达标：
安卓小精灵：6.7.5及以上版本（低于该版本将无法使用HTTP服务模块）；
按键精灵手机助手：4.6.0及以上版本（用于脚本打包与设备管理）；
统一响应格式
所有 API 响应均采用统一的 JSON 格式：
{
"code": 200, // 状态码：200表示成功，其他表示错误
"message": "success", // 响应消息
"data": {} // 响应数据（可选）
}
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"
}
}
POST
/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"
}
}
POST
/api/v1/script/stop
停止脚本
响应示例
{
"code": 200,
"message": "脚本已停止",
"data": {
"status": "stopped",
"stopTime": "2026-04-17T10:40:00Z"
}
}
POST
/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 自动化与设备管控需求。
2026-04-30