用途:通过 EvenHub 眼镜模拟器暴露的本地 HTTP API,以程序化方式测试或控制模拟器。启动命令:evenhub-simulator https://my-app.example.com --automation-port 9898,基址为 http://127.0.0.1:<PORT>。
主要能力:GET /api/ping 健康检查返回 pong;GET /api/screenshot/glasses 返回 LVGL 帧缓冲 PNG(576×288,RGBA);GET /api/screenshot/webview 用 html2canvas 截取主 webview,可能需数秒,10 秒超时;GET /api/console 返回 console 输出、未捕获异常、未处理 Promise 拒绝和失败 fetch,支持 ?since_id=N 增量轮询,DELETE /api/console 清空缓冲;POST /api/input 发送 up、down、click、double_click 触控板动作,返回 { "ok": true }。
使用方式:先 ping 确认服务运行,轮询等待应用就绪日志(清空缓冲前先读取,避免丢失启动日志),用截图或控制台观察状态,再发送输入,每次动作后约等 300ms 确认状态变化,轮询时用 since_id 避免重复读取。
限制:眼镜截图须保持 RGBA,不要转 RGB,否则背景与文字像素无法区分(背景 alpha=0,文字 alpha=255);since_id 必须为非负整数,传负数会报错;输入仅在应用创建活动事件容器时生效,否则被静默忽略;启动后建议等待 4 秒以上再轮询。