① 分发成本几乎为零
做 Unity 项目要经历"打包 → 安装 → 启动";网页端只要一个链接。同学、家人、评委的浏览器都能直接打开,不需要装任何东西,也不经过应用商店审核。
第 4 章 虚拟现实开发常用软件 · 网页端路线:HTML + JavaScript + Three.js + WebXR —— 不装引擎、不导模型,整座紫禁城由代码在运行时算出来
上次课回答"用什么软件做 VR"(Unity 路线),这一课回答"不装引擎,能不能做 VR"
这一讲换了一条技术路线:不安装引擎、不写 C#、不导入模型,只在浏览器里用 HTML + JavaScript 把一座紫禁城"算"出来,然后把它推进头显漫游。
还有一个更现实的理由:这节课的教室里有 40 个人、36 个机位,但只有 1 台 PICO Neo 3。把 180 分钟全给设备,每人也就 4.5 分钟——连戴卸和消毒都不够。所以这节课的组织方式是:人人做出 VR,人人也戴上一次;再用 4 个人替全班测出数据。设备不是"排队体验",而是一条与作业并行的传递流水线:设备一直在传,人不能一直等。
场景支持鼠标环视、WASD 行走、点击地面传送、时辰滑块与 4 个预设机位;用支持 WebXR 的浏览器打开后可点"进入 VR"。本节课的 1:50—2:26 是"全员传看"环节:按座位顺序轮着看,谁看完就让给下一位,不卡个人时间;戴上后只做两件事——环视一眼、说一句话。其余时间大家在 PC 上继续改造自己的场景。2:26—2:36 由 4 位同学做定岗深测(清晰度 / 延迟 / 舒适度 / 比例与退出),全班看投屏。
做 Unity 项目要经历"打包 → 安装 → 启动";网页端只要一个链接。同学、家人、评委的浏览器都能直接打开,不需要装任何东西,也不经过应用商店审核。
改一行代码、刷新页面就是一次完整迭代,不必等构建与部署。做原型验证时,这条路线的时间成本通常是引擎路线的几分之一。
刷新率、分辨率、定位方式这些硬件指标,在浏览器里变成了可以现场读到的数字:FPS 面板、像素比、WebXR 的参考空间。硬件不再是纸上的参数。
| 对比项 | Unity 引擎路线 | WebXR 网页路线(本讲) |
|---|---|---|
| 运行环境 | 独立可执行程序(EXE / APK) | 浏览器(桌面 / 头显一体机) |
| 开发语言 | C# | HTML + JavaScript |
| 场景来源 | 导入模型资产(FBX 等)+ 编辑器摆放 | 代码程序化生成(也可加载外部模型) |
| 部署方式 | 打包、安装、更新 | 一个 URL,零安装、零更新 |
| 性能上限 | 高,可承载复杂场景与精细美术 | 中,受浏览器与移动 GPU 限制 |
| 硬件接入 | 官方 SDK(PICO / Quest 等),功能最全 | 标准 WebXR API,跨设备通用;设备专属能力较少 |
| 典型用途 | 商业项目、复杂交互、重型应用 | 展示与漫游、教学、快速原型、跨设备分发 |
| 本课程定位 | 第 6 章主线(16 学时) | 本讲(第 4 章)的第二条路线,也是期末合集的备选形式 |
| 时段 | 时长 | 环节 | 干什么 |
|---|---|---|---|
| 0:00—0:08 | 8′ | 开场 | 约束说明(40 人 / 36 机位 / 1 台设备)· 本讲地图与产出 · 点清机位与传看顺序 |
| 0:08—0:30 | 22′ | PART 1 WebXR 是什么 | 标准与能力边界 · 安全上下文 · 头显当场做支持性检测(投屏) |
| 0:30—0:50 | 20′ | PART 2 最小可运行场景 | 三件套 + Three.js · 30 行代码 · 进入 VR 的四步 · 实操 A |
| 0:50—1:00 | 10′ | 课间 | 教师接设备、开投屏、一次性眼罩与擦镜布就位 —— 设备上机的唯一准备窗口 |
| 1:00—1:32 | 32′ | PART 3 程序化生成故宫 | 坐标系与比例 · 中轴布局 · 三种屋顶几何 · 实操 B |
| 1:32—1:50 | 18′ | PART 4 + 6 材质光照 / 交互与退出 | 程序化贴图 · 单平行光 · 昼夜 · 实操 C · 退出三条路 · 传看三条纪律 |
| 1:50—2:26 | 36′ | ★ 全员传看 | 40 人按座位顺序轮着看,不卡个人时间:戴上 → 只转头环视 → 说一句话 → 摘下 → 换眼罩 → 传下一位 |
| 2:26—2:36 | 10′ | ★ 4 人定岗深测 | 清晰度 / 延迟 / 舒适度 / 比例与退出,全班看投屏 |
| 2:36—2:51 | 15′ | PART 5 性能预算 | 帧预算 · 合批与取舍 · 读数入口 · 用真机数据回填 PC 读数 |
| 2:51—2:58 | 7′ | PART 7 部署与发布 | 安全上下文三条路 · 头显打开与退出流程 · 安装为应用(PWA) |
| 2:58—3:00 | 2′ | 收束 | 达标线 · 课堂作业 · 下次课预告 |
| 目标 | 内容 | 怎么检验 |
|---|---|---|
| T1 | 说出 WebXR 的三个前提:安全上下文、浏览器支持、设备会话 | 提问 + 测验 |
| T2 | 解释为什么 file:// 与局域网 http:// 测不出真实的 WebXR 支持情况 | 提问 |
| T3 | 比较引擎路线与网页路线的适用边界,各举一个该走哪条路的场景 | 讨论 |
| T4 | 写出一个最小 WebXR + Three.js 页面,并说明 XR 下为什么必须改用 setAnimationLoop | 实操 A + 巡视 |
| T5 | 说明程序化建模在本项目中的三条收益(体积、离线、可控) | 提问 |
| T6 | 指出本项目采用的三种屋顶形制,并说出自定义几何体需要提供哪三组数组 | 提问 |
| T7 | 读出自己机器上的 FPS / DrawCalls / 三角面,并判断瓶颈在哪里 | 记录表 |
| T8 | 说出"snap turn 与传送"为什么比"持续平移与连续旋转"更舒适 | 提问 |
| T9 | 完成六项课堂任务(跑通最小场景 / 比例校核 / 新增构件 / 光照实验 / 性能实验 / 真机观察与分发) | 两轮举手验收 |
| T10 | 说出 VR 里退出会话的三条路径,并解释为什么"在网页上放一个普通按钮"在沉浸模式下不管用 | 提问 + 演示 |
浏览器不再只是"看网页的软件",它可以是一台 VR 运行时
WebXR Device API 是由 W3C 制定的浏览器标准接口,让网页代码直接驱动头显、手柄与空间追踪能力。它取代了早期的 WebVR(只做 VR、接口零散),把 VR 与 AR 统一到同一套 API 之下。
这句话的真正含义是:做 VR 应用,不再是引擎的专利。一个 HTML 文件加上几百行 JavaScript,就能在头显里跑起来——这也是本讲要亲手验证的事。
| 概念 | 写法 / 取值 | 含义与用途 |
|---|---|---|
| 能力入口 | navigator.xr | 浏览器是否具备 XR 能力。它是 undefined,后面的一切都无从谈起 |
| 会话模式 | immersive-vr / immersive-ar / inline | 沉浸式 VR / 沉浸式 AR / 页面内嵌(不接管显示) |
| 参考空间 | local-floor / bounded-floor / local / viewer | 世界原点定在哪里。local-floor 以用户脚下的地面为原点,最符合"站着的人"的直觉 |
| 输入源 | inputSources | 手柄、手势、眼动等输入设备,以及它们的姿态与按键 |
| 帧循环 | renderer.setAnimationLoop() | 进入 XR 后渲染节奏由头显接管,必须改用它 |
| 安全上下文 | HTTPS 或 localhost | WebXR 的硬性前提,不满足时 navigator.xr 会被藏起来 |
| 会话生命周期 | requestSession() → session.end() | 进入与退出 VR;退出后要交还控制权给页面 |
https://… 或 http://localhost(含 127.0.0.1)。file:// 双击打开、或用局域网地址 http://192.168.x.x 访问时,浏览器会把 navigator.xr 直接藏起来 —— 这时你测出来"这个设备不支持 WebXR",是一个假结论。为什么浏览器要这么做?因为 VR 会读取头显与手柄的空间姿态,属于敏感能力,标准要求它必须运行在可验证来源的页面里。这条规则没有例外,也不看你的设备有多贵。它是本讲最容易误判、也最容易浪费半天时间的一个点。
第七节会给出三条绕行路线(HTTPS 托管、端口转发、浏览器白名单)。请记住排查顺序:先问"是不是安全上下文",再问"设备支不支持"。
| 平台 / 浏览器 | 沉浸式 VR | 说明 |
|---|---|---|
| 桌面 Chrome / Edge(Windows) | 支持 | PC 接头显(含一体机串流)可进入 VR;没有头显时,可用开发者工具或模拟扩展调试 XR 流程 |
| Meta Quest 系列浏览器 | 支持 | 移动端 WebXR 生态最成熟的一支 |
| PICO 浏览器(PICO 4 / Neo 3 等) | 以设备实测为准 | 与系统版本、浏览器版本强相关,同一型号不同固件可能结果不同——课前必须实测一次 |
| Android Chrome | 部分支持 | 移动 AR 能力较完整;VR 需要外接头显 |
| iOS Safari | 有限 / 逐步开放 | 以系统版本为准,不要想当然 |
navigator.xr 与 isSessionSupported('immersive-vr') 的实际返回值——这也是下周设备到位后要做的第一件事。file:// 打开页面,按钮显示"不支持 WebXR",能得出"这台设备不支持 WebXR"的结论吗?为什么?| 类型 | 资源 | 怎么用 |
|---|---|---|
| 📺 视频 | WebXR 在 3D 引擎中的实践(W3C 中国 · 29:03) | 标准制定方讲的 WebXR 定位与能力边界,对应 1.1—1.2 |
| 📺 视频 | 使用 WebXR 打造沉浸式网站体验(26:17) | 看"网页端 VR 能做成什么样",对应 1.5 的能力边界 |
| 📺 视频 | HTTPS 是什么?加密原理和证书(11:32) | 理解 1.3 的安全上下文:为什么浏览器要"藏起" navigator.xr |
| 🧪 演示 | 07 进入 VR 四步检查 | 当场看你这台设备的真实返回值 |
| 🔗 官方示例 | W3C WebXR Samples · Three.js WebXR 示例集 | 官方示例,可直接打开对照 |
30 行代码,把一个球体放进 VR —— 先跑通骨架,再谈故宫
| 层 | 技术 | 在本项目里负责什么 |
|---|---|---|
| 页面层 | HTML | 画布容器、HUD 面板、加载进度、"进入 VR"按钮 |
| 样式层 | CSS | HUD 排版、按钮状态、提示浮层 |
| 逻辑层 | JavaScript | 建场景、算几何、画贴图、处理输入、驱动 XR 会话 |
| 3D 库 | Three.js(r128,UMD 版) | 把 WebGL 的复杂细节封装成 Scene / Mesh / Material / Light |
浏览器本身已经提供了两套底层能力:WebGL(画三角形)与 WebXR(接管头显)。但直接用原生 WebGL 画一座故宫,意味着你要自己写着色器、自己算矩阵、自己管理缓冲区。Three.js 的作用就是把这些收起来,让我们把精力放在"宫殿应该长什么样",而不是"投影矩阵怎么乘"。
<!-- ✅ 本项目采用:UMD 单文件,双击 file:// 也能加载 --> <script src="./three.min.js"></script> // ❌ ES Module 版:在 file:// 下会被浏览器的同源策略拦下 import * as THREE from 'three';
本项目用的是 Three.js r128 的 UMD 构建(单文件 603 KB),用普通 <script src> 引入。两者的区别直接影响调试体验:UMD 能在 file:// 下加载,ES Module 不能——这是"双击就能预览"和"必须先开服务器"的分界线。
但要再说一次:file:// 只能预览画面,进不了 VR。进 VR 仍然需要安全上下文。
| 对象 | 作用 | 在本项目里对应什么 |
|---|---|---|
Scene | 场景根节点,所有物体的容器 | 整座紫禁城 |
PerspectiveCamera | 观察者(投影方式与视锥) | 你的眼睛;进入 VR 后姿态由头显驱动 |
WebGLRenderer | 每帧把场景画出来 | 输出到画布或头显的双眼视图 |
Mesh | 可渲染物体 = 几何体 + 材质 | 一根柱子、一片瓦顶、一块台基 |
Group | 物体的分组容器 | 一座单体建筑(太和殿、午门……) |
Light | 光照 | 1 盏平行光 + 1 盏半球光 |
Raycaster | 射线拾取,判断"指着谁" | 点击地面 / 扳机传送的落点判定 |
// 普通网页动画:浏览器按刷新率回调 requestAnimationFrame(tick); // 进入 VR 之后:渲染节奏交给头显,必须改用这一行 renderer.setAnimationLoop(tick);
requestAnimationFrame,典型症状是戴上头显就黑屏或卡住:头显的合成器要求每个 XR 帧都提交画面,而这个节奏由 setAnimationLoop 保证。Three.js 会自动为左右眼各渲染一次,并把结果交给头显合成器。<!DOCTYPE html>
<html><head><meta charset="utf-8"><style>body{margin:0;overflow:hidden}#vr{position:fixed;left:12px;bottom:12px}</style></head>
<body>
<button id="vr">进入 VR</button>
<script src="./three.min.js"></script>
<script>
// 1) 三个基本对象
var scene = new THREE.Scene();
scene.background = new THREE.Color(0x9ec9f0);
var camera = new THREE.PerspectiveCamera(70, innerWidth/innerHeight, 0.1, 2000);
camera.position.set(0, 1.6, 4); // 1.6 m ≈ 人眼高度
var renderer = new THREE.WebGLRenderer({antialias:true});
renderer.setSize(innerWidth, innerHeight);
renderer.setPixelRatio(Math.min(devicePixelRatio, 1.5));
document.body.appendChild(renderer.domElement);
// 2) 一盏灯 + 一个物体
scene.add(new THREE.HemisphereLight(0xbcd8f0, 0x6b5a44, 0.9));
var ball = new THREE.Mesh(
new THREE.SphereGeometry(0.6, 32, 24),
new THREE.MeshStandardMaterial({color:0xb22222})
);
ball.position.y = 1.2;
scene.add(ball);
// 3) 让渲染器接管帧循环(XR 必需)
renderer.xr.enabled = true;
renderer.setAnimationLoop(function(){
ball.rotation.y += 0.01;
renderer.render(scene, camera);
});
// 4) 进入 VR
var btn = document.getElementById('vr');
if(!navigator.xr){ btn.disabled = true; btn.textContent = '当前浏览器不支持 WebXR'; }
else navigator.xr.isSessionSupported('immersive-vr').then(function(ok){
if(!ok){ btn.disabled = true; btn.textContent = '本设备不支持沉浸式 VR'; return; }
btn.onclick = function(){
navigator.xr.requestSession('immersive-vr', {optionalFeatures:['local-floor']})
.then(function(s){ renderer.xr.setSession(s); })
.catch(function(e){ btn.textContent = '启动失败:' + e.message; });
};
});
</script>
</body></html>
把上面 30 行拆成 8 个细节,每个细节都给一个"关掉它会发生什么"的例子。配套演示:01 号演示 · 最小场景逐行讲解——点右侧任意一行代码,就能把那一行打开或关掉,亲眼看见它的作用。
| 细节 | 代码 | 关掉它会发生什么(这就是它的作用) |
|---|---|---|
| ① 场景底色 | scene.background = new THREE.Color(...) | 背景变黑,但物体还在——说明"黑屏"不等于"没渲染" |
| ② 相机 | new THREE.PerspectiveCamera(70, w/h, 0.1, 2000) | 整块画面消失。这是"看不见东西"的第一嫌疑 |
| ③ 相机位置 | camera.position.set(0, 1.6, 4) | 改成 (0, 0.2, 1) 就从地上贴着看——位置决定构图 |
| ④ 像素比 | setPixelRatio(min(dpr, 1.5)) | 去掉上限,高分屏更清晰但更吃性能——清晰度换帧率的开关 |
| ⑤ 光照 | HemisphereLight + DirectionalLight | 标准材质全黑。99% 的"我的模型是黑的"都是这条 |
| ⑥ 物体 | new THREE.Mesh(Geometry, Material) | 场景里少一个东西。几何体管形状,材质管外观 |
| ⑦ 位置与单位 | ball.position.y = 1.2 | 1 单位 = 1 米:1.2 m 约是胸口高度,1.6 m 约是人眼高度 |
| ⑧ 渲染循环 | renderer.setAnimationLoop(fn) | 画面冻住。XR 下用 requestAnimationFrame 会黑屏 |
新手最常见的报错是"我建了物体却什么都看不见"。按下面顺序查,基本一次命中:
// 排查三连(本项目在 ?debug=1 下也能这样查) console.log(camera.position); // ① 相机在哪:是不是在物体里面/后面 console.log(camera.rotation); // ② 相机朝哪:有没有 lookAt 目标 console.log(camera.near, camera.far); // ③ 近/远裁剪面:near 太大,近处物体直接被剪掉 // 最典型的错误:只写位置,不写朝向 camera.position.set(0, 1.6, 4); // 相机在 z=4 看着 −z 方向(three.js 默认朝 −z) camera.lookAt(0, 1.2, 0); // 想让相机看目标,必须显式 lookAt
动手看:02 号演示 · 坐标系与相机——四个滑块分别是相机 X/Y/Z 与视野 FOV,把高度调到 1.7 就是"站着看",调到 0.6 就是"蹲下看",FOV 拉到 100° 就能看到明显的边缘拉伸。
// 对比:同一种红色,两种材质
new THREE.MeshBasicMaterial({color:0xb22222}) // 不受光:永远是这个颜色,适合画 UI、标线
new THREE.MeshStandardMaterial({color:0xb22222}) // 受光:没灯就是全黑(VR 场景用这个)
scene.add(new THREE.HemisphereLight(0xbcd8f0, 0x6b5a44, 0.9)); // 天光补色,避免背光面死黑
var sun = new THREE.DirectionalLight(0xffffff, 1.2); // 主光(太阳),负责明暗与投影
sun.position.set(4, 6, 3); scene.add(sun);
动手看:03 号演示 · 光照与材质——四个球并排对比"基础材质 / 平行光 / 半球光 / 两盏灯+阴影",把两盏灯都拖到 0,就能复现"全黑"的现象。
这条看起来是常识,但它决定了整个工程能不能讲得通:紫禁城的每一个尺寸都是"米",所以"太和殿 35.4 m"这样的历史资料可以直接抄进代码,后面才能做比例校核。
// ❌ 帧率相关:60 fps 的机器比 30 fps 的机器快一倍 ball.rotation.y += 0.01; // ✅ 帧率无关:每秒转固定角度,跟机器性能无关 var dt = Math.min(clock.getDelta(), 0.1); // 每帧耗时(秒),并夹住上限防跳帧 ball.rotation.y += (90 * Math.PI/180) * dt; // 每秒转 90° // 进入 XR 后还必须换掉循环方式 renderer.setAnimationLoop(animate); // ✅ 头显刷新节奏接管 // requestAnimationFrame(animate); // ❌ 戴上头显就黑屏/卡住
动手看:04 号演示 · 帧循环与 deltaTime——把"模拟设备帧率"拖到 15 fps,左边的方块明显变慢、右边几乎不变。这就是"手感不对/晕"的技术原因。
navigator.xr 是否存在(不存在 = 浏览器或安全上下文不满足);navigator.xr.isSessionSupported('immersive-vr');navigator.xr.requestSession('immersive-vr', {optionalFeatures:[...]});renderer.xr.setSession(session)。optionalFeatures 与 requiredFeatures 的区别很关键:写进 requiredFeatures 的能力如果设备不支持,会话会直接失败;写进 optionalFeatures,设备有就用、没有就降级。本项目请求的是 local-floor(地面原点)、bounded-floor(安全边界)、hand-tracking(手势),全部写成可选——这样即使头显没有手势追踪,场景照样能进。动手看:07 号演示 · 进入 VR 的四步检查——页面上把每一步的实际返回值都打出来(协议、navigator.xr、isSessionSupported、按钮状态),这一步失败了该查什么,页面上直接写着。
hello-webxr.html,与 three.min.js 放在同一目录;file://)——画面应该能出来,但按钮会显示"不支持 WebXR"。先亲眼看到这个"假结论";SphereGeometry 的半径从 0.6 改成 1.5,把材质颜色改成自己喜欢的颜色,刷新;F12 打开控制台,确认没有红色报错。| 类型 | 资源 | 说明 |
|---|---|---|
| 🧪 演示 | 01 最小场景逐行讲解 | 点一行代码 = 开关一个细节(本站演示,离线可用) |
| 🧪 演示 | 02 坐标系与相机 | 滑块调相机位置与 FOV,体会"1 单位 = 1 米" |
| 🧪 演示 | 03 光照与材质 | 四个球对比四种光照方案,复现"模型全黑" |
| 🧪 演示 | 04 帧循环与 deltaTime | 模拟 15 fps 低性能设备,看两种写法差多少 |
| 🧪 演示 | 07 进入 VR 四步检查 | 把"进不去 VR"的排查顺序做成可交互页面 |
| 📺 视频 | 快速上手 Three.js —— 浏览器中的 3D 渲染引擎(11:30) | 与本模块 2.1—2.5 完全对应,最适合课前看 |
| 📺 视频 | 什么是渲染管线?如何绘制 3D 物体?(9:20) | 讲清"三角形是怎么变成屏幕像素的",回答"为什么这一切叫 WebGL" |
| 📺 视频 | three.js 添加坐标轴、光源和阴影效果(15:29) | 与 2.6 细节 A/B 对应:坐标轴、光源、阴影 |
| 🔗 文档 | Three.js 官方文档 · MDN:WebXR Device API(中文) | 查 API 用,比看视频快 |
没有一砖一瓦的模型文件,宫殿是"算"出来的
| 方案 | 体积 | 网络依赖 | 可控性 | 适合本讲吗 |
|---|---|---|---|---|
| 下载现成模型(素材库 / AI 生成) | 几十 MB ~ GB | 需要下载 | 受精度与授权限制 | 不适合:课堂网络不可控,版权也不清楚 |
| 建模软件自制(Blender) | 中等 | 需要分发 | 高 | 不适合本次课:40 人在一节课里做不完 |
| 程序化生成(本讲) | 约 660 KB | 零请求,断网可用 | 每个尺寸都是一个可调变量 | ✓ 采用 |
程序化建模还有一个隐藏收益:它是"可解释"的。模型文件里的一根柱子是几万个顶点坐标;而程序里的一根柱子是 addPillar(x, z, y0, h, r)——想让它高一点,改一个数就行,还能顺便讲清"高多少算合理"。
x = 0;本项目取 +z 为南、−z 为北(午门在南、三大殿在北);Group:Group 只负责"整体落位",内部构件一律用局部坐标,之后整体移动、旋转、复制都不会散架;{ wallX: 82, southZ: 170, northZ: −178 }。| 建筑 | 中心坐标(z) | 建模要点 | 尺寸校核 |
|---|---|---|---|
| 午门 | +150 | 凹字形城台(三座门洞)+ 重檐庑殿正楼 + 两翼廊屋 + 两座攒尖角亭 | 城台顶 11 m ✓ |
| 内金水河 · 五桥 | +112 | 河道 + 汉白玉栏杆 + 5 座石拱桥(中央主桥最宽) | 主桥宽 7.4 m |
| 太和门 | +78 | 单层台基 + 九间门殿 + 重檐歇山顶(含山花) | 屋脊 ≈ 20 m |
| 太和殿 | −55 | 三层须弥座(2.4 / 2.8 / 3.5 m)+ 三层望柱栏板 + 32 根红柱 + 青绿彩绘额枋 + 两圈斗拱 + 重檐庑殿 + 正脊鸱吻 + 月台鎏金铜缸 | 总高 35.4 m(实测 35.05 m)✓ |
| 中和殿 | −98 | 方形台基 + 单檐四角攒尖 + 鎏金宝顶 | 约 19 m |
| 保和殿 | −140 | 台基 + 重檐(下庑殿 / 上歇山带山花) | 约 29.5 m |
| 东西廊庑 | x = ±62 | 185 m 连檐走廊红墙 + 窗棂 + 单向坡灰瓦顶 + 檐下红灯笼 | 纵深贯通全院 |
| 体仁阁 / 弘义阁 | x = ±52 | 两重檐楼阁(灰瓦) | —— |
| 四周围墙 | x = ±88 / z = ±176 | 6.5 m 红墙 + 黄琉璃墙帽 | 6.5 m ✓ |
Three.js 提供了立方体、球、圆柱等基础几何体,但没有"庑殿顶"。中式屋顶必须自己写:给出顶点、法线、UV三组数组,组装成 BufferGeometry。
| 形制 | 用在哪 | 几何特征 | 代码入口 |
|---|---|---|---|
| 庑殿顶(四阿顶) | 午门正楼、太和殿 | 四坡:前后为梯形、左右为三角形,五条脊(正脊 + 四条垂脊) | hipGeo() / addHipRoof() |
| 歇山顶 | 太和门、保和殿上层 | 上半为两坡,下半四面坡,两端带山花 | gableGeo() / addGableRoof() |
| 四角攒尖顶 | 中和殿、午门角亭 | 四坡汇于一点,顶部加鎏金宝顶 | addPyramidRoof() |
// 庑殿顶的骨架:手写顶点 / 法线 / UV(节选,已简化)
function hipGeo(w, d, h, spine){
var hw = w/2, hd = d/2, s = Math.max(0.5, spine)/2;
var pos = [], uvs = [], nors = [];
var slopeF = Math.sqrt(h*h + hd*hd); // 前后坡的斜长 → 用于 UV 纵向比例
var slopeS = Math.sqrt(h*h + (hw-s)*(hw-s)); // 侧坡
function quad(a, b, c, dd, nrm, uvArr){ // 一个面:3 或 4 个顶点
var ids = [a, b, c]; if(dd) ids.push(a, c, dd); // 四边形 → 两个三角形
...
}
var A = [-s, h, 0], B = [s, h, 0]; // 正脊两端
var F1 = [ hw, 0, hd], F2 = [-hw, 0, hd]; // 南侧檐口
var Bk1 = [-hw, 0, -hd], Bk2 = [ hw, 0, -hd]; // 北侧檐口
var nf = [0, hd, h], nb = [0, hd, -h]; // 前后坡法线(手算)
var nl = [-h, hw-s, 0], nr = [ h, hw-s, 0]; // 左右坡法线
...
var g = new THREE.BufferGeometry();
g.setAttribute('position', new THREE.Float32BufferAttribute(pos, 3));
g.setAttribute('normal', new THREE.Float32BufferAttribute(nors, 3));
g.setAttribute('uv', new THREE.Float32BufferAttribute(uvs, 2));
return g;
}
注意 quad() 里的 ids.push(a, c, dd):四边形要拆成两个三角形。前后坡是梯形(不是三角形),必须给 6 个顶点、6 组 UV 才能铺满——这是本项目最早踩到的坑之一(详见 3.6)。
| 构件 | 做法 | 本项目数量级 |
|---|---|---|
| 台基与须弥座 | 逐层用 Box 叠上去,层高就是历史尺寸 | 太和殿三层:2.4 / 2.8 / 3.5 m |
| 望柱与栏板 | 沿台基边缘等距排布,间距约 1.9 m 生成一组 | 望柱 966 根、栏板 930 块 |
| 柱网与斗拱 | 立柱按开间分布;檐下沿长度生成"斗拱线" | 红柱 146 根、斗拱 356 组 |
| 匾额、灯笼、窗棂 | 贴图 + 简单几何体(Box / Sphere) | 灯笼 35 盏 × 两庑 |
这里有一处关键的工程判断:这些构件单看都很简单,数量却上千。如果一根柱子一个 Mesh,光是提交次数就会拖垮帧率。解决方式是实例化合批(InstancedMesh),详见 PART 5。
repeat.set(宽/6, 高/4) 这类写法)。否则同一张瓦片贴图,在小屋上被拉长、在大殿上被压扁,砖缝大小对不上。还有一个更"隐蔽"的坑写在 PART 6:把局部坐标当成世界坐标用。当物体带父容器(Group)时,它的坐标是局部的,合批前必须先换算到世界坐标,否则上千根柱子会整体错位。
| 类型 | 资源 | 怎么用 |
|---|---|---|
| 🧪 演示 | 05 程序化几何与贴图 | 拖滑块改面阔/进深/层高/正脊,屋顶实时重建,并显示顶点数与 DrawCall |
| 📺 视频 | 用 three.js 制作你的第一个 3D 地图(12:04) | 另一条"用代码生成几何"的思路,对照故宫的做法 |
| 📺 视频 | 低模 UV 该给多大才合适?UV 像素原理(19:05) | 解释 3.6 第三条坑:为什么 UV 要按实际尺寸设置 |
| 📺 视频 | Blender 几何节点程序化建模(10:15) | 对照组:不用代码、用节点也能程序化生成,理解两种路线的差别 |
一张贴图都不下载:所有纹理都是运行时画出来的
本项目的贴图不是图片文件,而是运行时用 Canvas 2D 画出来、再交给 GPU 的 CanvasTexture。四个好处:
代价也很直接:程序化贴图做不到照片级写实。它擅长表现"重复的、有规律的"表面——瓦、砖、墙、栏杆,正好是古建筑的主体。
| 贴图 | 画法要点 | 用在哪些构件 |
|---|---|---|
| 黄琉璃瓦 | 逐行错缝排布 + 顶部高光带 | 三大殿、午门正楼的屋顶 |
| 灰瓦 | 低饱和青灰 + 颗粒噪点 | 东西廊庑、两翼楼阁 |
| 朱红墙 | 底色 + 竖向色差(模拟雨水冲刷) | 宫墙、立柱、门扇 |
| 汉白玉 | 浅色底 + 云纹噪点 | 台基、栏杆、石桥 |
| 金砖地面 | 方格分块 + 亮度扰动 | 广场铺装 |
| 青绿彩绘 | 条带 + 云纹 | 额枋、梁枋 |
| 冰裂纹窗棂 | 网格线 | 门窗、廊庑墙面 |
| 匾额 | 文字 + 描边 + 底色 | 各殿门楣、广场导览牌 |
// 生纹理一次,改 repeat 复用;用 key 缓存,避免重复创建材质
var matCache = {};
function wallMat(w, h){
var key = 'w' + (w|0) + '_' + (h|0);
if(matCache[key]) return matCache[key];
var t = tex.wallR.clone(); // 克隆纹理,各自设置平铺次数
t.needsUpdate = true;
t.repeat.set(Math.max(1, w/6), Math.max(1, h/4));
return (matCache[key] = new THREE.MeshStandardMaterial({map:t, roughness:0.9}));
}
repeat 解决的就别新建材质。DirectionalLight):模拟日光,负责明暗与投影;HemisphereLight):模拟天光与环境补色,避免背光面死黑;阴影用一张 2048 的 PCFSoft 阴影贴图,正交阴影相机按中轴范围裁剪,并设置 bias / normalBias 抑制摩尔纹。
| 类型 | 资源 | 怎么用 |
|---|---|---|
| 🧪 演示 | 03 光照与材质 | 四个球对比四种方案;两盏灯拖到 0 复现"全黑" |
| 🧪 演示 | 05 程序化几何与贴图 | 切"程序化瓦片 ⇄ 纯色",看同一几何体的两种外观 |
| 📺 视频 | 使用 Canvas 完成基本绘图(12:26) | 程序化贴图的前置技能:Canvas 2D 画图(本项目的瓦/砖/墙都靠它) |
| 📺 视频 | PBR 材质贴图最全详解(35:49) | 选看:粗糙度/金属度/法线这些参数到底在干什么 |
这一节把第 3 课的硬件指标,变成浏览器里可以读到的数字
头显刷新率 72 Hz 意味着每帧只有约 13.9 ms(1000 ÷ 72)。这 13.9 ms 里要同时完成:CPU 逻辑与物理、Draw Call 提交、GPU 渲染、以及双眼画面的合成。移动头显用的是移动芯片级 GPU,没有独立显卡,也不能靠风扇长时间压散热。
| 项目 | 参考预算 | 为什么是这条线 |
|---|---|---|
| 单个物体面数 | ≤ 5 万三角面 | 单个物体过大,视锥剔除就失去意义 |
| 全场景面数 | ≤ 50 万三角面 | 移动 GPU 的顶点与光栅化压力上限 |
| 单张贴图 | ≤ 2K | 显存与带宽;本项目实际只用 ≤ 256×256 |
| 指标 | 项目记录 | 说明 |
|---|---|---|
| Draw Calls | 43 — 114 | 随视锥内物体数量变化;这是本项目最关键的读数 |
| 三角面 | 约 3.8 万 | 远低于 50 万预算,说明"减面"不是本项目的瓶颈 |
| 纹理 | 运行时生成,零下载 | 全部由 Canvas 绘制,单张 ≤ 256×256 |
| 光源 | 2 盏 | 1 平行光(投影)+ 1 半球光,无实时点光源 |
| 像素比 | min(devicePixelRatio, 1.5) | 限制填充率——高分屏上这是最直接的省算力开关 |
| 手段 | 具体做法 | 收益 |
|---|---|---|
| 实例化合批 InstancedMesh | 望柱 966、栏板 930、红柱 146、斗拱 356、灯笼 70 —— 每类只用一个 draw call | 把上千次提交压成几次,本项收益最大的一条 |
| 低面数几何 | 立柱用 10 边圆柱(openEnded)、斗拱用 24 顶点盒体、自定义屋顶 12—18 顶点 | 三角面数量级下降 |
| 阴影只给该给的物体 | 望柱、栏板、斗拱关闭 castShadow | 直接缩小阴影 pass 的绘制量 |
| 限制像素比 | setPixelRatio(min(dpr, 1.5)) | 减少填充像素,对移动 GPU 效果明显 |
| 雾 + 天空球 | 220—780 m 淡出 | 允许更近的渲染距离,远景不必精细 |
| 昼夜不重建 | 只写 uniform 与自发光强度 | 避免运行时的卡顿尖峰 |
renderer.info.render.calls、renderer.info.render.triangles、renderer.info.memory.textures;// 把性能读数显示在页面上(本项目 HUD 的做法)
var info = renderer.info.render;
el.innerHTML = 'FPS <b>' + fps + '</b> | DrawCalls <b>' + info.calls +
'</b> | 三角面 <b>' + (info.triangles/1000).toFixed(0) + 'k</b>' +
' | 纹理 <b>' + renderer.info.memory.textures + '</b>';
castShadow 全部打开,最可能先出问题的是哪一项读数?| 类型 | 资源 | 怎么用 |
|---|---|---|
| 🧪 演示 | 06 性能对比:独立 Mesh 与 InstancedMesh | 本讲最值得动手的一个演示:把数量拖到 3000,对比 DrawCall |
| 📺 视频 | 合批渲染 & SpriteBatch 原理(26:31) | 解释"为什么合批能省时间"的底层机制 |
| 📺 视频 | GPU Instancing:降低 DrawCall(12:02) | Unity 视角讲同一个概念,概念是通用的 |
同一份代码,既要能在机房里用鼠标键盘跑,也要能在头显里用手柄跑
| 场景 | 输入 | 行为 |
|---|---|---|
| PC 预览 (备课 / 投屏 / 无头显时) | 鼠标拖拽 | 环视(俯仰限幅 ±77°,避免翻转) |
| W / A / S / D 或方向键 | 沿视线方向行走,Shift 加速(6 → 14 m/s) | |
| 单击地面 | 射线命中可落脚面 → 显示落点环 → 松开执行传送 | |
| HUD 面板 | 时辰滑块(5:00—21:00)、暂停昼夜、4 个预设机位 | |
| VR (头显 + 手柄) | 头部 | 自然环视(由头显姿态直接驱动) |
| 扳机 | 按住 → 手柄发出橙色射线、地面显示绿色落点环;松开 → 传送到该点 | |
| 左摇杆 | 按头朝向平滑行走(约 4.2 m/s) | |
| 右摇杆左右 | Snap turn,每次 30°,350 ms 冷却 | |
| 控制面板 | 低头看身前下方的控制面板 → 扳机点「退出 VR」→ 退出会话(见 6.5) | |
| 长按握把 2 秒 | 任意一只手柄按住握把 → 兜底退出,不用瞄准、不用找菜单 |
传送不是"想传哪传哪"。本项目把所有允许落脚的表面登记进一个集合,射线只对这个集合求交:
玩家的活动范围再整体夹紧在围墙之内(wallX / southZ / northZ 三个上限),避免"一脚踏空到场景外",也避免穿墙。
VR 里"人没动、画面在动"最容易引发不适:前庭系统感觉没动,视觉系统却报告在加速。瞬移把连续的加减速打断,是当前最稳的移动方案。本项目 VR 里保留的平滑行走也刻意压到 4.2 m/s,并只在"沿头朝向"这一个方向上生效。
连续旋转同样容易晕。Snap turn 把转动切成 30° 一档,一档一档转;350 ms 冷却是为了防止摇杆轻微漂移被识别成连续输入,导致画面一直转个不停——这类"小概率但高频"的手感问题,靠参数调,不靠运气。
// ❌ 错误:进入 XR 后,相机姿态由头显每帧写入,你写它 = 两边互相覆盖 camera.rotation.y += 30 * Math.PI / 180; // ✅ 正确:旋转"玩家"这一层父节点,相机保持由头显驱动 player.rotation.y += 30 * Math.PI / 180;
Group(rig),所有转身、位移都作用在 rig 上;相机作为它的子节点,只负责"被头显驱动"。这是本讲最容易被忽略、但在课堂上最容易出事的一环:学生进去以后出不来。网页端 VR 的退出入口由浏览器提供,页面无权代替;但页面必须给出用户自己找得到的出口。
| 方式 | 操作 | 定位 |
|---|---|---|
| 控制面板按钮 | 低头看身前下方的控制面板 → 扳机射线指向「退出 VR」→ 按下扳机 | 主路径:看得见、摸得着 |
| 长按握把 2 秒 | 任意一只手柄按住握把(squeeze)2 秒 | 兜底路径:不用瞄准、不用找菜单 |
| 系统键 | 按头显系统键 → 选「退出 VR」 | 官方出口:规范强制浏览器提供,永远可用;位置随固件版本变化 |
进入 VR 后的前 9 秒,控制面板会先被举到眼前——不是为了好看,而是让第一次戴上头显的人在教师还没来得及讲之前就知道怎么退出去。9 秒后它平滑落到视线下方(前方 0.95 m、高 0.66 m、倾斜 52°),低头可见、不挡景观。
面板 = 挂在玩家 rig 上的普通物体,「退出 VR」按钮是它的一个子网格 · 每帧用射线判定是否命中按钮;命中时只点亮按钮,不摆传送标记 · 松开扳机:命中按钮 → exitVR() → session.end();否则 → 传送 · 另有兜底:updateVRInput() 中检测握把(buttons[1])长按 2 秒 · 退出失败时提示"请按系统键退出",避免把人困在里面
immersive-ar)。想给用户一个看得见的按钮,就必须把它做成场景里的 3D 物体。这一条要在下周设备实测时一并确认。| 类型 | 资源 | 怎么用 |
|---|---|---|
| 📺 视频 | 《半条命:Alyx》移动方式官方深入解读(中字)(10:33) | 顶级 VR 大作为什么同时保留"传送"和"平滑移动"——正对应 6.3 的舒适度设计 |
| 📺 视频 | XR 眼镜戴久了头晕?晕动症的成因与缓解(13:54) | 选看:把"为什么会晕"讲到生理层面,解释为什么传送与 snap turn 更稳 |
工程做完只是"能跑",能发出去才叫"能用"
| 方式 | 做法 | 适用 | 限制 |
|---|---|---|---|
| ① HTTPS 托管 (推荐) | 把 .html 与 three.min.js 放进任意 HTTPS 空间(本课程网站就是一份),得到一个短链接 | 课堂演示、课后分享、给同学和家人看 | 需要一个能放静态文件的空间 |
| ② 本地服务 + 端口转发 | 在电脑上跑 python -m http.server 8080,头显通过 USB 端口转发访问 http://127.0.0.1:8080 | 开发调试(改一次看一次) | 需要数据线、驱动与端口转发配置 |
| ③ 局域网 HTTP + 白名单 | 浏览器打开 chrome://flags/#unsafely-treat-insecure-origin-as-secure,填入 http://192.168.x.x:端口,设为 Enabled 后重启浏览器 | 应急(没有公网空间时) | 该开关随浏览器与固件版本变化,不一定存在;只适合临时使用 |
file:// 打开,永远进不了 VR——它能看画面,但那只是"预览",不是"运行"。判断方式很简单:如果按钮显示"当前浏览器不支持 WebXR",先查安全上下文,再查设备。| 打开方式 | 是安全上下文吗 | 能进 VR 吗 | 课堂能不能用 |
|---|---|---|---|
file:// 双击本地文件 | 否 | 不能(只能看画面,navigator.xr 被隐藏) | 只能用来检查"画面渲染对不对" |
http://192.168.x.x(局域网) | 否 | 默认不能(除非给浏览器加白名单 flag) | 应急,依赖固件版本,不推荐 |
http://127.0.0.1(本机服务 / USB 转发) | 是 | 能 | 开发调试用;头显要通过 USB 端口转发 |
https://…(放到网站上) | 是 | 能 | 课堂首选:一个链接,全班都能开 |
把这件事讲透,只需要一句话:VR 会读取你头部的空间姿态,属于敏感能力,所以浏览器规定它只能运行在"可验证来源"的页面上。这条规则不看设备贵不贵,也不看你是不是在做教学演示——file:// 就是不行。
# 本机临时起一个"算安全"的服务(开发/调试用) python -m http.server 8080 # 电脑访问 http://127.0.0.1:8080/你的页面.html → 可以进 VR # 头显访问:USB 连接后做端口转发,或把它放到 https 上 & 'D:\VRLab\Android\platform-tools\adb.exe' reverse tcp:8080 tcp:8080 # 头显侧的 8080 指向电脑 # 课堂最省事的做法:直接用它已经发布好的 https 地址 https://www.qixiangsun.com.cn/assets/vr-2026/webxr/gugong_webxr.html
.html 与 three.min.js(改名、移动都会导致加载失败);退出后页面自动回到 PC 漫游状态,并在下方弹出「已退出 VR」提示,可直接再次进入。
manifest.webmanifest(应用名 / 图标 / 全屏启动)、sw.js(Service Worker:首次访问后离线可用)、一套图标。前提仍然是安全上下文——file:// 下 Service Worker 不会注册,"安装"与"离线"都不会生效。| 现象 | 最可能的原因 | 处理 |
|---|---|---|
| 按钮显示"当前浏览器不支持 WebXR" | 不在安全上下文,或浏览器没有 WebXR | 换 HTTPS / localhost;确认浏览器版本 |
isSessionSupported 返回 false | 当前设备不支持沉浸式 VR 会话 | 换浏览器或换设备;先在 PC 端把内容做完 |
| 会话启动失败,出现错误信息 | 把设备不支持的能力写进了 requiredFeatures | 改成 optionalFeatures |
| 进入 VR 后画面抖动 / 漂移 | 代码在每帧改写相机姿态 | 改为旋转玩家 rig(见 6.4) |
| 进入 VR 后找不到怎么退出 | 控制面板在视线下方,没低头看;或系统键菜单不熟 | 长按手柄握把 2 秒即可退出(见 6.5) |
| 点「安装为应用」没弹出安装框 | 该浏览器不支持自动安装,或已处于全屏应用模式 | 按页面提示,在浏览器菜单里手动「添加到主屏幕 / 桌面」 |
| 页面空白 | three.min.js 路径错误或不在同目录;脚本报错 | 开控制台看 404 与报错信息 |
| 画面很糊、明显掉帧 | 像素比过高 / 阴影范围过大 / Draw Call 过多 | 限制 setPixelRatio、收小阴影相机、做合批 |
| 画面看得见,但物体位置错乱 | 把局部坐标当世界坐标使用(父容器没换算) | 合批或复制前先换算到世界坐标 |
# 方式一:Python 自带(机房电脑一般都有) python -m http.server 8080 然后浏览器打开 http://127.0.0.1:8080/主程序.html # 方式二:Node 环境 npx serve -l 8080
| 类型 | 资源 | 怎么用 |
|---|---|---|
| 🧪 演示 | 07 进入 VR 四步检查 | 把本机是 file:// / 局域网 http / https 三种情况都跑一遍,对着表格填 |
| 📺 视频 | 增进 Web App 体验:充分利用 PWA 及其能力(Google 中国 · 12:10) | 官方讲 PWA:为什么"网页能变成应用"、能得到什么 |
| 📺 视频 | 你管这破玩意叫 HTTPS?(7:57) | 轻松看懂 HTTPS 与证书,理解"必须放到网络上"的由来 |
| 🔗 工具 | model-viewer 在线编辑器 | 把任意 .glb 拖进去就能看、能导出一段网页代码——做作品集封面很好用 |
教室里只有 1 台 PICO Neo 3。把时间全给它,每人也就 4.5 分钟——连戴卸和消毒都不够。所以这个环节分两段:先让全班每个人亲手戴上一次(覆盖面),再由 4 个人把数据测准(质量)。
| 阶段 | 时间 | 谁上机 | 目标 |
|---|---|---|---|
| 全员传看 | 1:50—2:26(36′) | 全班 40 人,按座位顺序轮着看(不卡个人时间) | 每个人都亲手看见一次;每人留一句话 |
| 定岗深测 | 2:26—2:36(10′) | 4 人,每人 2 分钟 | 测数据、走完整交互与退出 |
每人只说一句话(三选一):"清楚 / 有点糊,远处屋脊我看到的是一句话描述" | "转头跟得上 / 有拖影" | "有点晕 / 不晕"。40 个人 × 一句话,就是 40 个数据点——教师现场把它们变成板书统计。
| 角色 | 职责 |
|---|---|
| 学生管理员 ① | 擦拭镜片、换一次性眼罩、在相邻两人之间递送设备(不走动过道) |
| 学生管理员 ② | 维持传递秩序、提醒下一位准备(不记时、不打勾——按座位顺序传,看座位就知道传到哪) |
| 教师 | 站在传递区旁边讲评:每人对下一句话,立刻接成知识点(清晰度 → PPD;拖影 → 帧率与延迟;晕 → 舒适度设计) |
| 其余同学 | 继续做课堂作业 T1 / T2,并填观察卡——不是干等 |
| 项目 | 处理 |
|---|---|
| 卫生 | 一次性眼罩一人一片(3 秒换好);每 10 人擦一次镜片;由学生管理员执行,不占教师时间 |
| 戴眼镜 | 允许戴着试,但提醒"先摘眼镜戴头显、确认不顶镜片";顶着不舒服就直接摘镜体验(画面会糊,如实记录) |
| 发热与电量 | 连续 40 分钟会热、会掉电:能边充边用就接充电宝;明显烫手就暂停 1 分钟 |
人选规则当场公布(作业先完成者 4 位),每人 2 分钟,全班看投屏。每人只测一件事:
| 岗 | 只测这一件事 | 记录 |
|---|---|---|
| ① 清晰度 | 远处屋脊、斗拱是否看得清(和 PC 上比) | 1—5 分 + 一句话 |
| ② 延迟 | 快速左右转头,画面跟不跟得上 | 有 / 无拖影 |
| ③ 舒适度 | 扳机传送一次 + 摇杆走两步 | 眩晕 0—3 级 |
| ④ 比例与退出 | 台基相对自己身高有多高;再按三条退出路径各走一遍 | 退出用时(秒)+ 用了哪条路 |
| # | 检查项 | 结果 |
|---|---|---|
| 1 | 是否安全上下文(协议是 https: 吗) | |
| 2 | navigator.xr 是否存在 | |
| 3 | isSessionSupported('immersive-vr') 的返回值 | |
| 4 | "进入 VR"按钮能不能点 | |
| 5 | 退出用了哪条路、几秒 |
?debug=1 会挂出一个调试钩子 window.__gugong(不写这个参数时完全不影响正式使用)。在头显浏览器控制台里用 __gugong.isPresenting() 可以确认是否真的进入了会话;想在 PC 端先看控制面板长什么样,用 __gugong.showPanel() 把它调出来。六项课堂任务(逐项有操作步骤与验收点,不卡时间、做完为止)+ 三张规定截图 + 两轮举手验收 + 一张记录表
demo01-minimal-scene.html)——中文文件名在部分机房电脑上会乱码或打不开,所以中文标题写在页面里,文件名一律用英文。W A S D 行走,按住 Shift 加速;F12 打开控制台看一眼:有红色报错吗?(这是我们查问题的第一动作)做什么:把 2.5 节的 30 行代码存成 hello-webxr.html,与 three.min.js 放在同一目录,然后改一处参数。
学号-姓名,把两个文件放进去(必须同目录);hello-webxr.html,记下按钮显示的是"进入 VR"还是"当前浏览器不支持 WebXR";0.6 改成 1.5,颜色改成你喜欢的色值,保存后刷新;F12 确认控制台没有红色报错。file:// 不是安全上下文。做什么:打开故宫场景源码,找一处尺寸,查证它的真实数值,把代码改成真实值,并写下依据。
做什么:在场景里加入一组原来没有的东西,并用一句话说清它怎么做的。
BoxGeometry / CylinderGeometry 把它加进去(位置要和周围对齐);scene.add);加了但没有父容器,位置对不上。做什么:把"时辰"滑块从 5:00 拉到 21:00,记录三个时刻的画面差异。
做什么:用 06 号演示做一次对照实验,抄下 4 个数字。
| 编号 | 截什么 | 必须能看清 | 对应任务 |
|---|---|---|---|
| 截图 1 | 你的最小场景全屏 | 你改过的球体 + 页面没有任何报错 | 任务 1 |
| 截图 2 | 故宫场景"改动前 / 改动后"对比(同一机位) | 改动的那一处看得出来 | 任务 2 / 3 |
| 截图 3 | 合批实验:两种模式各一张 | 右边面板上的 DrawCall 数字(这是关键证据) | 任务 4 |
学号-姓名-01.png / -02.png / -03.png(两张对比图可以合成一张,命名 -02.png);| 轮次 | 什么时候收 | 验什么 | 怎么验 |
|---|---|---|---|
| 第 1 轮 | 任务 1—2 大体做完时(一般在 PART 3 讲完前后) | 任务 1 + 任务 2 | 完成的举手 → 同桌互检(按下面 3 条互查)→ 在记录表签字 |
| 第 2 轮 | 任务 3—5 大体做完时(一般在性能那一节结束前后) | 任务 3 + 4 + 5 | 完成的举手 → 教师抽验 8 台(每台约 20 秒)→ 未过的登记课后补 |
同桌互检三条(互相查,查完签字):① 你的页面能打开且没有红字报错吗?② 改动看得见吗?③ 记录表里的数字和 HUD 上的一致吗?
教师抽验看什么(20 秒一台):① 页面能跑;② 改动痕迹可见(不是原版);③ 记录表的数据与 HUD 对得上。抽验不是抽查作业量,而是抽查"数据是不是编的"。
完成全部任务的同学可自愿申请现场演示(约 3—5 人),照着这三句话讲:
| 记录项 | 我的记录 | 说明 |
|---|---|---|
| 浏览器与版本 | 说明"在什么环境里测的" | |
| 是否安全上下文 | 是 HTTPS / localhost,还是 file:// 或局域网 http | |
| FPS / DrawCalls / 三角面 | 抄 HUD 面板的实时读数 | |
| 5:00 的画面特征 | 色温、影子长度与方向 | |
| 15:00 的画面特征 | 同上 | |
| 21:00 的画面特征 | 同上,并注明灯火变化 | |
| 我改的一处参数 | 改前值 → 改后值 → 可见的变化 | |
| 我戴上时的一句话 | 清楚 / 有点糊、有无拖影、晕不晕,任选一项如实记录 | |
| 真机对比(看投屏填) | 清晰度 / 转头延迟 / 移动舒适度 / 人体比例,各写一句"和 PC 上有什么不同" | |
| 合批实验 · 独立 Mesh(3000 个) | DrawCall = ____ 三角面 = ____ | |
| 合批实验 · InstancedMesh(3000 个) | DrawCall = ____ 三角面 = ____;为什么三角面反而更多? | |
| 改动依据(来源) | 写明来自故宫官方资料 / 教材 / 可靠科普站(不准写"我觉得") | |
| 安装为应用的结果 | 装成功 / 不支持手动添加 / 没找到入口(如实写) | |
| 同桌互检签字 | 同桌姓名:__________(互检三条例全过才签) |
file:// 测不出真实结论;下面这个例子是把前面几个演示拼起来的一个完整小应用:一个菜单 + 两个能进头显的体验(挥杆打高尔夫、射线打靶),带得分、退出按钮和性能读数面板。建议先点开玩两分钟,再回来看它的代码——你会发现它用到的每一块,你都已经在本课里见过。
| 它在演示什么 | 对应本课哪一节 | 你可以照着改什么 |
|---|---|---|
一个场景 + 两个体验分组(Group 切换显隐) | PART 2 最小可运行场景 | 再加第三个体验,比如"投篮" |
| 全部几何体由代码生成:球、旗杆、树、靶子、房间 | PART 3 程序化生成 | 把树换成别的形状,或改球的半径 |
一盏半球光 + 一盏平行光;用 emissive 做发光靶子 | PART 4 光照与材质 | 改平行光方向,看影子与明暗变化 |
左下角实时显示 FPS / DrawCall / 三角面 / 纹理 | PART 5 性能预算 | 把靶子数量从 5 改成 50,看读数怎么变 |
| 桌面用鼠标、VR 用手柄射线;两条退出通道 | PART 6 交互与退出 | 改击球蓄力速度、或改退出按钮的位置 |
| Three.js 放在本地,不依赖任何 CDN | PART 7 部署与发布 | 把它放进自己的网站目录一起上传 |
cdn.jsdelivr.net),机房网络一慢就会永远卡在"正在加载 Three.js…";现在已经改成本地库 + 本地控制器库,断网也能打开,并补了 WebGL 兜底提示、VR 内退出按钮、长按握把退出、性能读数与快捷键。一个故宫不够看。下面这些全部是免费的,链接都已逐个核验可打开(2026-09-22)。建议每个至少点开一次,看别人怎么做,比只看故宫一个例子更快建立判断力。
| 库 / 引擎 | 特点 | 适合拿来做什么 |
|---|---|---|
| Three.js | 最主流的 WebGL 库,示例几百个,中文资料最多 | 本课程选用;写代码控制一切 |
| A-Frame | 用 HTML 标签写 VR(<a-box>),不用写渲染代码 | 半天做出一个能进头显的场景;适合第一次接触 VR 的人 |
| Babylon.js | 功能比 three.js 更"开箱即用",自带在线 Playground(改完即看) | 想快速试一个玩法;企业级项目 |
| PlayCanvas | 完整的网页版编辑器,像"网页里的 Unity" | 不想写太多代码、想用编辑器搭场景 |
| <model-viewer> | 一行 HTML 标签就能展示 3D 模型,Google 出品 | 给网页/电商/课程加一个可旋转的 3D 模型 |
| TresJS | Vue 风格的 Three.js 封装 | 前端同学做课程网站里的 3D 展台 |
| Needle Engine | 把 Unity 工程直接导出成网页 | 已有 Unity 项目,想一键上网页 |
| Zdog | 极简伪 3D(没有真正的透视),画风可爱 | 做图标、插画式 3D,几乎不占性能 |
| 示例站 | 里面有什么 |
|---|---|
| W3C WebXR Samples | 标准组织给的官方示例,最权威;可用来对照"你的设备到底支持哪一项能力" |
| Three.js WebXR 示例集 | 官方示例里所有 WebXR 相关的(手柄、传送、绘画、体积雾…),点开即运行 |
| A-Frame 示例 | 几十个"打开就进 VR"的小场景,代码量极小,适合当模板 |
| Babylon Playground | 在线改代码即时预览,示例按功能分类 |
| Khronos glTF 官方样例模型 | 标准的 3D 格式测试模型(含材质、骨骼动画),用来测试"我的加载器对不对" |
| 站点 | 内容 | 授权 |
|---|---|---|
| Poly Haven | HDRI 环境图、PBR 材质、模型 | CC0(可商用、免署名) |
| ambientCG | 上千套 PBR 材质与贴图 | CC0 |
| Kenney | 低模游戏素材包(角色、道具、场景) | CC0 |
| Quaternius | 低模建筑、角色、自然素材 | CC0 |
| Sketchfab | 海量模型,可按"可下载 + CC 授权"筛选 | 逐件看授权(CC BY 需署名) |
| Mixamo | 角色骨骼动画(走路、挥手等) | 免费(需注册);用于教学演示 |
全部课内完成,不卡时间、做完为止;逐项的操作步骤、验收点与常见错误见上面《课堂实操与成果验收》
| 作业名称 | 网页端沉浸场景改造:从看懂到改懂 |
|---|---|
| 完成形式 | 个人独立完成 · 课内完成 · 随课验收 |
| 时间安排 | 随 PART 3—6 边讲边做,合计约 20 分钟 |
| 提交内容 | 改造后的源码或截图 + 课堂记录表 + 一段 100 字以内的说明 |
| 与期末关系 | 计入本学期课堂案例合集;网页端形式可作为期末大作业的呈现方式之一 |
| 编号 | 任务 | 要求 | 难度 |
|---|---|---|---|
| 任务 1 必做 | 跑通最小场景 | 把 30 行最小场景跑起来、改一处参数、控制台无报错,并说清"为什么按钮显示不支持" | ★ |
| 任务 2 必做 | 比例校核 | 选一处构件(台基、屋顶、柱子、围墙皆可),查证一个真实尺寸,把代码中的数值改为该尺寸,并写明依据来源与改动前后的差异 | ★★ |
| 任务 3 必做 | 新增一组构件 | 在中轴、月台或廊庑处新增一组构件(灯笼 / 望柱 / 栏板 / 甬道 / 照壁 / 导览牌),说明用了什么几何体、什么材质、如何定位 | ★★ |
| 任务 4 必做 | 光照实验 | 记录 5:00 / 15:00 / 21:00 三个时刻的色温、影子与灯火,并区分"光照参数"与"材质参数" | ★ |
| 任务 5 必做 | 性能实验与判断 | 用 06 号演示做一次"独立 Mesh ⇄ InstancedMesh"对照实验,记录两组 DrawCall 与三角面,并解释为什么合批后三角面反而变多 | ★★★ |
| 任务 6 必做 | 真机观察与分发 | 填写观察卡(戴过或看过都写),把场景链接发给自己并确认能打开,尝试"安装为应用"并如实记录结果 | ★ |
| 加分 | 30 秒现场演示 | 按"我改了什么 / 前后有什么不同 / 我的性能读数"三句话讲清自己的改动 | ★★★ |
| 任务 | 1 | 2 | 3 | 4 | 5 | 6 | 加分 |
|---|---|---|---|---|---|---|---|
| 建议顺序 | ① | ② | ③ | ④ | ⑤ | ⑥ | ⑦ |
| 提交物 | 截图 01 | 截图 02 + 记录表 | 截图 02 + 记录表 | 记录表 | 截图 03 + 记录表 | 观察卡 + 链接 | 现场演示 |
| 验收轮次 | 第 1 轮(做完 ①② 后举手 + 同桌互检) | 第 2 轮(做完 ③④⑤ 后举手 + 教师抽验 8 台) | 看观察卡 | 自愿申请 | |||
| 维度 | 权重 | 看什么 |
|---|---|---|
| 完成度 | 40% | 场景能跑起来,改造效果肉眼可见,没有引入报错 |
| 规范 | 20% | 尺寸写成变量而不是散落的数字;命名清晰;有注释说明"改了什么" |
| 理解 | 20% | 能说清几何、材质、性能三件事的因果关系(例如"为什么这个改动会增加 Draw Call") |
| 记录 | 20% | 记录表完整、数据真实、别人能照着复现 |
3.5,没人知道哪个是台基高度;把这一页抄在笔记本上,本讲的骨架就齐了
| 主题 | 要记住的 |
|---|---|
| WebXR 三前提 | 安全上下文(HTTPS / localhost)· 浏览器支持 · 设备会话支持 |
| 最小技术栈 | HTML + JavaScript + Three.js + renderer.xr |
| 两条渲染循环 | 普通页面用 requestAnimationFrame;XR 用 setAnimationLoop |
| 程序化建模三步 | 定坐标系与单位 → 定比例(可校核)→ 写几何(顶点 / 法线 / UV) |
| 性能优先级 | Draw Call > 填充率 > 三角面 |
| 最容易犯的两个错 | 在非安全上下文里判断"不支持 WebXR";在 VR 里每帧写相机姿态 |
| 退出与分发 | 退出的三条路:控制面板按钮 / 长按握把 2 秒 / 系统键;分发:装成应用(PWA)= 一个图标 + 全屏 + 离线 |
file:// 的假结论;引擎路线:《虚拟现实开发常用软件》与 Unity 课堂案例 01 的完整课堂内容
上一次课走的是引擎路线(Unity):软件生态与工具选型、资产导入的五道关、编辑环境核对、XR 环境配置、模型与第一个 C# 脚本、模拟器 → 头显双轨验证。这一节把完整内容整段存档,复习时可以对照着看。本讲(09-23)走的是网页端路线,两条路线共用同一章的知识框架。
上次课回答“硬件能做什么”,这次课回答“用什么软件把它做出来”
这节课以第 4 章“虚拟现实开发常用软件”为骨架,把上一课(第 3 次课)讲过的硬件关键指标作为“软件设置的依据”贯穿全课。课堂产出不是“听懂”,而是一台机器上一个能跑起来的 VR 场景。
① 核对版本与插件 → ② 配置 XR → ③ 导入模型 + 写脚本 → ④ 用 PICO 看一眼
12 分钟 30 分钟 25 分钟 25 分钟
| 目标 | 内容 | 怎么检验 |
|---|---|---|
| T1 | 说出 VR/AR 开发的四类工具(建模 / 引擎 / 资产 / 验证)各管什么,每类举 2 例 | 提问 + 生态地图 |
| T2 | 解释本课程为何选 Unity 而非 Unreal;Blender 与 3ds Max 的定位差异 | 投票 + 讨论 |
| T3 | 说明模型从建模软件到 VR 场景的五道关,指出三个常见错误 | 管线页 + 测验 |
| T4 | 查到自己机位上的 Unity 版本号并记录 | 任务卡填写 |
| T5 | 配置 XR 环境:XR Plugin + Interaction Toolkit + XR Origin + Device Simulator | 逐台巡视 |
| T6 | 导入一个模型并修正比例 | 场景截图 |
| T7 | 写出并运行第一个 C# 脚本,让物体动起来 | 课堂验收 |
| T8 | 说出上节课的硬件指标(PPD / 刷新率 / 定位方式)在 Unity 里对应哪个设置 | 测验 |
| T9 | 完成课堂案例 01 的验收 | 验收清单 |
| 时段 | 时长 | 环节 | 主要动作 |
|---|---|---|---|
| 0:00–0:08 | 8' | 开场 | 本学期模型与今日产出:讲清“期末 = 8 个课堂案例的合集”,今天的产出是第 1 个课堂案例 |
| 0:08–0:20 | 12' | 4.1 软件生态地图 | 四类工具分工;资产模型的“轻重”直接决定设备能否跑满 90Hz |
| 0:20–0:31 | 11' | 4.2 建模与引擎选型 | Blender vs 3ds Max、Unity vs Unreal;引擎选择与“生成设备”的关系 |
| 0:31–0:42 | 11' | 4.3 资产从哪来 | 三条来路 + 导入五道关;面数过高 → 掉帧 → 眩晕 |
| 0:42–0:53 | 11' | 4.4 编程入门与机房环境 | C# 最小认知(GameObject / Component / Start-Update);本机已装好什么、版本怎么查 |
| 0:53–1:03 | 10' | 课间 | 教师巡查机房:插件是否齐全、能否新建项目 |
| 1:03–1:15 | 12' | 实验 A · 核对版本 + 认界面 | Help → About Unity 查版本号;Package Manager 查插件;认六个面板 |
| 1:15–1:45 | 30' | 实验 B · XR 环境配置 ★ | XR Plugin Management → Interaction Toolkit → XR Origin → Device Simulator |
| 1:45–2:10 | 25' | 实验 C · 模型 + 第一个脚本 ★ | 导入 FBX、修比例、写最小脚本让物体转起来 |
| 2:10–2:35 | 25' | 双轨验证 ★ | 8 组轮换戴 PICO 看“自己做的场景”,对比模拟器与真机差异 |
| 2:35–2:50 | 15' | 收束 | 课堂案例 01 逐项验收、记录本机版本、预告下次课 |
4.1 四类工具各管一段 · 4.2 建模与引擎怎么选
| 类别 | 它负责什么 | 典型工具 | 本课程会用到 |
|---|---|---|---|
| 建模 | 造出物体的形状 | Blender、3ds Max、Maya | Blender(看一眼界面 + 导出一个 FBX) |
| 引擎 | 把内容组织成可运行的应用 | Unity、Unreal Engine | Unity 6(全程) |
| 资产 | 提供现成的模型、贴图、动画、音效 | Sketchfab、Poly Haven、Mixamo、AI 生成工具 | 素材库 + AI 生成 |
| 验证 | 检查“在真机上到底行不行” | XR Device Simulator(PC 模拟)、头显真机 | 模拟器为主 + 头显验证 |
免费、跨平台、更新快,建模/雕刻/渲染/动画一体;社区教程极多,适合个人开发与课程作业。本课程用它做“建模—导出 FBX”的最小闭环。
在建筑可视化、影视与游戏公司中使用广泛,插件生态成熟、团队协作流程完善;代价是授权成本与学习曲线。
| 维度 | Unity 6(本课程选择) | Unreal Engine |
|---|---|---|
| 上手成本 | 较低,C# 语法友好,教学资料多 | 较高,C++ 与蓝图双轨 |
| XR 支持 | OpenXR + XR Interaction Toolkit,跨 PICO / Quest / Vive | 内置 XR 框架,偏向高保真与主机级画面 |
| 画面保真 | 够用,移动端一体机表现稳定 | 更强,但更吃 GPU |
| 一体机性能 | 移动端优化路径成熟 | 对头显算力要求更高 |
4.3 三条来路 + 五道关 + 三个最常翻车的坑
Sketchfab 模型库、Poly Haven 贴图与 HDRI、Mixamo 角色动画。适合快速搭场景,注意授权与命名规范。
用 Blender 从零建模,尺寸、拓扑、UV 自己说了算。代价是时间——课程里只在必要的小物件上使用。
Meshy、Hunyuan3D、TRELLIS 等文/图生 3D,适合快速原型。但要检查拓扑、UV、比例与版权,通常需要二次修整。
① 建模 → ② 减面 → ③ 导出 FBX → ④ 导入设置 → ⑤ 在场景里验证
控制面数 禁中文路径 单位与缩放 ↑ 戴上头显看
最常翻车的一关
| 关卡 | 要做什么 | 没做好会怎样 |
|---|---|---|
| ① 建模 | 按真实比例建模,统一单位 | 进 Unity 后比例不对 |
| ② 减面 | 控制在合理面数(一体机尤其敏感) | 掉帧、发热、眩晕 |
| ③ 导出 FBX | 路径与文件名不含中文 | 导入失败、材质丢失 |
| ④ 导入设置 | 检查 Scale / 轴向 / 材质 | 模型躺倒、悬空、变成粉色 |
| ⑤ 验证 | 先在模拟器看,再戴头显看 | “在 PC 上明明没问题” |
Transform → Scale(常用 1 或 0.01);12 分钟 · 不安装,只核对:确认版本与插件齐全就能开工
| 路径 | 打开 Unity → 顶部菜单 Help → About Unity,弹窗里能看到完整版本号,例如 6000.0.83f1 |
| 要做的 | 把这个版本号抄到任务卡上(教师会收齐全班版本号,用于排查工程兼容问题) |
XR Plugin Management、XR Interaction Toolkit;Input System,说明输入系统已就绪;.unitypackage 本地导入(Assets → Import Package → Custom Package)。VRCase01),工程路径必须是纯英文。| 面板 | 位置 | 作用 | 一句话记忆 |
|---|---|---|---|
| Hierarchy 层级 | 左侧 | 列出场景里所有物体 | 场景里“有什么” |
| Scene 场景 | 中央 | 编辑视角,搭建场景 | 你工作的地方 |
| Game 游戏 | 中央 | 运行时真实画面(相机视角) | 玩家“看到什么” |
| Inspector 检视 | 右侧 | 选中物体的组件与属性 | 选中什么改什么 |
| Project 项目 | 底部 | 工程里所有资源文件 | 素材“存在哪” |
| Console 控制台 | 底部 | 报错、警告、调试输出 | 出问题先看这里 |
自测三个问题:运行时报错先看哪个面板?哪个面板显示“玩家实际看到的画面”?哪个面板列出场景里“有什么物体”?
File → Save(Ctrl+S)。场景文件是 Assets/ 下的 .unity 文件,养成随时保存的习惯。
30 分钟 · 把普通 3D 项目变成 VR 项目的一步,后面 9 次课的地基
| # | 操作 | 路径 | 说明 / 注意事项 |
|---|---|---|---|
| B1 | 启用 OpenXR | Edit → Project Settings → XR Plug-in Management | 在 Windows 标签页勾选 OpenXR;OpenXR 是跨设备开放标准,一次配置可支持 PICO / Vive / Quest。若提示需重启编辑器,按提示重启后继续 |
| B2 | 确认 XR Interaction Toolkit | Package Manager → In Project | 它提供抓取、射线、传送、UI 交互等现成交互组件;清单里若出现 Samples,展开能看到 Starter Assets 与 XR Device Simulator 就说明示例包已就绪 |
| B3 | 添加 XR Origin (VR) | Hierarchy 空白处右键 → XR → XR Origin (VR) | 它替代普通相机,负责跟随头显位置与朝向。必须禁用或删除场景里原有的 Main Camera,否则两个相机打架、画面异常 |
| B4 | 添加 XR Device Simulator | Project → Assets/Samples/XR Interaction Toolkit/<版本>/XR Device Simulator → 把预制体拖进 Hierarchy | 用键盘 + 鼠标模拟头显转头与手柄操作。本课程“PC 开发为主、头显验证为辅”,这个组件就是“PC 上开发”的支柱 |
| B5 | Play 验证 | 点击顶部 ▶ Play | 期望结果:Game 视图里视角能随 WASD 与鼠标转动而移动 |
| 按键 | 作用 |
|---|---|
W / A / S / D | 模拟头显前后左右移动 |
| 按住鼠标右键拖动 | 模拟转头 |
Tab(按住) | 切换左右手 |
G(按住) | 模拟手柄握持(Grip) |
| 鼠标左键 | 模拟手柄触发(Trigger) |
25 分钟 · 让场景里真的有东西,而且它会动
Models 文件夹;.fbx(或 .obj)拖进 Assets/Models;| 检查项 | 怎么做 |
|---|---|
| 比例是否合理 | 与场景里的 Cube / Plane 对比;不对就改 Transform → Scale(1 或 0.01) |
| 位置是否合适 | 调整 Transform → Position 的 Y 值(Unity 是 Y 轴向上) |
| 材质是否正常 | 若呈粉红色,说明材质丢失或贴图路径含中文,需重新指定 |
Project 面板空白处右键 → Create → C# Script,命名为 SpinObject——首字母大写、不能有中文、不能有空格。
using UnityEngine;
public class SpinObject : MonoBehaviour
{
public float speed = 60f; // 每秒旋转的角度
// Start 在物体第一次被激活时调用一次
void Start()
{
Debug.Log("SpinObject 启动了");
}
// Update 每帧调用一次(适合做持续运动)
void Update()
{
transform.Rotate(0f, speed * Time.deltaTime, 0f);
}
}
SpinObject 从 Project 面板拖到 Inspector 下方空白处;Speed,看转速变化(试试从 60 改成 600)。| 概念 | 在这个脚本里的体现 |
|---|---|
| GameObject | 你挂脚本的那个物体 |
| Component | SpinObject 本身就是挂在物体上的一个组件 |
| MonoBehaviour | Unity 所有脚本的基类,必须继承 |
| Start() | 只执行一次,适合初始化 |
| Update() | 每帧执行,适合持续动作 |
| Time.deltaTime | 让转动速度与帧率无关——快慢机器上转得一样 |
Time.deltaTime 是本课最值得记住的细节:没有它,高刷新率的机器上物体会转得更快。这和上次课讲的帧率、延迟是同一件事的两面。25 分钟 · 同一个场景,在 PC 与头显里各看一遍
你已经在 PC 上用 Device Simulator 跑通了场景。现在戴上 HTC Vive 看一个真实运行的 VR 场景,体会软件设置与硬件体验之间的差距——这就是本课程“双轨流程”的核心。
| 对比项 | PC 模拟器 | HTC Vive 真机 |
|---|---|---|
| 画面清晰度 | ||
| 转头时的延迟感 | ||
| 眩晕 / 不适感 |
7 个演示 · 浏览器直接打开 · 全部离线可用、无外部依赖
本节课的主线演示是 07 软件生态与管线决策台,它的五个标签分别对应 4.1—4.4 的讲授环节与收束。01—06 为硬件主题,属于上一课(第 3 次课):其中 07 的标签②「硬件 ↔ 软件对照」正好用来回指上次课学过的参数。
Unity 6000.6.0f1 + XR Interaction Toolkit 3.6.0 · 7 个演示,每个 3—6 分钟
下面 7 个演示全部基于这台机器上今天实际装好的版本设计,不是通用教程。每个演示都遵循同一个结构:先说是哪一步 → 现场做 → 让学生看到现象 → 当场读出数字。演示用的工程是 D:\UnityProjects\VRCase01,场景 Case01.unity。
| 组件 | 本机版本 | 在哪看 | 演示时要学生注意什么 |
|---|---|---|---|
| Unity 编辑器 | 6000.6.0f1 | Help → About Unity | Unity 只能升不能降:如果你的版本比机房高,机房的工程就打不开。这是第一件要记下来的事 |
| Input System | 1.20.0 | Package Manager → In Project | 手柄按键、模拟器按键、后续所有交互都走它 |
| XR Interaction Toolkit | 3.6.0 | Package Manager → In Project | 抓取、射线、传送、UI 交互的现成组件都在这个包里 |
| XR Plug-in Management | 4.7.0 | Package Manager → In Project | "一次配置、跨设备"的开关就在它的设置页里 |
| OpenXR | 1.18.0 | Package Manager → In Project | 真正接管头显的运行时;这一个勾错了,Play 之后视角一定不动 |
| XRI 样例包 | 3.6.0(Starter Assets / XR Device Simulator) | Assets/Samples/XR Interaction Toolkit/3.6.0 | 关键认知:模拟器不是第三方插件,是官方包自带的样例 |
| PICO Streaming Service(PC 端) | 已装 | 开始菜单 | 接一体机时才用;接 HTC Vive 走 SteamVR,不需要它 |
Help → About Unity 读版本号 → Package Manager → In Project 读四个包版本 → 填任务卡。Project Settings → XR Plug-in Management → Windows 标签勾 OpenXR → 展开 OpenXR 看 Interaction Profile 列表 → 按提示重启编辑器。XR → XR Origin (VR);删掉旧的 Main Camera;把 XR Device Simulator 预制体拖进 Hierarchy;Play 后用 WASD 移动、按住鼠标右键转头、Tab 切左右手、G 握持、鼠标左键触发。XRSimpleInteractable + InteractButton 脚本;Play 后用射线指上去、按下、移开。hoverEntered)→ 按下变绿(selectEntered)→ 移开复位。deltaTime。SpinObject 拖到物体上 → Play(默认 60 度/秒)→ 在 Inspector 把 speed 改成 180 → 再 Play 对比 → 看 Console。Start 的日志只出现一次。deltaTime,高刷新率的机器上物体会转得更快——这就是"帧率"这个硬件指标在代码里的落点。SceneSelfCheck 自动跑五项检查,按 F1 可重查;按 F2 开性能浮层读 FPS / Triangles / Draw Calls;把场景里的树复制成 10 棵,再看这三个数。n/a,属正常,不影响场景运行。_woodhouse.fbx 与 Palm.fbx → 检查 Scale Factor 与单位 → 放进场景,和 XR Origin 比高矮 → 材质变粉红时重新指定贴图。| 时段 | 演示 | 为什么放在这个点 |
|---|---|---|
| 0:08–0:53 讲授 | 只做 U1(版本与包) | 它同时是"实验 A"的起点,提前做掉,实验段就不慌 |
| 1:03–1:15 实验 A | U1 全班跟做 | 每人都记下自己的版本号,这是后面所有排障的依据 |
| 1:15–1:45 实验 B ★ | U2 + U3 | 地基环节:XR 环境不通,后面全都做不了 |
| 1:45–2:10 实验 C ★ | U4 + U5 + U7 | 先让场景里有东西(U7),再让它动(U5),再让它可交互(U4) |
| 2:10–2:35 双轨验证 | U6 前半段 + 真机 | PC 上先读三个数,戴头显时才有对照 |
| 2:35–2:50 收束 | U6 后半段(复制物体再看数字) | 用它把"优化"第一次讲成可量化的动作 |
| 级别 | 触发条件 | 降级做法 |
|---|---|---|
| 一级 | Package Manager 连不上网、包装不上 | 用提前导出的 XR 相关 .unitypackage 离线安装;U2 改为"看已装好的工程" |
| 二级 | 头显连不上 / SteamVR 找不到设备 | 全部走 Device Simulator,真机环节改为教师机投屏演示,学生只做记录 |
| 三级 | Unity 崩溃或工程打不开 | 用教师机的录屏与截图按原顺序讲完流程,学生改为填写"故障记录表"(也算一次完整练习) |
27 条 B 站视频 · 逐条核验标题、时长与发布日期 · 按学习顺序分组
| 知识点 | 视频 | 时长 | 数据 | 怎么看 |
|---|---|---|---|---|
| Unity 6 正确安装 | 别再把团结引擎当 Unity 了!Unity 6 正确下载安装教程(嗜睡的猫咪) | 18:00 | 13.7 万播放 / 1733 赞 | 本课首推:直接回答"我装的是不是 Unity"——团结引擎是国产分支,工程不通用 |
| Hub 与编辑器安装 | 最简单的手把手保姆级 Unity 入门教程:下载和安装(喵布里) | 13:24 | 8.5 万播放 / 1603 赞 | 课后在自己电脑上补装时用;注意版本要选 LTS 并与机房保持同一大版本 |
| 引擎选型:Unity vs Unreal | Unity 和 UE 引擎应该选哪个?深入浅出的对比介绍(枫2) | 12:10 | 3.2 万播放 / 1139 赞 | 对应 4.1"一类工具只干一件事":为什么本课选 Unity 而不是 Unreal |
| Unreal 的门槛在哪 | 深度解析,为什么 Unreal 比 Unity 难?(倾海海海海) | 12:13 | 7.8 万播放 / 1750 赞 | 反方视角:承认 Unreal 的画面上限,再解释"上限高 ≠ 课堂合适" |
| 知识点 | 视频 | 时长 | 数据 | 怎么看 |
|---|---|---|---|---|
| 编辑器全貌(必看) | Unity 10 分钟快速入门(Ross-Ning) | 11:47 | 78.1 万播放 / 2.6 万赞 | 本课首推:11 分钟走完 Hierarchy / Scene / Game / Inspector / Project / Console 六个面板,正好对上实验 A4 |
| 界面布置与自定义 | Unity 新手入门:编辑器界面布置(上月球去写甲骨文) | 6:37 | 2.0 万播放 / 264 赞 | 面板被拖乱了怎么办——多人共用机房机器时人人都会遇到 |
| 知识点 | 视频 | 时长 | 数据 | 怎么看 |
|---|---|---|---|---|
| OpenXR 环境配置 | 【Unity VR 开发入门】OpenXR:头盔手柄的环境配置(VR-Sowilo) | 9:44 | 7966 播放 / 114 赞 | 本课首推:把"勾了 OpenXR 之后到底发生了什么"讲得比多数教程清楚 |
| OpenXR + XRI 完整配置 | Unity VR 开发教程:OpenXR + XR Interaction Toolkit 安装和配置(Teacher_Liu) | 18:11 | 3356 播放 / 36 赞 | 课后再看一遍,把 B 环节的每一步对齐到视频里 |
| XRI 快速配置交互 | 快速配置交互:移动、抓取、UI 交互(XR Interaction Toolkit)(SpatialXR社区) | 18:44 | 1.8 万播放 / 1094 赞 | 本课首推:想在下节课做出"能抓、能传送"的场景,看这一条 |
| XR Device Simulator(官方) | Unity 设备模拟器(Device Simulator)教程(Unity 官方) | 3:52 | 1.3 万播放 / 295 赞 | 4 分钟讲完全部模拟按键;官方出品,界面与 3.6.0 最接近 |
| XR 模拟器实操 | Unity XR 模拟器 XR Device Simulator 使用教程(Cool灬浩) | 4:43 | 6369 播放 / 103 赞 | 补充"按键没反应"这类现场问题,和本页故障速查表配合看 |
| XR Origin 设置 | Unity 开发 Pico VR 项目基础:导入并设置 XR Origin(老徐看VR) | 3:11 | 1850 播放 / 12 赞 | 补一个"XR Origin 到底替代了相机的什么功能"的直观解释 |
| XR Origin 基本设置 | XR Origin 基本设置(划破长空那一鸣) | 2:43 | 773 播放 / 3 赞 | 短平快;播放量很低,但这一步确实没有更好的中文资料 |
| SteamVR 与 OpenXR 的关系 | 使用 OpenXR 代替 SteamVR 以获得更好的 VR 体验(JuiceforeaL_) | 2:52 | 2.4 万播放 / 399 赞 | 回答"为什么现在推荐 OpenXR,而不是直接挂 SteamVR 插件" |
| SteamVR 报错排查 | 串流时 SteamVR 报错检测不到头盔,怎么解决(赤峰飞人乔尔特) | 18:01 | 8.3 万播放 / 569 赞 | 真机环节最可能撞上的故障,先看症状再对号入座 |
| 知识点 | 视频 | 时长 | 数据 | 怎么看 |
|---|---|---|---|---|
| 模型导入注意事项 | Blender 模型导入到 Unity 的相关设置以及注意点(愿为磐石守一人) | 7:06 | 4.7 万播放 / 704 赞 | 本课首推:比例、单位、坐标轴、材质四条一次讲全,正好对上 U7 |
| 导入 FBX(最短路径) | 两分钟教会你如何在 Unity 中导入 FBX 的 3D 模型(YuZou邹宇) | 1:56 | 2.2 万播放 / 152 赞 | 课堂只放这 2 分钟,其余留给课后 |
| 材质丢失(粉红)修复 | 导入 Unity 的 FBX 丢失了处理方式(经常会遇到)(poorgun慢) | 5:25 | 1.9 万播放 / 127 赞 | 把"模型变粉红"从一个意外变成一个可解释、可修复的常见现象 |
| 脚本生命周期 | 零基础学习 C# 在 Unity 中的使用:脚本生命周期(M_Studio) | 10:35 | 2.8 万播放 / 1369 赞 | 本课首推:Start / Update 各调用几次、顺序如何,看这一条就够了 |
| 从组件到脚本 | 【Unity 游戏开发入门 01】从组件 Component 到 C# 脚本(IGBeginner01) | 4:04 | 3.5 万播放 / 972 赞 | 补"脚本就是一个自定义组件"这个概念,讲清挂载方式为什么是拖拽 |
| Profiler 性能分析 | 简单易懂的 Unity 性能优化:Profiler 使用技巧实例解说(游戏石匠Super) | 10:41 | 7883 播放 / 325 赞 | 本课首推:和 F2 浮层配合,把"掉帧"定位到具体环节 |
| Draw Call 优化 | 几个小动作让帧数立刻提升:Unity 性能优化之 Draw Calls(AliveCat) | 4:24 | 1.2 万播放 / 446 赞 | 回答 U6 里的问题:帧率低时先看三角面还是先看 Draw Call |
| 知识点 | 视频 | 时长 | 数据 | 怎么看 |
|---|---|---|---|---|
| Pico Neo3 开发(1)Hello World | Pico VR Neo3 开发入门教程(1)——Hello World(怜子卿如水) | 6:31 | 3.7 万播放 / 567 赞 | 与实验室备用机同型号,也是目前唯一一条完整的中文设备对应教程线 |
| Pico Neo3 开发(2)传送与移动 | Pico VR Neo3 开发入门教程(2)——射线传送,移动(怜子卿如水) | 8:19 | 1.9 万播放 / 192 赞 | 射线传送是后面"密室逃脱"演示案例的必备交互 |
| Pico Neo3 开发(4)开关门 | Pico VR Neo3 开发入门教程(4)——握把手,开关门(怜子卿如水) | 10:07 | 8705 播放 / 90 赞 | 抓取 + 旋转约束的典型做法,可直接迁移到期末案例 |
| Pico Neo3 开发(7)射线事件 | Pico VR Neo3 开发入门教程(7)——射线悬停和点击事件的回调(怜子卿如水) | 9:02 | 7332 播放 / 110 赞 | 接上 U4 的 Hover / Select,看它在完整项目里怎么用 |
| Unity + SteamVR(Vive) | Unity + SteamVR VR 教程(HTC Vive 设备)(镜欲染) | 10:14 | 4832 播放 / 97 赞 | 本实验室头显是 HTC Vive:这条讲的是 Vive 那条老路,和 OpenXR 方案对照看 |