雷鸟RayNeo V3 · 纯前端设备控制台

tonwe

https://bbs.naokor.com/app/rayneov3/

一个通过 Web Bluetooth 直接连接雷鸟 V3 的非官方设备控制台。纯静态页面，无第三方依赖，无需 Node 后端。

## 使用方法

1. 在支持 Web Bluetooth 的浏览器中打开页面，点击“连接眼镜”，选择要操作的 V3。
2. 在“连接与网络”中开启 Wi-Fi、扫描并连接网络。
3. 需要无线调试时，点击“开启 / 获取地址”，复制返回的 ADB 连接命令到电脑终端执行。
4. 其他设置可通过对应标签页操作，结果以设备返回的信息为准。

## 使用条件与兼容性

- 浏览器需要支持 Web Bluetooth；桌面 Chrome 可作为使用入口。
- 首次连接需在浏览器中选择设备并授权蓝牙访问。
- 保持眼镜唤醒，必要时先断开其他客户端对眼镜的连接；部分环境可能需要先完成系统蓝牙配对。
- 无线 ADB 要求眼镜先连接 Wi-Fi；使用 ADB 的电脑与眼镜需处于可互通网络。
- 工具没有固定设备名称、MAC 地址或序列号。其他 V3 可以尝试连接，但不同固件的协议与功能支持可能存在差异，不能保证所有设备支持全部设置。

## 操作与功能

顶部是蓝牙连接、断开及设备摘要。功能以标签页组织，日志默认折叠。

| 分类 | 功能 |
| --- | --- |
| 连接与网络 | Wi-Fi 开关、扫描、连接、忘记网络；无线 ADB 开关、地址获取、复制命令 |
| 设备设置 | 名称、设备支持的语言、自动锁定、同步时间/时区、亮度/自动亮度、勿扰、通知、深度休眠、音量同步、语音模式、媒体/通话/系统音量 |
| 拍摄与语音 | 相机配置读取；录像时长、横纵方向、记录位置；音色、AI 开关；AI 键单击/长按、滑动、三指长按映射 |
| 状态详情 | 电量、充电盒、佩戴、固件、系统、存储、完整状态与事件 |
| 协议工具 | 27 个已核对结构的命令模板、JSON 编辑发送、完整相机/语音/按键 JSON 编辑、陀螺仪校准命令、可选心跳应答、168 URI 搜索、状态导出 |
| 日志 | 原始收发报文、搜索、导出、清空；最近 250 条 |

连接只读取基础状态。先配网，再由用户显式开启 ADB。Wi-Fi 关闭或未连接时不盲目发送 enableWirelessAdb；端口 -1 不当作有效地址，最多请求 8 次。蓝牙断开不会自动关闭眼镜无线 ADB，需要断开前单独点击关闭。

设置发送后请求新的回读；匹配目标值才显示确认。没有可用回执的时间同步、ADB 关闭等只显示“已发送”。状态修改先拉取最新完整状态，仅修改指定字段；相机和手势先读取，保留其他配置字段。未上报或标记不可用的状态字段拒绝写入。各类按键和手势分别提供对应的操作选项。

密码输入在发送前清空，不持久化；密码、token 等字段及 JSON 字符串内对应字段在日志/导出中脱敏。所有数据只在当前页面内存中。自定义报文只接受协议目录内的 `ble.response.*`，账号/支付/升级/重置等依赖官方流程的命令不执行。

## 协议与验证边界

通信采用 BLE GATT，以 244 字节分片传输 JSON，包含分片标志与尾部补零，写入操作串行执行。命令结构依据已有协议研究整理，协议目录中的“有抓包记录”不等于对应功能已完整验证。

无线 ADB 开启前会检查设备上报的 Wi-Fi 状态。蓝牙已连接并不代表 Wi-Fi 或 ADB 已就绪。

当前页面未提供远程快门、实时视频、相册下载或 APK 安装；这些功能需要额外的设备服务或本机桥接。设置的实际支持程度由 V3 固件决定，尚未在所有设备与固件上逐项验证。