系统要求与环境准备
硬件需求
- 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)。
步骤 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)
- 位置步进:单次移动的最大距离
- 角度步进:单次旋转的最大角度
性能优化技巧
- 网络优化:使用 5GHz WiFi 频段,确保头显与主机在同一局域网
- 延迟降低:调整发送间隔到 50ms 以下获得更实时响应
- 精度提升:适当降低缩放因子获得更精细控制

