VR 课堂案例库

《虚拟现实技术》课程 2026 秋 · 六个可运行的 WebXR 课堂案例。点开即玩,不需要安装任何东西;用头显打开可以进入沉浸模式。

为什么文件名全是英文? 中文文件名在部分机房电脑(中文 Windows / 旧浏览器)会被按 GBK 编码, 与服务器上的 UTF-8 文件名对不上,就会"打不开"或乱码。本站所有可运行的页面统一用英文名,中文标题写在页面里。
想进 VR 要先满足一个条件:「进入 VR」只在安全上下文里可用。 本站是 https,所以在头显里直接打开就能进。 如果你把自己做的页面放在电脑上、用局域网 IP 打开,按钮会显示"当前浏览器不支持 WebXR"—— 那是假结论,解决办法见 VR 作品自检。
打不开 / 一片黑? ① 用 Chrome 或 Edge(不要用 IE 兼容模式);② 打开浏览器的"使用硬件加速"。 六个案例都需要 WebGL。

六个案例

案例 01 · 第 5—6 次课
VR 交互沙盒
最基础的一间屋子:抓取、投掷、传送、重置。用来练"手柄到底怎么用", 以及第一次完整地"进入 VR → 环视 → 交互 → 退出"。
01-vr-sandbox/index.html
案例 02 · 第 7—9 次课
密室逃脱 · 敦煌寻宝
解谜玩法:找线索、按键盘密码、开门。用来讲"空间里的信息该怎么藏、怎么被找到", 也是第一个需要"多个房间来回走"的案例。
02-dunhuang-escape/index.html
案例 03 · 第 10 次课
节奏竞技 · 编钟之韵
跟着节拍敲编钟。用来讲"时间"这件事在 VR 里怎么做:判定窗口、反馈延迟、 以及为什么 20 毫秒的差别玩家能感觉到。
03-bianzhong-rhythm/index.html
案例 04 · 第 11 次课
数字校园漫游 + AI 导览
360 全景 + 3D 模型 + 导览打卡:走完 5 个站点,每站给一条线索。AI 导览员会回答问题, 成绩(打卡数、用时、求助次数、晕动评级)可以导出成 JSON,作为过程性评价的证据。 (其中"学校事实"部分是课程示例数据,课堂上按学校官网填写后再正式使用。)
04-campus-tour/index.html
案例 05 · 第 8 章 AR
AR 文物复原
把散落的碎片按位置拼回一件器物:讲识别、追踪、虚实对齐,以及"对齐误差"为什么会让人出戏。 (器物信息为课程示例占位,正式使用前替换成真实展品资料。)
05-ar-relic/index.html
案例 06 · 第 12 次课
LLM 智能 NPC「小澜」
和一个能对话的 NPC 聊天,并做一套 8 题三级难度的小测。用来讲"具身交互": 语言模型放进 3D 空间之后,多出来的问题不是模型,而是时机、空间和可信度。 完全离线可用。
06-llm-npc/index.html

通用操作(六个案例都一样)

场景怎么操作
PC(鼠标键盘)鼠标拖拽 = 转头;WASD = 移动;左键 = 传送 / 选择
VR(头显)左摇杆 = 移动;右摇杆左右 = 45° 转向;扳机 = 传送 / 选中;注视某个面板 1.2 秒 = 点击它
辅助功能Shift+P 坐姿模式(界面自动下沉) Shift+H 惯用手 / 单手模式 Shift+G 注视停留
退出 VR三条路任选:面板上的「退出 VR」/长按手柄握把 2 秒/头显系统键
性能读数画面里一直显示 FPS 与 DrawCall;帧率掉下去时内核会自动降级(先降像素比,再关阴影),并提示你为什么

给自己做的作品做一次自检

如果你正在做自己的 VR 页面,先在头显里打开 VR 作品自检, 它会逐条告诉你:现在是不是安全上下文、浏览器有没有 WebXR、设备支不支持沉浸模式、能不能真的进 VR。 先确认环境,再去改自己的代码——不然你会在一个根本进不去的环境里debug。

← VR 课程演示总目录 ← 返回站点首页