# webxr-dev-boot

**Repository Path**: luzhihaoTestingLab/webxr-dev-boot

## Basic Information

- **Project Name**: webxr-dev-boot
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-05
- **Last Updated**: 2026-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WebXR VR Demo

基于 [A-Frame](https://aframe.io) 的 WebXR 交互 Demo，专为 **Meta Quest 3S** 设计，浏览器打开即用。

## 功能

- **抓取 & 投掷** — 手柄靠近物体按侧键（Grip）抓取，松手投掷
- **传送移动** — 摇杆前推瞄准地面弧线，松手传送
- **物理模拟** — 物体有重力、碰撞，可堆叠互动
- **场景** — 墙壁、桌子、地面构成的房间，9 个可交互物体（方块、球、圆柱）

## 快速开始

### 1. 启动本地服务器

```bash
npx serve --ssl
```

> WebXR 要求 HTTPS，`serve` 会自动生成自签名证书。

### 2. 在 Quest 上访问

1. Quest 和电脑连接**同一 WiFi**
2. 打开 Quest 自带的 **Meta Quest Browser**
3. 地址栏输入 `https://<你电脑的局域网IP>:3000`
4. 首次访问会提示证书不安全 → 点击「高级」→「继续访问」
5. 点击页面上的 **"进入 VR 模式"** 按钮

### 3. 桌面调试（无 Quest）

在 Chrome 安装 [WebXR API Emulator](https://chromewebstore.google.com/detail/webxr-api-emulator/mjddjgeghkdijejnciaefnkjmkafnnje) 扩展，用鼠标模拟 VR 手柄。

## 技术栈

| 库 | 用途 |
|---|---|
| [A-Frame 1.5](https://aframe.io) | VR 场景框架 |
| [aframe-physics-system](https://github.com/n5ro/aframe-physics-system) | 物理引擎 |
| [aframe-extras](https://github.com/n5ro/aframe-extras) | 抓取、传送、手柄控制 |

## 文件结构

```
vr-dev-boot/
└── index.html    # 全部代码（单文件）
```

## 操作说明

| 操作 | 手柄按键 |
|---|---|
| 抓取物体 | 侧键（Grip） |
| 松手投掷 | 松开侧键 |
| 传送移动 | 摇杆前推 → 瞄准 → 松手 |
| 退出 VR | 手柄 Oculus 键长按 |