Field Test · v0.1.0
云端联调说明
发给测试同事：双节点地址、APK 编译、账号与验收流程。本页可浏览器打印为 PDF 转发。
云端 vs APK
云端已部署的是 API、专家 Web、LiveKit、数据库（Docker 服务），不是 APK。
眼镜 APK 必须在有 Android SDK 的电脑上本地编译，再通过 ADB / U 盘安装；编译时把 API 地址写成下方节点表格中的 HTTPS 即可。
两个云端节点
| 用途 | 国内推荐 (hk-*) | 海外主站 |
|---|---|---|
| 专家 Web | hk-www.goowave.net | www.goowave.net |
| REST API | https://hk-api.goowave.net/v1/ | https://api.goowave.net/v1/ |
| LiveKit | wss://hk-lk.goowave.net | wss://lk.goowave.net |
| 健康检查 | /v1/health → ok:true | 同上 |
演示账号（密码 demo1234）
- 巡检员
operator.demo— 眼镜登录 - 专家
expert.demo— 专家工作台 - 管理员
admin.demo— 后台演示
编译 Cloud APK
cd apps/glasses-android # 国内边缘 ./gradlew assembleDebug -PapiBaseUrl=https://hk-api.goowave.net/v1/ # 美国主站 ./gradlew assembleDebug -PapiBaseUrl=https://api.goowave.net/v1/ # 输出 → app/build/outputs/apk/debug/app-debug.apk adb install -r app-debug.apk
唤醒词与 HUD
- 中文唤醒词：谷粒谷粒（Goolton 出厂词，无需重新训练）
- 开工示例：「谷粒谷粒，今天巡检泵房」或 HUD 内语音按钮
- HUD 已缩小约 50% 适配 25° 窄视场，中间区域可滚动
联调步骤
- curl 或浏览器确认 API health 返回 ok
- 专家 Web 登录 expert.demo，打开 /expert
- 眼镜安装 Cloud APK，演示二维码登录
- 到点 → briefing → 按 SOP 步骤操作
- 眼镜点「开始 CameraX→LiveKit 推流」，授权相机/麦克风
- 专家 Web 点「订阅 LiveKit 第一视角」查看画面
常见问题
- 眼镜连不上 API — 确认是 cloud 包（非 LAN 包）；公网可达；health 正常
- 专家无画面 — 眼镜与专家用同一节点（hk 对 hk）；推流状态为「推流中」
- HUD 显示 — v0.1.0 已缩小约 50% 适配 25° 视场；唤醒词为「谷粒谷粒」
- Gradle 编译 — JDK 17 + Android SDK；仓库路径无空格/&
GlaxReality · 仓库 docs/71-colleague-cloud-test-handout.md · 服务器 /opt/jarvis/docs/