传统机器人控制往往受限于手柄或键盘，缺乏直观性。引入 XLeRobot 的 VR 系统后，通过 Meta Quest3 头显即可在虚拟环境中实时操控物理机器人，体验显著不同。
🛠️ 系统要求与环境准备
硬件需求
- VR 头显：Meta Quest3（推荐）或兼容的 WebXR 设备
- 机器人：XLeRobot 双机械臂移动平台
- 主机：支持 Python 3.8+ 的电脑，配备 WiFi 6 路由器
软件安装
首先安装 VR 监控系统依赖，进入项目目录执行：
cd XLeVR
pip install -r requirements.txt
VR 控制核心模块位于 XLeVR 目录，包含完整的 Web 界面和数据处理逻辑。
🚀 快速启动 VR 控制
步骤 1：启动 VR 监控服务
运行以下命令启动后端服务：
python vr_monitor.py
服务启动后，终端会显示 HTTPS 访问地址（如 https://192.168.1.100:8443）。注意，由于浏览器安全策略，Quest3 通常需要通过 HTTPS 连接。
步骤 2：头显连接
- 在 Quest3 浏览器中打开显示的 HTTPS 地址
- 点击 "Start" 按钮开始 VR 追踪
- 控制器移动数据将实时传输到机器人系统
步骤 3：机器人控制
使用 VR 控制示例脚本启动机器人控制：
python software/examples/8_xlerobot_teleop_vr.py
此时应能观察到机械臂跟随控制器动作。
🎮 VR 操控核心技术
控制器映射原理
XLeRobot 采用智能的控制器 - 机械臂映射系统，具体对应关系如下：
| VR 控制器动作 | 机器人响应 |
|---|---|
| 握持按钮 (Grip) | 机械臂末端跟随控制器相对移动 |
| 控制器朝向 | 机械腕部关节匹配旋转角度 |
| 触发按钮 (Trigger) | 夹爪开合控制 |
| 摇杆 (Thumbstick) | 机器人底盘移动控制 |
数据流架构
数据流向大致为：Quest3 头显 → WebXR API → WebSocket → VR 监控服务 → 机器人控制指令。
核心数据处理由 XLeVR/xlevr/inputs/vr_ws_server.py 实现，确保低延迟传输。
⚙️ 高级配置与优化
控制参数调整
通过 Web 界面可实时调整控制参数，找到适合自己的手感：
- VR 缩放因子：调整控制器移动与机器人移动的比例
- 发送间隔：控制指令发送频率（建议 10-200ms）
- 位置步进：单次移动的最大距离
- 角度步进：单次旋转的最大角度
