# 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` 即可。 ## 应急:跳过 7 天签名过期 每周一次的「未受信任开发者」提示很烦?把 IPA 传到爱思助手,让他们用企业证书帮分发,理论 1 年内不再过期。 ```bash bash build_ipa.sh --strip-profile # 生成可重签 IPA(推荐:剥 profile 让签名服务完全重签) # 然后:上传 build/GlassRemote.ipa 到 爱思助手 Mac 客户端 或 https://www.i4.cn/ ``` 完整流程 + 风险 + 回退方案见 [`COMMUNITY_SIGN.md`](./COMMUNITY_SIGN.md)。**应急用,主路径仍是 `renew.sh` 自签。**