Files
adminandClaude Opus 4.8 b6586b843f feat(glass-ppt): 剥离极简眼镜端 App——仅 PPT 备注投屏
官方 App 已实现全部鼠标/遥控操作,眼镜端只需保留 PPT 提词能力:
- com.glass.ppt(与 com.glass.mouse 共存),3 源文件,零第三方依赖
- 协议与 glass-mouse 完全一致(:8000 / POST /ppt/remark / pageNum==0 结束),macros/ 宏零改动可用
- 权限从 10 砍到 4;剥离 BLE/悬浮光标/无障碍/拍照
- 行为增强:App 不在前台收到备注时自动拉起投屏页(ROM 拦截则退化为原版忽略)

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-26 09:55:54 +08:00
..

GlassPPT —— 极简 PPT 投屏眼镜端 App

从 glass-mouse/ 剥离出的精简版:INMO Air3 官方 App 现已实现全部鼠标/遥控操作, 眼镜端只剩一个不可替代的能力——PPT 演讲备注投屏(提词),本 App 只做这一件事。

与 glass-mouse 的关系

glass-mouse(完整版) glass-ppt(本 App)
PPT 备注投屏 ✅ ✅(唯一功能,协议完全一致)
BLE 遥控 / 触控板 ✅ ❌ 交给官方 App
悬浮光标 / 无障碍点击 ✅ ❌ 已剥离
Camera2 拍照 / 亮度音量 ✅ ❌ 已剥离
权限数量 10 个 4 个(INTERNET / FOREGROUND_SERVICE / FOREGROUND_SERVICE_SPECIAL_USE / POST_NOTIFICATIONS)
包名 com.glass.mouse com.glass.ppt(可与 glass-mouse、官方 App 共存安装)

投屏协议(:8000、POST /ppt/remark、{pageNum, remark}、pageNum==0 结束)与 glass-mouse 完全一致,glass-mouse/macros/ 下的 WPS JS 宏 / PowerPoint VBA 宏零改动直接可用。

组成(3 个源文件,零第三方依赖)

android/app/src/main/java/com/glass/ppt/
├── MainActivity.kt     # 主页显示 WiFi IP(供宏配置)+ 全屏投屏层(翻页大字/自动滚动三行跳/10 档/常亮)
├── PptHttpServer.kt    # :8000 仅接收 POST /ppt/remark(GET / 为状态页指纹)
└── PptService.kt       # 前台服务:跑 HTTP 监听 + 每 5s 刷 IP;收到 remark 且 App 不在前台时自动拉起投屏

自动拉起投屏(与原版的行为差异):glass-mouse 在 App 不在前台时直接忽略备注; 本 App 由 PptService startActivity 把投屏页拉到前台。INMO ROM 若拦截后台拉起, 则静默失败退化为原版行为,无副作用。演讲前只要 App 打开过(前台服务常驻)即可。

构建

cd glass-ppt/android
./gradlew assembleDebug --no-daemon
# 产物: android/app/build/outputs/apk/debug/app-debug.apk (~800KB)

安装与使用

  1. 侧载 APK 到眼镜(复用仓库根 download/ 方案):
    cp android/app/build/outputs/apk/debug/app-debug.apk ../../download/
    cd ../../download && python3 -m http.server 18000 --bind 0.0.0.0
    # 眼镜浏览器打开 http://<Mac IP>:18000/ 下载安装
    
  2. 眼镜打开 GlassPPT,屏幕显示本机 WiFi IP(每 5s 自动刷新)。
  3. 把 IP 填进宏顶部 GLASS_IP(宏文件在 glass-mouse/macros/,不用改协议)。
  4. WPS/PowerPoint 放映,每翻一页,当前页备注自动全屏滚动上屏(≈10s/三行,到底循环)。

本地验证(不开会也能测)

# 推一条备注 → 眼镜应全屏滚动显示
curl -X POST http://<眼镜IP>:8000/ppt/remark -H 'Content-Type: application/json' \
  -d '{"pageNum":1,"remark":"这是一条测试备注,应该在眼镜上全屏自动滚动。"}'

# 状态页(扫网段定位眼镜用)
curl http://<眼镜IP>:8000/

# 演示结束信号 → 收起投屏
curl -X POST http://<眼镜IP>:8000/ppt/remark -d '{"pageNum":0,"remark":""}'

已知边界

  • 投屏要求 Activity 可显示;服务刚起、Activity 从未打开过时依赖「自动拉起」,首次使用建议先手动点开一次 App。
  • 同网段无鉴权(与 glass-mouse 一致,演讲场景同 WiFi 均为自己人)。
  • 编译栈与 glass-mouse 相同:AGP 8.4.2 / Gradle 8.14.4 / compileSdk 34 / minSdk 24 / Kotlin,Java 17。