第 4 次课 · 用 WebXR 生成一座故宫

第 4 次课《虚拟现实开发常用软件(网页端路线)》的全部可运行材料。 含 1 个完整场景 + 7 个逐点讲解的入门演示 + 1 个完整小应用 + **1 份上一代的 A-Frame 存档**。

本课主线 · 完整场景
故宫 · 紫禁城 WebXR 沉浸漫游
午门→内金水桥→太和门→太和殿→中和殿→保和殿的中轴全院,程序化建模 + 程序化贴图, 零外部请求。动态昼夜、单平行光 2048 阴影;PC 拖拽环视 / WASD / 点击传送,VR 扳机传送 + 摇杆移动 + 30° snap 转向; 右上角实时显示 FPS / DrawCall / 三角面。已做成可安装的 PWA。
gugong_webxr.html(+ 同目录 three.min.js)
配套 · 7 个逐点讲解演示
WebXR 教学演示目录
最小可运行场景(逐行讲解)/坐标系与相机/光照与材质/帧循环与 deltaTime/ 程序化几何与贴图/性能对比(独立 Mesh 与 InstancedMesh 合批)/进入 VR 的四步检查与安全上下文。 每个演示只讲一个点,PPT 讲到哪儿就点开哪个。
demos/index.html
课堂示例 · 完整小应用
WebXR 实验馆:高尔夫 + 射击
两个能进头显的小体验:挥杆击球看距离、射线打靶计分。带菜单、得分、退出按钮与性能读数面板—— 可以看成"把前面 7 个演示拼起来的一个完整小作品"。已全部本地化,不依赖网络。
demos/example-vr-experience-hall.html(+ OrbitControls.js,共用本地 three.min.js)

前两代存档(都是 A-Frame 时期)

为什么这里会留着两代旧版本? 本课的故宫场景一共做过三代:
第一代(A-Frame,2026-09-21)——目的是"试探":验证 PICO 浏览器到底支不支持 WebXR,顺便复现 「浏览器 + 3D + 图文讲解 + 热点跳转」这种课堂形态;
第二代(A-Frame,2026-09-21 晚)——把场景做实:程序化屋顶斗拱、烘焙阴影、实例化合批, 并写下一份实测性能预算;
第三代(主线,即上面的内容)——改成自写 Three.js,也就是上面那座紫禁城与 7 个逐点演示。
主线走第三代。前两代留档,因为里面有几样第三代没有、或者后来被重新发现的东西: ① 一份写清"为什么这么优化"的性能文档;② 把调试面板画进 3D 场景里的做法 (进了沉浸模式浏览器不渲染 DOM 覆盖层,面板只能做成 3D 物件才看得见); ③ 那四行能力自检,以及那句至今仍然关键的话——"不是安全上下文时 navigator.xr 缺失是正常的, 不能据此判断设备支不支持"。
第一代 · A-Frame 原型(2026-09-21)
故宫有字 · 图文导览原型
一个简化的太和殿:地面、三层台基、殿身、重檐、六根红柱,加一块匾额与一块讲解面板。 四个可点击热点用视线注视 1.2 秒触发(fuse),桌面端也可以用鼠标点。 左上角是那四行能力自检。保留原样存档,未做修改;也从未在真实头显上验证过—— 当时卡在"需要一次安全上下文有效的真机测试"这一步。详见存档说明。
legacy-aframe-guide/index.html(+ js/demo.js + js/aframe.min.js,无 CDN 依赖) · 存档说明
第二代 · A-Frame(2026-09-21 晚)
太和殿 · 故宫沉浸式场景
A-Frame 版太和殿:程序化屋顶与斗拱、烘焙太阳投影、实例化合批。 左上角有"运行环境自检"四行(安全上下文 / navigator.xr / immersive-vr / 场景), 进 VR 后 DOM 不可见,所以真正的控制台做进了 3D 场景里。
legacy-aframe/index.html(+ js/ + lib/aframe.min.js)
第二代 · 性能文档
性能优化方案与交互控制逻辑
实测预算:三角面 33k–38k、draw call 47–68、8 张程序化贴图、9 个共享材质、无后处理; 以及六条优化的**理由**(为什么要实例化、为什么阴影要烘焙不要实时、为什么移动 XR 上不做 bloom)。 讲"性能"那一段可以直接用这份数据当对照。
legacy-aframe/PERFORMANCE.md
在头显里怎么打开? 本站是 https,所以在头显浏览器里直接打开就能进沉浸模式。 如果你要打开的是放在自己电脑上的页面,见 学生作品 · 联网自验工作流——局域网 http:// 不算安全上下文, 会看不到 VR 按钮。
← VR 课程演示总目录 ← 返回站点首页