Files
glass/ios/GlassRemote/README.md
T
admin 2840e82685 Initial commit: Android GlassMouse + iOS GlassRemote 智能眼镜遥控项目
包含本次会话修复:
- 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)
2026-08-26 10:34:23 +08:00

37 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` 即可。