NEXTAP · 本地接口

API 调用示例

调用地址与坐标说明

GET 拼参数即可调用,无需认证;也支持 POST JSON。

每次请求等待返回,再发下一步;返回 ok 为 true 表示成功。普通单次点击、滑动、移动可以直接调用。

先选择设备型号,查看对应的接口和调用库。

i8 · 语言与平台

选择语言或平台,再选择操作。每个平台都有独立案例和下载入口。

同一 Wi-Fi 的电脑或手机,访问 NexTap 手机的局域网地址即可查看此页面、下载调用库。打开页面不会执行动作。

事务锁 让一组动作连续执行

例如“移动 → 点击 → 滑动”需要连贯执行时,先获取锁。锁内只接受携带相同锁编号的动作,防止其他手机或同机其他工具插入操作。

token 是服务自动返回的本次锁编号,无需自己设置;只在事务内使用。最长持锁 30 秒,异常退出后到期自动释放,操作不会自动回滚。回零、校准和切换设备应在获取锁之前完成。

1. 获取锁
timeout_ms可选 · 整数等待获取锁的时间,默认 5000;100–120000 ms。同机已有锁时直接返回失败。
lease_ms可选 · 整数持锁时间,默认 30000;100–30000 ms。整组动作需在此时间内完成。

检查 ok,再保存返回的 token,例如:{"ok":true,"token":"100000001",…}

2. 执行动作时,多带一个 token

  

仍然调用下方的点击、滑动、move 等接口。锁内每个动作都携带相同 token;如果失败,停止后续动作并释放锁。急停随时可以调用,无需锁编号。

3. 无论成功还是失败,最后释放锁
调用库事务案例 · 自动获取和释放

整组动作在 30 秒内完成,逐个等待返回。下方代码会操作设备,请按当前手机修改坐标。回调或 with 内使用 tx,退出后不要继续使用 tx。