包含本次会话修复: - iOS clickReady 警告 bug(默认 false 永远显示) - BLE 'handle is invalid' 排查(stale handle auto-retry 实验 + 回退) 项目结构: - glass-mouse/: 眼镜端原生 Kotlin App,前台服务 MouseService + 自定义 BLE GATT 桥接 ProxyBleServer + 无障碍 GestureDescription 注入 - ios/GlassRemote/: iPhone 端 SwiftUI + CoreBluetooth,通过 BLE 直连眼镜 - HTTP 投屏服务(:8000) 接 PPT/WPS 备注宏 POST 推送 技术栈: Android Kotlin (gradle 8.14.4, compileSdk 34), iOS Swift 5.10 (Xcode 26.5)
37 lines
2.3 KiB
Markdown
37 lines
2.3 KiB
Markdown
# GlassRemote — iPhone 原生蓝牙遥控器(INMO Air3 眼镜)
|
||
|
||
用眼鏡現有的 BLE GATT 服務(`ProxyBleServer`,UUID `A9E0ABCD-0000-1000-8000-00805F9B34FB`)做原生 iPhone 遥控,
|
||
徹底繞開 Safari + WiFi 的慢路徑。**免改眼鏡 APK**——命令協議與 Mac 端 `ble_proxy.py` 完全一致。
|
||
|
||
## 架构
|
||
- **控制指令(光标/点击/返回/主页/拍照/光标开关/状态)→ BLE(CoreBluetooth,低延迟、无需 WiFi)**
|
||
- **投屏长文本 → BLE 分片直传(无密码、无需 WiFi),`CastView` 调 `ble.sendFragmented` 发送**
|
||
|
||
## 命令映射(与眼镜 `MouseService.handleCommand` 一致)
|
||
| 操作 | JSON |
|
||
|------|------|
|
||
| 移动光标 | `{"type":"mouse","action":"move","dx":N,"dy":N}` |
|
||
| 点击 | `{"type":"mouse","action":"click"}` |
|
||
| 滚轮 | `{"type":"mouse","action":"scroll","dy":N}` |
|
||
| 返回/主页 | `{"type":"key","action":"back"|"home"}` |
|
||
| 拍照 | `{"type":"camera","action":"capture"}` |
|
||
| 光标显隐 | `{"type":"cursor","visible":true/false}` |
|
||
| 查 IP | `{"type":"sys","action":"ip"}` |
|
||
| 查状态 | `{"type":"sys","action":"status"}` |
|
||
| 投屏文字 | `{"type":"text","content":"..."}` |
|
||
| 自动滚动 | `{"type":"text","action":"auto_scroll","content":"...","speed":7}` |
|
||
|
||
BLE 写特征:`A9E0ABCD-0001-1000-8000-00805F9B34FB`;通知特征:`A9E0ABCD-0002-1000-8000-00805F9B34FB`。
|
||
|
||
## 构建与运行
|
||
1. 用 Xcode 打开 `GlassRemote.xcodeproj`(本工程由 `xcodegen` 生成,`project.yml` 可重建)。
|
||
2. 选中 `GlassRemote` target → Signing & Capabilities → Team 选你的 Apple ID(免费账户即可,7 天重签)。
|
||
3. iPhone 与眼镜都打开蓝牙;iPhone 用数据线连 Mac,选设备为目标,▶ Run。
|
||
4. 控制页会自动扫描并连接眼镜;轻点触摸板=点击,滑动=移动光标。
|
||
5. 投屏页:BLE 直连后输入文字 → 📺 投屏 / 自动滚动(长文本自动分片,无密码)。
|
||
|
||
## 已知
|
||
- 点击/返回/滚动依赖眼镜端「无障碍服务」开启(设置→无障碍→GlassMouse),未开时控制页会红条提示。
|
||
- 投屏长文本已支持纯 BLE 分片(`GlassBLEManager` 分片 + 眼镜 `ProxyBleServer` 重组),无需 WiFi WS。
|
||
- 本工程用 `xcodegen`(见 `tools/`)生成;改 `project.yml` 后重跑 `xcodegen generate` 即可。
|