虚拟现实技术 · 第 7 次课 · 后半程第一课

交互零件库:先练旧作品,再上 PICO 演一遍

第 7 次课 · 2026-10-21 · 4 学时 —— 前两节把自己的旧作品练到“能演示”(复现第 5、6 次课),后两节把 PICO 交到学生手里:老师先演 5 个零件,每人再戴一次走自己的作品,最后上台 60 秒;0:00 前还有 12 分钟课前加餐:DeepSeek 1017 更新 / Harness 介绍 / 新版 3D 故宫 v2 演示

中华女子学院第 7 次课 · 2026-10-21(周三)· 4 学时前两节 90′ 自主练习 + 后两节 90′ PICO 演示(每人一台,含课间 10′)课前加餐 12′:DeepSeek 1017 / Harness / 故宫 v2(0:00 前,不计入 180′)授课人:孙琪翔数字媒体技术实验室
课

课前加餐(12 分钟):新模型能做什么 × 我们自己的故宫 v2

0:00 之前投屏播放,不计入 180′:① DeepSeek V4.1-Flash-1017 更新了什么 ② DeepSeek Harness 是什么 ③ 新版 3D 故宫 v2 现场演示 + 同机位对比

为什么加这一段:这次 DeepSeek 更新(V4.1-Flash-1017)的官方示例 1 就是「故宫 3D 建模展示效果」——而我们在第 4 次课正好用 WebXR 造过一座故宫。所以老师把故宫重做了一版 v2(原版 v1 一个字没动),用 12 分钟让你们先看两件事:AI 现在能"从零做完整项目"到什么程度,以及哪些地方还得人来判断。

PART A · 4′
1017 更新了什么
版本同步 · 更快更省 · 从零做完整项目(游戏 / 3D 建模)· 官方示例 1 = 故宫 3D 建模 · Search / Fetch 开放 + 权重开源。
PART B · 3′
DeepSeek Harness 是什么
不是聊天窗口,是给模型装"手和眼睛"的运行框架:读工程、改代码、跑命令、开无头浏览器验证、多轮迭代到"跑通"。
PART C · 5′
看成品:故宫 v2
浏览器里实时渲染的紫禁城:完整中轴 + 7 机位 + 76 秒航拍巡游,PC 能走、头显能进 VR;再和原版 v1 同机位对比,也看清它差在哪。

一、DeepSeek V4.1-Flash-1017 更新(官方说法)

口径:以上是 DeepSeek 官方发布文的说法(发布文链接),课堂只说"官方称",不要求背数字,也不替官方背书。

二、DeepSeek Harness:模型和真实工程之间的那一层

网页对话框里,你贴一段代码它回一段代码——它看不见你的文件,也跑不了你的程序。Harness 是给模型装上"手和眼睛"的运行框架:模型还是那个模型,Harness 负责给它文件、命令、工具、验证回路。

能力网页版对话DeepSeek Harness
读整个工程 / 直接改文件❌ 要手动粘贴✅ 直接读、直接写
跑命令、开浏览器验证❌✅ 终端 + 无头 Chrome
多轮迭代到"跑通"弱✅ 自动重试、逐步收敛
交付物一段文字 / 代码能跑的工程 + 验证报告

这次的故宫 v2 就是这么来的:先做原版 v1 → 查现成资源 → 一版一版改 → 每改一次都用无头浏览器截图 + 实测指标验收,最后 17 个机位、0 个 JS 错误。官方对版本有要求:DeepSeek Harness 0.2.1-rc.1 及以上才能吃到这次 1017 的优化。

用 AI 改作品的三条纪律:
① 只做能验证的改动——跑起来、控制台无红色报错、数字能复现;
② 小步走 + 留原版——这次 v2 就没动 v1,你们改自己作品也一样:先备份再改;
③ 交的东西要自己能讲清——用了 AI 不丢人,讲不清才丢人。

三、看成品:新版 3D 故宫 v2(点开就能走,头显能进 VR)

这不是视频,是浏览器里实时渲染的 3D:完整中轴(午门—三大殿—后三宫—御花园—神武门),加 角楼 / 城墙 / 筒子河 / 景山 / 城外;屋顶是曲面举折 + 檐角起翘,贴图是 MIT 许可的故宫实拍 PBR 贴图(内嵌在单个 HTML 里,断网也能跑)。

PC:鼠标拖拽环视、WASD 行走、空格开始 / 退出航拍巡游、Esc 退出;HUD 可切 7 个机位与时辰。头显:在 PICO 浏览器里打开上面链接,点「进入 VR」。

新版 3D 故宫 v2 航拍巡游截图
航拍巡游:黑边 + 左上角地名卡 + 底部进度点,12 个关键帧、约 76 秒一轮——镜头语言对齐参考视频的"展示模式"。
新版 3D 故宫 v2 太和门与内金水桥截图
太和门 + 内金水河五桥:曲面屋顶、檐下斗拱 / 彩画 / 椽子、汉白玉栏杆与实拍红墙贴图。
新版 3D 故宫 v2 神武门贴水面截图
神武门 · 贴水面:城台三券门(内凹有进深)+ 重檐庑殿正楼 + 筒子河水面,对应参考 GIF 末段镜头。
指标原版 v1(第 4 次课)新版 v2(本次)
建筑范围午门—太和门—三大殿午门—三大殿—后三宫—御花园—神武门 + 角楼 / 城墙 / 筒子河 / 景山 / 城外
屋顶直坡四坡 / 两坡曲面举折 + 檐角起翘(庑殿 / 歇山 / 攒尖 / 重檐 / 裙檐)
贴图全程序化 Canvas15 张 MIT 实拍 PBR 贴图(内嵌,离线可跑)
机位 / 演示4 个机位7 个机位 + 76 秒航拍巡游
DrawCall41—12742—49(17 次实测)
三角面3.7—3.8 万27.95—28.43 万(内容扩展 7.4×)
JS 错误00(17/17 次加载)

四、同机位对比:一眼看差别

广场远眺:v1 原版(左)与 v2 新版(右)同机位对比
广场远眺 · 同机位:左 v1 原版 → 右 v2 新版。屋顶曲面、金砖地、台基层次、两侧廊庑与围合都能直接对比。
全景俯瞰:v1 原版(左)与 v2 新版(右)同机位对比
全景俯瞰 · 同机位:左 v1 只做到三大殿 → 右 v2 补齐后三宫、神武门、角楼、城墙、筒子河与城外城市。

五、也要看清差距(诚实清单)

所以它证明的不是"AI 什么都能做",而是:"AI 能把你带到哪一步,剩下哪一步要人来做。"——选题、验收口径、差距判断、许可合规,仍然是人决定的。

六、看完写三行(随 H0 交,不计分)

  1. 这次 1017 更新的三个关键词(各一个词):____ / ____ / ____
  2. Harness 和"网页版对话"最大的区别(≤20 字):____________
  3. 故宫 v2 里,哪一处最能说明"AI 生成 + 人验收"?(写一个具体镜头 / 数据 / 差距):____________
导

本节导览

两段式:前两节把自己的旧作品练到"能演示",后两节在 PICO 上把零件和作品演一遍

前两节课你们做的是全景 + 多点漫游。到 10-14 结束,每人手上都有一份"PC 上能看"的作品——但真正能在头显里完整走一遍、还能退出来、还能讲给别人听的并不多。

所以这次课换一种排法:前半程不推进新内容,先把第 5、6 次课的东西自己练回来;后半程把 PICO 交到学生手里,先用头显演示 5 个零件,再每个人都进一次自己的作品,最后 4 人上台做 60 秒演示。装新零件(三通道按钮、擂台玩法)移到课后 H2 / H5。

本次课的三段,按顺序不能换:
① 练旧(前两节 90′)——练习 A 全景漫游器 + 练习 B 多点漫游,两张检查表全绿,作品"能进能退";
② 演新(后两节 90′)——教师用 PICO 演 5 个零件 → 每人戴一次走自己的作品 → 4 人上台 60 秒;
③ 定题(当晚)——M1 六栏,第②段看到的零件就是你选题的弹药。
这节课最容易走偏的地方:把它当成"看一个好看的 demo"或者"再装几个新功能"。 今天真正要交的是"一个能当着别人面演示的旧作品 + 一份敢交的 M1"——不是"又加了几个交互"。

一、本节的三样产出

① 两张练习检查表(全绿)

练习 A(全景漫游器 6 项)+ 练习 B(多点漫游 6 项),每项都要当场演示得出来;写清卡点与 FPS / 降级读数。

② PICO 上的一次完整演示(每人一台)

自己的作品打开 → 进 VR → 看名字牌 → 走 ≥2 个热点 → 退出,填观察卡;或作为 60 秒演示者上台(二者有其一)。

③ M1(当晚交)+ 课后 H1—H5

M1 六栏:主题 / 为什么必须 VR / 目标用户 / 核心交互 / 技术点 / 降级方案。课后作业见 业、课后作业,10-27 23:59 截止。

二、180 分钟怎么分(前两节 90′ + 后两节 90′,含课间 10′)

时段时长环节谁在动手 / 用什么
0:00—0:055′开场:两段式说明 + 任务卡/练习单 + 今天的达标线(不讲课)教师
0:05—0:105′教师投屏演示“合格线”:一份多点漫游作品走一遍进 → 名字牌 → 2 个热点 → 退出教师 + PC
0:10—0:4535′练习 A · 复现第 5 次课:全景漫游器(全景 / 名字牌 / 热点 / 退出路 / 通路)学生 + PC
0:45—0:5510′课间(顺手把 PICO 充上电、投屏软件打开)—
0:55—1:3035′练习 B · 复现第 6 次课:多点漫游(节点边 / 第一眼 / 信息密度 / 性能读数 / 回退 / 互测)学生 + PC
1:30—1:355′P0 发头显:每人一台、眼罩/擦镜布、投屏测试学生管理员
1:35—1:5015′P1 教师 PICO 演示 5 个零件(悬停 / 抓取 / 投掷 / 3D UI / 舒适度),投屏给全班教师 + PICO + 投屏
1:50—2:2535′P2 全班同时上手:每人一台 PICO——自己的作品 8′ + 零件打卡 20′ + 记录 7′学生 + 自己的 PICO
2:25—2:4520′P3 上台 60 秒演示:4 人 × 5′(演示 60″ + 互评 2′ + 切换 2′)学生 + PICO + 投屏
2:45—3:0015′P4 收束:达标线核对 + M1 讲解 + 作业 H1—H5 + 第 8 次课预告教师
时间账:前两节(0:00—1:30)= 5 + 5 + 35 + 10 + 35 = 90′(含课间 10′);后两节(1:30—3:00)= 5 + 15 + 35 + 20 + 15 = 90′;合计 180′ 墙钟(教学 170′)。
P2 的 35′ 是整节课最贵的时间:它决定"每个人有没有真的在头显里走过自己的作品",其他都能砍,这一段不砍。
加强版(墙钟 200′,需提前申请加时 20′):P2 加 10′、P3 扩成 5 人
段时长调整
练习 A / B35′ + 35′不变
P1 教师演示15′不变
P2 全班同时上手45′+10′:每人多 2 分钟,零件打卡从 4 个加到 5 个
P3 上台演示25′4 人 → 5 人 × 5′
P4 收束10′不变

逐段相加:90 + 5 + 15 + 45 + 25 + 15 = 195′;再加 5′ 机动 = 200′。加时的钱要花在 P2(人人戴上),不要花在多讲一页 PPT。

"9 项零件 + 模块 A—D 的原理"去哪了?
· 课上:P1 只演 5 个零件,每个一句结论(15′)——先让人看到,再让人选;
· 课后:演示库 9 个页面 + 视频区 + 作业 H1(任选 3 个写复现记录)承载;
· 下一课:第 8 次课讲状态机时,再把"零件怎么被状态调用"接上。

三、开场必须纠正的一句话

第 6 次课末尾(教学方案第 262 行、课件屏 27 之后)预告的是“第 7 次课进入第 6 章虚拟现实应用开发”。这句话今天当众作废。

作废的那句

“下次进入第 6 章开发,密室逃脱那个项目。” —— 那是 10-13 之前的旧口径。

今天起的三句话

① 后半程改讲基于 WebXR 制作的虚拟现实作品;② 每人交一件 WebXR 作品(期末大作业,占 40%,个人作品,第 12 次课路演);③ 每次课交一个里程碑——今晚就有第一个(M1)。

“前面学的东西白学了吗?”——恰恰相反。第 6 章 16 学时的能力目标,改由第 7—10 次课以 WebXR 途径覆盖。 你手上那份能戴进头显、带自己名字的全景 / 3D 作品,就是期末作品的起点;第 6 次课讲过的那张“节点 + 边”的图,一个字都不用改。
⚑ 这一屏要让学生自己算出来:让他翻回自己的作品问一句——“你现在这份作品,一共能用几种交互?” 绝大多数人的答案是一种:注视停留跳转。这个答案就是今天这节课存在的理由。

四、后半程的地图(挂在这里,每次课开头亮一次)

课次日期一句话主题你要交的里程碑
第 7 次(今天)10-21交互零件库:先把“能做的事”做全M1 选题一页纸
第 8 次10-28WebXR 交互进阶 + 开源 3D 模型资产管线(先做后讲)课堂作业 3:交互验证 + 模型管线 + 许可卡(一页版;M2 并入第 9 次课)
第 9 次11-11路要通、退得出、谁都点得到M3 主流程可玩(硬门槛)
第 10 次11-18好看和跑得动是两件事M4 性能报告
第 11 次11-25让作品会说话,并且能被度量M5 功能封版
第 12 次12-02结课路演与验收M6 路演答辩

这张表不用记,只看三处:M1 是今天;M3 在第 9 次课,标了“硬门槛”——那一次过不去,你的作品就不算完成;M6 是 12 月 2 日,路演。 后面每次课基本是开场 + 讲授 + 课间 + 工作室 + 收束的骨架;本次课是两段式例外(练旧 + PICO 演示),第 8 次课仍为两段式(先做后讲:646 机房 90′ 学生作业 + 430 教室 90′ 头显讲课),学生要形成预期。

五、期末大作业(今天发任务书)

项目内容
占比期末大作业 40%(总评 = 平时 30% + 课堂作业 30% + 大作业 40%)
形式个人作品 · 无上机考试 · 第 12 次课现场路演 3—5 分钟
类型以 VR 沉浸作品为主:头显浏览器打开、进入 immersive-vr 会话完成主流程
禁止不得直接提交课内案例 01—06;可复用其技术,但主题与完成度必须明显不同
点赞三条硬门槛(当众先念这三条)① 能进能退:三条通路之一进 VR,三条退出路至少试通一条;② 零外部网络依赖:不引任何 CDN,断网可跑;③ ≥3 种可指认的交互,且 PC 与 VR 两端都能完成主流程

《期末大作业任务书》写清了个人作品的十条硬门槛、评分量规与六个里程碑——今晚的 M1 就是它的第一步。 “课堂作业墙”里是上一次课全班已交的作品,可以点开对照——你今天要做的,就是让这些作品多出 3 件“能做的事”。

一

WebXR 作品的三层工程结构

本课唯一必须记住的结构:DOM 层 / XR 层 / 状态层,以及三处交界

一、先看一个现象:`Shift+P` 切坐姿

不先讲结构,先看现象。在案例 01 的 PC 预览里按一次 Shift+P——场景里的两块面板一起下沉了 0.45 米,还往下倾了 0.18 弧度(与工程面板同步)。

问题:这两块面板,是网页上的东西,还是场景里的东西?
答案:都是场景里的 3D 物件。如果是网页上的浮层,按 Shift+P 它只会被压在原地——而且更要命的是,进了沉浸模式,网页浮层根本不渲染,你压根看不见它。
于是得到第一层结论:沉浸模式下,DOM 看不见。你的所有界面,必须是场景里的 3D 物件。

这一屏必须让学生自己看出来:不要直接说“下沉 0.45m 说明它是 3D 的”,先问“它为什么跟着沉”,等学生说出“因为它跟着参考系”再往下讲。

二、一句话:DOM 层管 PC,XR 层管头显

沉浸模式(immersive-vr)里,DOM 层退出渲染。于是同一份 HTML 里,必然住着两种界面——

把现象翻译成一句工程话:你交付的是一个 HTML 文件,但这个文件在两种情况下表现完全不同。在 PC 上它是网页(有 DOM、有键位、有控制台),在头显里它是一段 3D 场景(DOM 全部下线,只剩渲染出来的 3D 内容)。一份文件里同时住着两种界面,怎么写才不会打架?答案是分成三层。

三、三层分工图

┌─────────────────────────────────────────────┐
│  ① HTML / DOM 层   —— 给 PC 与开发看         │
│     键位表 · 说明牌 · 报错 · 开发期调试        │
│     特性:沉浸模式下【不下线绘制】            │
├─────────────────────────────────────────────┤
│  ② XR 层           —— 给头显看               │
│     会话 immersive-vr · 参考系 local-floor    │
│     帧循环 · 帧预算 13.9ms · 动态降级 L1/L2    │
│     移动与转向范式(瞬移 + Snap 45°)          │
├─────────────────────────────────────────────┤
│  ③ 状态层          —— 一个 S 对象            │
│     力/速度/计数/开关/进度,全在这里           │
│     特性:可被外部查询、可被外部改写           │
└─────────────────────────────────────────────┘
        ↑ 三层的交界只有三处,下面逐层展开 ↑
为什么是这三层,而不是“代码结构”?你们现在的作品是一个大 HTML 文件,所有东西混在一起:状态散在十个变量里,界面一半是 DOM 一半是 3D,帧循环里夹着业务逻辑。 不先给一套分层的话,后面第 8—11 次课每次都只能“贴代码”,改一处动全身。
三层是可以肉眼验证的:Shift+P 一按,DOM 层没变、XR 层下沉了 3D 面板——全班同时能看到“层在哪里分界”。

第 1 层 · HTML / DOM 层,它只负责两件事

① PC 通路

鼠标拖拽环视 / W A S D 行走(Shift 加速)/ Q E 转身 / 左键点物体抓取 / 左键点地面传送 / 左键点面板 / R 重置。

② 开发期与调试

键位说明牌、报错提示、window.isSecureContext 检测(不安全时按钮直接写“进入 VR(需要 HTTPS)”)。

交界一 · 为什么你的名字必须是 3D 物件

同一件事写法结果
❌ 网页浮层<div class="name">张三</div>PC 上看得见,头显里不存在
✅ 3D 物件场景里的一块牌子 / 铭牌 / 碑PC 与头显都在

上一次课全班 9 份作品,做出了 9 种 3D 名字:横匾 / 门牌 / 金色铭牌 / 署名石碑 / 霓虹横幅 / 牌坊 / 立牌 / 云柱牌子 / 场景内立体文字。这就是“分层”在你们自己作品里的第一次落地。

交界二 · PC 键位是“必需”,不是“顺手加的”

硬门槛里有一条:主流程 PC 与 VR 两端都能完成。
理由很现实:教室机位 36 个 / 选课 40 人——总有人手上没有头显;而且期末你要交的是能给别人看的东西,不可能人人发一台头显。
所以 DOM 层不是“给开发者的赠品”,它是一条正式通路。你们改作品时,PC 那条路不能塌。

这一层最容易被写坏的一个地方,是按钮:看着能点、其实点不动。上一届有同学的处理办法很好——加了一行 btn.disabled = false,又加了一个 window.isSecureContext 检测:不在安全上下文里,按钮上直接写“进入 VR(需要 HTTPS)”。他不是背下来这两条,是踩过之后把它写进了代码里。

第 2 层 · XR 层,它只干三件事

① 会话

immersive-vr —— 能不能进 VR 的第一个前提。

② 参考系

local-floor —— 眼高由它决定。

③ 帧循环

每一帧做什么。状态就在这一层被读到画面上。

⚠️ 进 VR 的前提是安全上下文:navigator.xr 只在 https / localhost / 127.0.0.1 下暴露。 file:// 下它就是 undefined —— 页面上根本没有“进入 VR”这个按钮,这不是代码坏了。 这就是从第 5 次课立的那句口号:先怀疑环境,再怀疑代码。

帧预算为什么是 13.9ms,不是 16.7ms

目标 72Hz ⇒ 13.9 ms / 帧 —— 不是 16.7 ms。差的这 2.8 ms,是浏览器合成占掉的时间(16.7 是 60Hz 的数)。
工程面板实时显示:FPS · 帧时间 · 最差 1% 帧 · DrawCalls · 三角面 · 贴图数。

今天不讲优化(那是第 10 次课)。今天只要求你认出两个读数在哪:FPS 与降级等级。待会儿进 VR 的时候,先低头找到这两处。

动态降级 L1 / L2

触发条件动作能否恢复
帧时间持续超预算 20% 达 2 秒L1 降像素比 → L2 关阴影余量恢复时自动回升(可逆)
没有降级记作 L0—

待会儿进 VR,如果面板上写着 L1 或者 L2,那说明当时的机器撑不住——把它记下来,第 10 次课专门解决这个。

移动与转向:默认值不是随便选的

做法舒适度代价
瞬移(传送)最不易晕破坏空间连续性
平滑移动沉浸感好晕动症主要来源
Snap 45° 转向显著降低眩晕—(有 380 ms 冷却防误触)
平滑转向连续更易晕
VR 里永远不要强制旋转相机。你可以在场景里放一个“看这里”的提示,但不要替用户转头——那是晕得最快的一种做法。

第 3 层 · 状态层就是一个 `S` 对象

整个作品的可变部分,住在一个 S 对象里:力 / 速度 / 计数 / 开关 / 进度,全在这里。案例 01 的调试入口:浏览器控制台输入 VRSandbox,可查看 / 操作全部状态;面板上的“重力”按钮,实时改的就是 S.gravity(默认 9.8)。

⚑ 为什么“一个 S”这么重要:案例 01 有两个投掷相关的常量挂在状态上——S.gravity(重力,默认 9.8)与 S.restitution(弹性)。 课堂作业里有这么一条:把重力从 9.8 调到 3,再投一次,描述手感差异。
假设重力不是挂在 S 上,而是散在三个函数里各写一遍 9.8——改重力得改几处?三处,而且只要漏一处,这个球的行为就自相矛盾。 这就是“一个 S”的价值:同一个东西,全作品只有一个来源。
硬门槛:状态集中在一个 S 对象,且可被外部查询(window.XX.S)。为什么要“能被外部查询”?三个真实用途:
① 你自己调试——控制台敲一行就能看到现在的状态,不用到处打 console.log;
② 别人验收你的作品——第 12 次课路演,评审要看“你到底做到了哪一步”;
③ 数据可以导出——体验数据里的时长 / 交互次数 / 完成度,都是从状态里取的。
换句话说:状态不集中,你后面三次课的里程碑全都交不出来。

四、三处交界,一句话总结

交界规则违反的后果
DOM ⇄ XR沉浸模式下 DOM 下线面板 / 名字在头显里看不见
XR ⇄ 状态帧循环每帧读一次 S状态改了但画面不变
状态 ⇄ DOM面板按钮与键盘快捷键共用同一个 S同一个人两个值,行为自相矛盾

最后一条叫 单一设置源(single source of truth)。举例:面板上有个“重力”按钮把它调到 3,你又写了个键盘快捷键按一下把重力设回 9.8;如果这两个用了不同的变量,屏幕上显示的是 3,实际跑的是 9.8——你自己都会被自己骗。

五、把话头转回你们自己

请在纸上写三行,写你自己的作品:
① 我的状态现在都在哪里?(一个变量?还是散着?)
② 我的界面是 DOM 还是 3D 物件?
③ 我的帧循环里,除了渲染还夹着什么业务逻辑?

写完这三行你就会发现:你现在的作品,三层基本是糊在一起的。这不丢人——上次课的目标是“把路走通”,不是“把结构搭好”。 但从今天起,你改每一处的时候都要问一句:这一行属于哪一层?

本次课对这一段的处理:不单独讲。两段式里它只出现两次——① 开场投屏"合格线"时用 2 分钟点一下"哪一层坏了";② P1 讲"一个 S"时用 1 分钟。完整内容留给学生课后自学(本页 + 案例 01 的 Shift+P 演示)。
二

案例 01 的 9 项交互范式

这是零件库的全集:课上只在 P1 演 5 个(15′),其余 4 个留给作业 H1 自学;表里的“演示”列是建议时长

这一段是“零件菜单”的完整版,今天课上不逐项讲:P1 只演 5 个(悬停 / 抓取 / 投掷 / 3D UI / 舒适度),每个一句结论; 剩下的 4 个(重力实验室 / 重力手套 / Fitts / 触觉手势)在演示库里,作业 H1 要你任选 3 个写复现记录。 看表的时候只看“要讲的点”和对应演示——M1 的“核心交互”就从这几行里挑。

#范式案例里的实现要讲的点演示
1射线指向手柄发蓝色射线,命中物体 / 面板 / 地面最通用的“远距离指针”,判定用 Raycaster.intersectObjects;记住这三种命中,后面所有交互都在这三种上分岔★ 5′
2悬停反馈命中按钮时高亮 + 轻震动 + 提示音没有反馈的交互等于没有交互;反馈要视觉 + 触觉 + 听觉三通道,做自己的按钮时至少给两个★ 4′
3直接抓取握持键(squeeze)抓 0.35 m 内物体,Object3D.attach() 保持世界变换attach 与 add 的区别:add 会跳变,attach 保留世界位姿;这两个方法差一个字母,效果差很远★ 5′
43D UICanvasTexture 面板 + 射线 UV 命中检测,6 个按钮 / 开关UV → 像素坐标 → 按钮矩形命中;WebXR 里最实用的 UI 方案,不需要任何 UI 框架★ 5′
5移动:传送射线指地 → 绿色落点环 → 松扳机平移最不容易晕,但破坏空间连续性(“我刚才还在客厅吗”)★ 3′
6移动:平滑左摇杆连续推动;面板可切换沉浸感好,但是晕动症主要来源;可连做 30 秒体会差异★ 3′
7转向:Snap 45° / 平滑右摇杆;380 ms 冷却防误触Snap 显著降低眩晕;VR 里永远不要强制旋转相机★ 3′
8远距离拉取扳机指向远处金色方块,方块飞向手柄,<0.42 m 自动吸附上手“隔空取物”是舒适度高但真实性差的折中方案——什么时候用它,是设计选择,不是更好的方案★ 3′
9投掷释放时按手柄线速度(EMA 平滑)赋初速度;落地弹跳、撞墙按法线弹性反弹速度采样必须平滑(vel.lerp(..., 0.35)),否则手一抖球就飞出去;物理手感是调出来的,不是写出来的★ 4′
+触觉反馈抓取 / 命中 / 收纳 / UI 各不同强度 pulse()inputSource.gamepad.hapticActuators[0].pulse(强度, 毫秒)穿插在 2/3/9 里
+目标反馈彩球入同色箱 / 投中靶盘:计数 + 闪光 + 音效目标 + 即时反馈 = 可评估的交互,而不是“能抓就行”穿插在 9 里

逐项对时:5 + 4 + 5 + 5 + 3 + 3 + 3 + 3 + 4 = 35 分钟。建议把这张时间纸条压在讲台手边。

一、VR 手柄与 PC 键位映射(这两套都要走通)

VR:头显 + 双手柄

  • 手柄射线:远距离指向(物体 / 面板 / 地面);
  • 扳机:面板按钮、传送落点、远距离拉取;
  • 握持键(侧键 / squeeze):抓取 0.35 m 内物体;释放即投掷;
  • 左摇杆:平滑移动;右摇杆:Snap 45° / 平滑转向;
  • 触觉:抓取 / 命中 / 收纳 / UI 各不同强度。

PC:鼠标 + 键盘

  • 鼠标拖拽:环视;
  • W A S D(Shift 加速):行走;Q / E:转身;
  • 鼠标左键点物体:抓取(再点一次放开);
  • 鼠标左键点地面:传送;左键点面板:操作按钮;
  • R:重置场景。
PC 快捷键行为课上怎么用
Shift+P坐姿 / 站立(面板随之下沉 0.45 m、下倾 0.18 rad)讲三层结构时的开场现象
Shift+H惯用手循环:双手 → 单手(自动)→ 仅右手 → 仅左手 → 双手★ 至少试一次“仅左手”,见下
Shift+G注视停留点击(停在按钮上 1.2 s 触发,相机上有注视准星)讲“边界一”时的演示

二、这段必须做的两件事(不讲就是漏掉本课最重要的边界)

① 当场切一次单手模式(Shift+H 到“仅左手”):案例在单手模式下所有交互仍可完成。
这句话要落成结论——任何单一输入通道都能走完主流程。这是第 9 次课的验收口径,今天先埋下。
② 当场切一次注视停留(Shift+G):注视停留只能点 3D 面板(工程面板 + 案例自有控制面板,停留 1.2 s 触发,相机上有注视准星)。 场景实体(球、方块)仍需手柄射线——这条边界不要掩盖,它正是第 9 次课“免手柄通路怎么补”的讨论起点。

⚑ 这一屏必须让学生自己看出来:先把视线移到场景里的球上停住,球不动;问“为什么球不动”,等学生说出“面板和物体是两套判定”再往下讲边界二。

边界二 · 未在真机验证的部分(必须对学生诚实)
案例 01 的全部结论来自 Chrome 无头浏览器 + 软件渲染;它的 README 明写:手柄握持键 squeeze 与触觉 hapticActuators 未在真机验证,PICO 固件对这两者的支持存在版本差异。 若握持键无响应 → 改用扳机抓取。
所以:“自动断言 17 项全通过”只说明代码逻辑自洽,不证明戴到头上能用。别把“代码里写了”当成“能用”。
演

演示案例库:9 个零件,一人一个“可上手”的实验室

全部是单文件 WebXR:PC 鼠标键盘能玩;头显浏览器打开就能进 VR——P1 的演示和作业 H1 都用它

本班 PICO 每人一台:这 9 个演示不只是“老师放给你看”,而是 P2 里你自己戴着头显逐个打卡(每人至少 4 个:2 指定 + 2 自选)。下面先给卡片,再给逐件体验手册(步骤 / 看哪两个数 / 结论 / 坑)。

案例 01 是一间大实验室——9 个零件都在里面,但它太大,学生第一次读会迷路。 这套演示库把每个零件拆成一个独立小页:一屏只讲一件事,HUD 上写着“这个演示在课堂上要讲什么”,面板上只有 3—6 个按钮,源码只有几百行。

三个用法(按顺序):
① P1 用 PICO 演示:教师挑 5 个投屏给全班,每个只讲一句结论;
② P2 学生对照:戴着头显走完自己作品后,再顺手体验 1—2 个零件,找“下一步想加什么”;
③ 课后当模板改:每个演示都是“复制走就能改”的单文件,作业 H2/H3/H5 直接在它上面长。
每个演示都内置自测:浏览器控制台输入 LAB.api.selfTest(),会返回该演示的核心机制断言(状态机 / 物理 / 命中 / 反馈 / 重置),11 个页面合计 175 条断言(单例 10—28 条)。 课堂上可以让学生现场跑一次——“代码里写了”和“当场能跑通”是两件事,这条口径从案例 01 沿用。
PICO 演示菜单 课上演 5 个;其余 4 个留给作业 H1;每个标题下写着“什么时候放”
lab01 射线·悬停·三通道反馈 截图
LAB 01 · 射线 / 悬停 / 反馈
三通道反馈与 Midas touch
同一个按钮两种模式:单级(一碰就触发,误触计数器狂跳)与两级(悬停只高亮 + 0.2 轻震,确认才触发 0.5)。在画面里同时看到“视觉 / 听觉 / 触觉”三个灯。
P1 第 1 个演示(悬停三通道)· 课后对应 H2
lab02 抓取校准 attach 与 add 截图
LAB 02 · 直接抓取
attach 与 add:抓取校准
同一个物体,attach() 抓起来位姿是对的,add() 会“跳”一下;屏幕上直接给出跳变距离(毫米),抓取距离还能切 0.20 / 0.35 / 0.80 m。
P1 第 2 个演示(抓取校准)· 课后对应 H3
lab03 投掷物理校准 截图
LAB 03 · 投掷
力度 × 平滑 × 重力:手感是可测量的
力度 0.6 / 1.15 / 2.0、EMA 平滑 0.05 / 0.35、重力 9.8 / 3 / 25 三组旋钮,每次投掷自动进“命中记录表”。“手感”第一次变成三个可复现的数字。
P1 第 3 个演示(投掷)· 课后对应 H3
lab04 重力实验室 截图
LAB 04 · 状态层
重力实验室:同一颗球,三种世界
地球 / 月球 / 木星三档重力 + 弹性切换,实测落地时间、弹起高度、弹跳次数,并和理论比值 √(g₁/g₂) 对照。改一个 S.gravity,画面、读数、音高同时变。
P1 讲“一个 S”时抽点 · 课后对应 H1 / H3
lab05 远距离拉取 重力手套 截图
LAB 05 · 远距离拉取
重力手套:简化版 vs 三段式
简化版“飞向手 + 自动吸附” vs Alyx 式选中 → 确认 → 弧线飞行 → ±0.25 s 甩腕接住。同一个功能,多一个时机窗口就从“方便”变成“好玩”。
课后自学(H1 可写)· 讲“功能”与“体验”的差别
lab06 Diegetic UI 四分类 截图
LAB 06 · 3D UI
Diegetic UI:信息长在世界里
同一组“分数 / 生命 / 提示”四种放法:世界内腕表、空间面板、跟随头部、网页浮层。按 4 切到浮层再进 VR,当场看它消失——这就是第 6 次课“名字牌”那个坑。
P1 第 4 个演示(3D UI)· 衔接第 8 次课的状态提示
lab07 舒适度与移动范式 截图
LAB 07 · 移动与舒适度
瞬移 / 平滑 / 隧道遮罩
四种移动方式 + Snap 45° + 遮罩强度 0/0.5/1,还带一个“强制转相机”的反例开关。自己走 30 秒、自己打 1—5 分,把“我觉得晕”变成一条可记录的实验数据。
P1 第 5 个演示(舒适度)· 第 9 次课可访问性的前置
lab08 Fitts 定律与 Goldilocks 区 截图
LAB 08 · 交互距离
Fitts 定律 × Goldilocks 舒适区
目标按距离/大小依次出现并计时,ID = log₂(A/W+1) 与 MT 画成散点;面板高度可切 1.0 / 1.3 / 1.7 / 2.0 m,判定“要弯腰 / 舒适 / 要抬手”。
课后自学(H1 可写)· 讲“面板放多高、为什么远距离用射线”
lab09 触觉分级与手势 pinch 截图
LAB 09 · 触觉 / 手势
触觉语义分级 × pinch 确认
悬停 0.2 / 抓取 0.5 / 命中 0.8 / 错误 1.0 四档强度与时长的对照;手部追踪可用时读 pinch,不可用时按 P 模拟,走通“靠近 → 捏合确认”的两级通路。
课后自学(H1 可写)· 第 9 次课“免手柄通路”的选项

零件体验手册(P2 打卡用,逐件细看)

每个零件都按同一套结构:页面里有什么 → 三步体验 → 看哪两个数 → 结论 → 常见坑 → 对应作业。 P2 里按“零件打卡表”走,每个零件 4—5 分钟;体验完把结论写进打卡表。找不到按钮就看页面左上角 HUD(每个演示都写了 PC / 头显操作)。

LAB 01 · 射线 · 悬停 · 三通道反馈——为什么“一碰就触发”是灾难

页面里有什么:一块 3D 面板 + 3 个靶球;HUD 显示“悬停 / 确认 / 误触”三个计数,以及“视 / 听 / 触”三个通道灯。

三步体验:① 面板切到单级模式,用射线扫过按钮(不按扳机)——看“误触”计数往上跳;② 切到两级,再扫过——只高亮,不触发;③ 在两级模式下按扳机确认——三个通道灯同时亮。

看哪两个数:误触次数(单级会涨、两级为 0);通道灯数量(悬停 2 个、确认 3 个)。

结论:悬停 ≠ 确认;一次有效交互至少给两个通道,强度要分档(悬停 0.2 / 确认 0.5)。

常见坑:进了 VR 声音不响——浏览器的自动播放策略,要在“进入 VR”那个用户手势里调 ctx.resume()。

对应:作业 H2(三通道按钮);M1“核心交互”第 1 项。

LAB 02 · 抓取校准:attach 与 add——差一个字母,差一个位姿

页面里有什么:一张桌子 + 一个长条物体 + 两侧距离标尺;一块“读数屏”显示本次抓取的世界位置跳变 Δ(毫米)。

三步体验:① 模式 attach → 点“抓取一次”——读数屏 Δ 应接近 0 mm,物体“一到手里就对”;② 模式切 add → 再抓一次——读数屏 Δ 会到上千毫米(截图实测 1492.6 mm),物体会“跳”一下;③ 把抓取距离档从 0.35 切 0.20 / 0.80,各抓一次——感受“太近够不着 / 太远像隔空取物”。

看哪两个数:Δ 值(attach≈0 / add≫0);抓取成功与否(距离档位决定)。

结论:add 换父级坐标系→跳;attach 保持世界变换→不跳。抓取对齐是给别人的手设计的,不是给你自己的手。

常见坑:改完代码没刷新,看到的是缓存;抓歪 30° 时“跳”最明显,别只用一个角度试。

对应:作业 H3(抓取距离校准表);第 9 次课谜题交互。

LAB 03 · 投掷校准:力度 × 平滑 × 重力——“手感”是三个数字

页面里有什么:投掷线 + 8 m 外带环数的靶盘 + 3 个球;右侧一块命中记录表(力度 / 平滑 / 重力 / 命中环数 / 落点距离)。

三步体验:① 力度 0.6 → 投一次 → 再 1.15 → 再 2.0,各看落点与命中;② 把平滑从 0.35 改 0.05,再投——体会“手一抖球就飞”;③ 把重力从 9.8 改 3(月球)/25(木星),各投一次看手感差异。

看哪两个数:命中环数;落点距离(m)。截图实测示例:力度 1.15 → 10 环 8.50 m;力度 0.6 → 未中 3.77 m。

结论:投掷 = 速度采样(EMA 平滑)+ 力度系数 + 重力;手感是调出来的,不是写出来的。

常见坑:平滑系数是“保留权重”——0.05 几乎不平滑(抖就飞),0.35 更稳但会滞后;进 VR 后用手柄速度而不是鼠标位移。

对应:作业 H3(力度-命中小表);第 10 次课性能数据习惯。

LAB 04 · 重力实验室:同一颗球,三种世界——验证“一个 S”

页面里有什么:3 m 高的落球架 + 接球盘 + 三档重力(地球 9.8 / 月球 3 / 木星 25)+ 弹性(0.45 / 0.9);HUD 实时显示 g、e、落地时间、首次弹起高度、弹跳次数、理论比值 √(9.8/g)。

三步体验:① 地球档按“落下(空格)”,记落地时间;② 切月球档再落一次——球像羽毛;③ 切木星档再落一次——球“砸”下来;最后把弹性调到 0.9 看“跳跳球”。

看哪两个数:落地时间 t(地球≈0.69 s、月球≈1.24 s、木星≈0.43 s);弹跳次数(e=0.45 vs 0.9)。

结论:改一个 S.gravity,落体、面板读数、音高同时变——状态只有一个来源;月球/地球落地时间比 ≈ 1.807 = √(9.8/3)。

常见坑:只看“球变慢了”不够,要读数字证明比值;面板与代码不一致,说明状态没集中。

对应:作业 H1/H3;第 8 次课状态机(一个 S)。

LAB 05 · 重力手套:简化版 vs 三段式——功能与体验差一个窗口

页面里有什么:前方 4—6 m 一排 5 个物体 + 接取区;面板可切简化版 / 三段版;HUD 显示阶段(待选 / 已选 / 飞行中 / 接住 / 掉落)、甩腕窗口、接住与错过次数、弧线中点偏移。

三步体验:① 简化版:指向物体 → 扳机 → 物体直接飞向手并自动吸附;② 三段版:悬停选中(高亮)→ 再按一次扳机确认 → 物体会沿弧线飞来;③ 在到达前 ±0.25 s 内快速“甩腕”(PC 按空格;VR 用手柄速度 >1.2 m/s)——接住 / 错过。

看哪两个数:甩腕窗口剩余时间(0.09 s → now);弧线中点偏移(截图 0.39 m,>0.15 才说明是弧线不是直线)。

结论:Alyx 的重力手套是选中 → 确认 → 飞行 / 甩腕接住三段;同样的“拉取”,多一个时机窗口就从“方便”变成“好玩”。

常见坑:窗口外甩腕也会“接住”=判定写错;简化版没有风险,所以学生做出来的往往“能用不好玩”。

对应:H1 记录;M1“核心交互”的候选(如果你的作品有“取物”)。

LAB 06 · Diegetic UI:信息长在世界里——DOM 进 VR 就消失

页面里有什么:同一组“分数 / 生命 / 提示”四种呈现:① 世界内腕表 + 胸口血条;② 空间面板(贴墙);③ 跟随头部;④ 网页浮层(DOM)。面板可一键切换。

三步体验:① 依次切四种模式,看同一组数字怎么跟着变;② 切到“网页浮层”再进 VR——浮层消失;③ 回到“世界内”,低头看腕表:分数、生命都在。

看哪两个数:分数 / 生命在四种模式下是否一致(同一个 S);浮层在 VR 里是否可见(答案:不可见)。

结论:沉浸模式下 DOM 不渲染;界面必须是 3D 物件。diegetic 最沉浸但要主动看,复杂数据配 spatial。

常见坑:把提示做成 DOM,PC 上好好的,戴上去“什么都没有”——第 6 次课“名字牌”踩过的同一个坑。

对应:H5 的 diegetic 改造;第 8 次课“状态 → UI 同步”。

LAB 07 · 舒适度:移动范式 × 隧道遮罩——为什么会晕

页面里有什么:一条 24 m 走廊 + 地面刻度;四种移动方式(瞬移 / 平滑 / 平滑+遮罩 / 关闭移动)+ Snap 45° + 遮罩强度 0/0.5/1 + 一个“强制转相机”的反例开关;HUD 显示视觉流指标 VFI 与自评记录。

三步体验:① 平滑移动走 20 秒,打 1—5 分;② 加遮罩到 0.8 再走 20 秒,再打分;③ 切瞬移走一段,再打分;顺手开一下“强制旋转相机”,看 HUD 红字警告。

看哪两个数:VFI(视觉流指标)与自评分数;遮罩 0 与 1 的周边暗角差异。

结论:晕来自“眼动身不动”的感觉冲突;少动、慢动、挡周边;新手默认瞬移 + Snap 45°,永远不强制转相机。

常见坑:把“平滑 + 平滑转向”当默认——新用户 10—15 分钟就可能不适;个体差异是脱敏,不是体质差。

对应:第 9 次课可访问性;H6 单手结论。

LAB 08 · Fitts 定律 × Goldilocks 舒适区——面板放多高

页面里有什么:目标按距离 / 大小依次出现并计时;面板画 ID = log₂(A/W+1) → MT 散点;高度档 1.0 / 1.3 / 1.7 / 2.0 m。

三步体验:① 打 6—8 个靶(不同距离与大小),看散点往右上走;② 把面板高度切 1.0 → 判定“偏低(要弯腰)”;③ 切 2.0 → “偏高(要抬手)”,1.3 / 1.7 才是“舒适”。

看哪两个数:ID(bit)与 MT(ms);高度判定(偏低 / 舒适 / 偏高)。

结论:目标越远越小越慢;近处用手、远处用线;交互面板放在胸口到眼高(约 1.2—1.8 m)。

常见坑:无头 / 模拟数据下的 MT 是“机制验证值”,课堂结论要用你自己的真机数据;只测一个距离看不出规律。

对应:H1 记录;你作品面板的摆放高度。

LAB 09 · 触觉语义分级 × 手部追踪 pinch——一个强度用到底就是噪音

页面里有什么:四档语义按钮(悬停 0.2 / 抓取 0.5 / 命中 0.8 / 错误 1.0 长)+ pinch 时间线 + 虚拟手;HUD 记录最近 5 次 pulse(强度 / 时长 / 真机是否支持)。

三步体验:① 依次按四档,感受强度与时长差异(0.2/30ms、0.5/60ms、0.8/90ms、1.0/200ms);② 按 P 模拟 pinch:先“靠近”(0.2)再“捏合确认”(0.5);③ 看 HUD 是否标注“PC 只记日志 / 真机支持未验证”。

看哪两个数:四档强度值与时长;pinch 状态(idle → near → confirm)。

结论:触觉要按语义分级(UI / 抓取 / 命中 / 错误),不是“越强越好”;手部追踪的 pinch = 确认,是免手柄通路。

常见坑:PICO 固件版本差异,触觉与 pinch 未在真机验证;课上按 HUD 提示,无响应就用键盘模拟走通路。

对应:H1;第 9 次课“免手柄通路”。

零件打卡表(P2 填,至少 4 个:2 指定 + 2 自选)

零件一句话结论(自己写)我体验了吗我的作品能用吗
lab01 悬停三通道□ 指定 □ 自选□ 能 □ 不能 □ 以后
lab02 抓取校准□ 指定 □ 自选□ 能 □ 不能 □ 以后
lab03 投掷□ 指定 □ 自选□ 能 □ 不能 □ 以后
lab04 重力实验室□ 指定 □ 自选□ 能 □ 不能 □ 以后
lab05 重力手套□ 指定 □ 自选□ 能 □ 不能 □ 以后
lab06 Diegetic UI□ 指定 □ 自选□ 能 □ 不能 □ 以后
lab07 舒适度□ 指定 □ 自选□ 能 □ 不能 □ 以后
lab08 Fitts / 舒适区□ 指定 □ 自选□ 能 □ 不能 □ 以后
lab09 触觉 / pinch□ 指定 □ 自选□ 能 □ 不能 □ 以后
打卡不是“玩过”:每个零件都要写出那句结论才算打卡。写不出来的,回演示里把“看哪两个数”再对一遍—— 这 9 句话就是 M1“技术点”和 H1 三行记录的原句。
边界要一起说:9 个演示都通过了无头 Chrome 自动检查(无 JS 报错 + 内置自测全过 + 渲染调用数 > 0),但这只证明代码逻辑自洽。 手柄握持键、触觉马达、手部追踪三项未在真机验证,PICO 固件存在版本差异——课前用一台头显实测 5 分钟,握持键无响应就改用扳机抓取。 “演示能打开”不等于“戴上去能用”,两者都要当场验。

打开方式:PC 上双击/本地服务器即可;头显里必须用 https 或 127.0.0.1(file:// 不是安全上下文,navigator.xr 是 undefined)。课堂上最省事的是——这些演示已经挂在课程站的 https 上,头显浏览器输网址就能开。

三

三条通路:先怀疑环境,再怀疑代码

收束段花 7 分钟把三条现场走一遍,但课堂上只教走通的那一条

这节课是后半程第一次真机实操,后面五次课每次都要走通路。今天不把通路讲透,后面五次课每次都要花 20 分钟救火。 三条都演示、只教一条,是为了让学生知道“还有别的办法”,遇到问题时不会卡死在一条路上;同时避免教师在课堂上同时维护三条路径。

#通路我怎么操作特点与麻烦
①USB + adb reverse数据线连头显与笔记本,执行 adb reverse tcp:8080 tcp:8080 → 头显浏览器开 http://127.0.0.1:8080/天然是安全上下文(127.0.0.1),校园网再怎么隔离也不怕、不占网络;但要开发者模式与 adb
②局域网 http + 头显白名单头显浏览器进 chrome://flags/#unsafely-treat-insecure-origin-as-secure,填入 http://电脑IP:端口不用连线;但电脑 IP 一变就要重填,这是它最大的麻烦
③站点 https直接打开 https 地址最省事,也是以后收作业与互评的首选;需要有可发布的站点
板书一句(第 5 次课已确立,全程沿用):先怀疑环境,再怀疑代码。
navigator.xr 只在 https / localhost / 127.0.0.1 下暴露。 file:// 不是安全上下文 → navigator.xr 是 undefined → 页面上看不到“进入 VR”按钮。
双击 HTML 文件永远进不了 VR。“装进头显”的正确说法是:在头显里通过 https / localhost / 白名单地址打开。

一、退出和进入一样重要

三条退出路操作课上怎么记
① 注视按钮注视「退出 VR」1.5 秒打钩 + 记下用时
② 握把长按长按手柄握把 2 秒打钩 + 记下用时
③ 系统键头显系统键打钩 + 记下用时
当场演示退出,比演示进入更重要。第 9 次课的硬门槛口径是“路子不通、或者退不出去的作品,画面再好看也不算完成”——这个口径今天就要先说出来。

二、课堂只教一条,但三条都演示

课前教师会实测并选定一条(本次课选定的是哪一条:【待确认:由教师课前实测后当堂宣布】)。三条你都试一下“能不能打开”,但主用那一条就行。 你们不用三条都会——会用一条,就够了。
看不到“进入 VR”按钮时,先问是不是安全上下文,再怀疑代码。
40 人同时进 VR 的通路压力:校园网常有客户端隔离,40 台设备同时投屏会压垮一个 AP。 课堂取证首选头显系统截屏 → USB 导出,不占网络也不受隔离影响。本班 PICO 每人一台、教师负责投屏,所以这条压力主要落在前两节练习段的机位(40 人 / 36 机位):多出的 4 人合用机位或带自己的笔记本。
练

前两节 90′:把自己的作品练到“能演示”

不装新零件——先把第 5 次课(全景漫游器)和第 6 次课(多点漫游)的东西自己练回来,练到“能进、能退、能讲”

前两节课你们做的是全景 + 多点漫游:第 5 次课把全景图装进漫游器、加名字牌、加热点;第 6 次课把热点连成“节点 + 边”的图。 但到 10-14 结束时,全班真正能在头显里完整走一遍、还能退出来的作品并不多——多数人停在“PC 上能看”。 今天前两节不推进新内容,只做一件事:把已有作品练到“能当着别人面演示”。

为什么改成两段式(这是本次课的三个现实约束)
① 旧内容没消化:第 5、6 次课的作品是后面所有课的地基,没跑通就装新零件等于在沙上盖楼;
② 机位比人少:40 人 / 36 机位(PICO 每人一台,但前两节练习要抢 PC 机位);
③ M1 选题需要看到“能做什么”:零件库不是靠讲会的,是靠在 PICO 里看一眼才敢选。所以把“看零件”放到后两节的 PICO 演示里。

一、前两节 90′ 时间表

时段时长环节你要交的东西
0:00—0:055′开场:两段式说明 + 任务卡/练习单发放 + 今天的达标线(不讲课)—
0:05—0:105′教师投屏演示“合格线”:打开一份往届多点漫游作品,走一遍进 → 名字牌 → 2 个热点 → 退出对照自己的作品找差距
0:10—0:4535′A 段 · 复现第 5 次课:全景漫游器(全景图 / 名字牌 / 热点 / 退出路 / 通路)检查表 A(6 项打钩)
0:45—0:5510′课间(顺手把 PICO 充上电、把投屏软件打开)—
0:55—1:3035′B 段 · 复现第 6 次课:多点漫游(节点+边 / 第一眼 / 信息密度 / 性能读数 / 回退)检查表 B(6 项打钩)+ 同桌互测卡
前两节教师不讲新内容:开场的 10′ 之后,教师只巡场、只处理“作品类”问题;环境类问题交 2 名学生管理员按操作卡排查。 教师在一个座位停留不超过 3 分钟——否则 90 分钟会变成“陪 40 个人修环境”。

二、A 段 · 复现第 5 次课:全景漫游器(35′)

这一段不要求做出新东西,只要求把第 5 次课的四件事全部跑通。参看课程站第 5 次课页面与你自己的作业备份。

#检查项怎么算过(当场能演示)
A1全景图正确等距柱状全景贴在球体内表面,上下极点不撕裂、接缝不显眼;鼠标拖拽能环视一周
A2名字牌是 3D 物件名字在场景里(牌子/铭牌/立体文字都行),不是网页 div——戴进头显也能看见
A3≥2 个热点注视/点击热点能跳转或切换场景;至少 1 个热点有反馈(高亮 / 音效 / 提示字)
A4退出路三条退出路至少试通一条(注视「退出 VR」1.5 s / 长按握把 2 s / 系统键),并记下用时
A5三条通路走通一条PC 上先跑通,再按站点 https / USB+adb / 局域网白名单里的一条打开;看不到“进入 VR”按钮 = 先查安全上下文
A6控制台无报错打开 F12,主流程连走两遍,Console 没有红色报错
A 段最常见的四个坑:① 名字还是 DOM 浮层(进 VR 就没了);② 全景上下极点撕裂(投影参数 / 球体内表面朝向);③ 热点只能“看”不能“点”(射线命中没接);④ 双击 HTML 打开——file:// 不是安全上下文,永远进不了 VR。

三、B 段 · 复现第 6 次课:多点漫游(35′)

第 6 次课的核心是一张图:节点是“房间 / 视角”,边是“热点 / 通道”。这一段把这张图补全、连通、并让它好用。

#检查项怎么算过(当场能演示)
B1节点 + 边≥4 个节点、≥5 条边;每条边都真的能走通(点热点能到,不是“画在图上有”)
B2第一眼刚进作品3 秒内知道“我在哪、能去哪”:首屏提示 ≤2 个,不要一上来四面都是热点
B3信息密度每屏信息点 ≤3 个;超出的删掉或分层(先给“看什么”,再给“细节”)
B4性能读数面板上能读出 FPS 与 降级等级 L0/L1/L2,并抄进检查表(第 10 次课要用)
B5回退不迷路从任意节点能回到起点(返回热点 / 回首页按钮 / 传送回原点)
B6同桌互测同桌不听你讲解,60 秒内走完一条路并回到起点 → 打钩;做不到就记“卡在哪一步”
B 段练的不是“多做几个房间”,而是“别人能不能自己走通”。 你做的图再漂亮,同桌 60 秒走不出来,就是没通。这条口径会一直用到第 12 次课路演。

四、两段练习的检查点与交付

CP1(A 段结束,0:45)

放下鼠标,同桌互看:检查表 A 打了几个钩;没打钩的把“卡在哪一项”写清楚(环境 / 作品 / 设备)。

CP2(B 段结束,1:30)

交换座位做互测卡(B6):不讲解、让对方自己走;同时把 FPS / 降级等级抄到黑板的“性能计数区”。

当堂交付形式交到哪
检查表 A + 检查表 B练习单/任务卡上打钩,写卡点与读数下课时交(纸质或拍照)
互测卡B6 一项 + 一句“同桌作品最需要改的一处”下课时交
可演示的作品自己的 HTML(能进能退、能走完全流程)PICO 演示环节直接用;课后作业 H1 也用它
卡壳三分类(说不出卡在哪才是问题):环境(打不开 / 没进 VR 按钮 / 通路不通)→ 学生管理员;作品(报错 / 热点不生效 / 名字不见)→ 教师;设备(头显 / 手柄 / 触觉)→ 换设备,不修设备。
PICO

后两节 90′:在 PICO 上把“零件 + 你的作品”演一遍

先看老师用 PICO 演 5 个零件,再自己戴上去走作品 + 上台 60 秒演示——M1 的选题就从这里长出来

后两节的主语是学生 + PICO:本班每人一台,不再分批轮转。教师先用头显演示 5 个关键零件(投屏给全班),然后全班同时戴上—— 先走一次自己的作品,再按零件打卡表体验 4 个零件,最后挑 4 个人上台做 60 秒演示。 这不是“体验课”:上台那 60 秒就是 M1 第二栏“为什么必须 VR”的现场草稿。

一、后两节 90′ 时间表

时段时长环节谁在动手
1:30—1:355′P0 发头显:每人一台、编号登记、眼罩/擦镜布、投屏测试学生管理员 + 教师
1:35—1:5015′P1 教师 PICO 演示:5 个零件(悬停三通道 / 抓取 attach / 投掷 / 3D UI / 舒适度),投屏给全班教师
1:50—2:2535′P2 全班同时上手:每人一台 PICO——自己的作品 8′ + 零件打卡 20′ + 记录 7′学生 + 自己的 PICO
2:25—2:4520′P3 上台 60 秒演示:4 人 × 5′(演示 60″ + 互评 2′ + 切换 2′)学生(上台)
2:45—3:0015′P4 收束:达标线核对 + M1 讲解 + 作业 H1—H5 + 第 8 次课预告教师
时间账(墙钟 180′):后两节从第三节一上课(1:30)就开始——5 + 15 + 35 + 20 + 15 = 90′;前两节 0:00—1:30 也是 90′,两段严格对齐。 若教室能给到 200′(加时 20′):P2 加 10′(45′)、P3 扩成 5 人 × 5′(25′),就是“每人戴够 + 5 人上台”的加强版。

二、P1 · 教师用 PICO 演示哪 5 个零件(15′)

演示库有 9 个零件,P1 只演 5 个;其余 4 个在 P2 里每人自己打卡体验(作业 H1 再写复现记录)。每个零件只讲一句结论,讲完就切下一个。

#演示教师演什么一句话结论
1lab01 射线·悬停切“单级”模式,手一抖就触发;再切“两级”,悬停只高亮、按下才确认悬停 ≠ 确认;一次交互至少给两个通道
2lab02 抓取校准同一物体 attach 抓一次、add 抓一次,让全班看读数屏的跳变距离add 会跳、attach 不跳——物体一到手里位姿就要对
3lab03 投掷力度 0.6 / 1.15 / 2.0 各投一次,让全班看命中记录表手感 = 力度 × 平滑 × 重力,是三个可调的数字
4lab06 Diegetic UI切四种呈现;最后切到“网页浮层”再进 VR,让全班看它消失沉浸模式里 DOM 看不见;信息要长在世界里
5lab07 舒适度平滑移动 vs 瞬移各 20 秒;把隧道遮罩从 0 拉到 1晕来自视觉流;新手默认瞬移 + Snap 45°
没演的 4 个(lab04 重力 / lab05 重力手套 / lab08 Fitts / lab09 触觉手势)不是不重要(P2 里每人自己打卡 + 作业 H1 写记录),是“课后自己看”: 作业 H1 要求你任选 3 个演示写复现记录,H3 用 lab02/lab03 做参数校准,H5 把擂台玩法装进自己作品。

三、P2 · 全班同时上手(35′,每人一台 PICO)

本班 PICO 每人一台,不再分批轮转:1:50 全班同时戴上,35′ 内做三件事——先走自己的作品,再按“零件打卡表”体验 4 个零件,最后填记录。

① 自己的作品(8′)

头显浏览器打开站点地址 → 在作品墙按学号找到自己的作品 → 进 VR → 看名字牌 → 走 ≥2 个热点/节点 → 退出(记用时)。

② 零件打卡(20′)

每人至少体验 4 个零件=2 个指定 + 2 个自选;按本页「演、演示库」里的零件体验手册走三步、记两个数。

③ 记录(7′)

填观察卡 + 零件打卡表 + 把 60 秒脚本补完整;摘下后立刻写,不要空等。

指定零件怎么分(8 组 × 5 人,保证 9 个零件都有人体验)

组(按学号尾号)指定零件(必体验)自选总共
第 1—2 组lab01 悬停三通道 · lab02 抓取校准任选 2 个4 个
第 3—4 组lab03 投掷 · lab06 Diegetic UI任选 2 个4 个
第 5—6 组lab04 重力实验室 · lab05 重力手套任选 2 个4 个
第 7—8 组lab08 Fitts · lab09 触觉与手势任选 2 个4 个
观察卡(每人一张,30 秒填完)怎么填
我戴了多久 / 晕不晕(1—5)1 = 完全不晕,5 = 想摘;3 分以上下次课换瞬移/加遮罩
我卡在哪一步进不去 / 名字看不见 / 热点点不到 / 退不出 / 其他
最想改的一处一句话(这句会成为你 M1 或 H2 的素材)
FPS / 降级等级面板上抄(没有面板就写“未读到”)
单次连续佩戴 ≤20 分钟:P2 里 35 分钟连戴,中间安排一次 10 秒集体摘镜休息(约 2:10)。 面罩消毒 + 一次性眼罩是硬规矩,2 名学生管理员负责发放与擦拭。
若当天头显不足 40 台:退回“分批轮转”(2—5 台按 5′/人 × 7 轮,1 台按 3′/人 × 11 人),没戴到的第 8 次课开场补戴——本班按 1:1 排,不启用这一条。

四、P3 · 60 秒上台演示(20′,4 人)

60 秒脚本(五句话,抄在纸上带上去)
① 我是谁(5″)——姓名 + 作品名;
② 我的作品一句话(10″)——不是“一个 VR 漫游”,是“从 A 走到 B 看 C”;
③ ★ 一处只有戴上头显才能成立的体验(20″)——绕看 / 钻入 / 尺度感 / 双手协同,四选一;
④ 我用了哪几个零件、下一步加什么(15″);
⑤ 请同桌补一句(10″)。
观察员记录(每人给上台者打三个钩)判断标准
① 能进能退进得去 VR、退得出来,没有卡住
② 有一句“必须 VR”第③句成立(换成视频就说不通),不是“沉浸感好”
③ 说得清下一步知道下一件要加什么零件,而不是“再完善一下”
上台的人怎么选:优先60 秒脚本写完整的;4 人里要覆盖“全景类 / 自建场景类”两种作品。 教师现场只做一件事:把第③句里“换成视频也能说通”的当场点出来——这就是 M1 的 A/B 档判据。

五、投屏(教师负责)

P1 与 P3 都由教师投屏:PICO 投屏助手 → 教师 PC → 教室投影。课前 5 分钟实测一次,P1 和 P3 用同一个投屏链路,不临时换。

场景怎么做注意
P1 教师演示头显投到教师 PC,PC 投教室;教师边操作边讲头显投屏有 3—5 秒延迟:动作慢、边做边说
P3 学生上台提前把 4 台待上台头显编号;学生戴上后教师切到该头显投屏切换 <10 秒;学生先站定再开始说
备份头显系统录屏 60 秒 → USB 导出 → 直接播投屏失败时才用,不占课堂时间修
不要指望“全班同时看头显里的细节”:关键画面(读数屏、面板文字)用 PC 端同款页面投屏对照;头显投屏只负责“证明它真的在头显里跑”。

六、课前准备(教师负责):作品上线 + 投屏 + 名单

步做什么(教师)为什么
1收齐 40 份作品(学号_姓名.html + 必需的 three.min.js / 图片目录)课堂上不现场拷 U 盘,40 人要 20 分钟
2教师机逐个打开一遍:无报错、能进 VR把“打不开”消灭在课前
3上传到站点 assets/vr-2026/student/works/(沿用作品墙结构)头显里输网址就能开,https 天然是安全上下文
4生成“学号 → 网址”清单贴讲台(或投屏一页)学生按学号找自己的作品,不排队问
这一步由教师统一做,学生课前只交作品。P2 里学生直接“输站点地址 → 作品墙 → 找学号”,不需要逐台 adb。 若某份作品因路径 / 资源缺失打不开:课前就退回重交或现场用教师机替它截图,不在课堂上修。

七、风险与口径

① 投屏失败

用录屏导出备份;教师修 3 分钟不成就切备份,不要让全班等。

② 进不去 VR

先查安全上下文(file:// / 局域网 http 都不行),再查是否用了站点地址。

③ 作品打不开

课前已逐个验过;课上遇到直接换备用作品或看同桌的,记录卡点课后补。

作

当堂达标线(缺一条不算过)

两段式之后,达标线跟着换:练回旧作品 + 在 PICO 上演示一次,而不是“装了几个新零件”

一、三条达标线

  1. 两张检查表全绿:练习 A(全景漫游器)与 B(多点漫游)各 6 项,当场逐项演示得出来;
  2. PICO 上走通一次:自己的作品能打开、进得去、退得出来;或作为 60 秒演示者上台(二者有其一即可);
  3. 控制台无报错 + 当堂交付齐全:检查表 A/B、观察卡、互测卡、M1 六栏(当晚交)。
口径变化(必须当堂说清):前两节练旧内容、后两节做演示,“≥3 种交互可用”不再是当堂硬指标; 它移到课后作业 H2(三通道按钮) 与 H5(擂台移植)。 第 9 次课的 M3“主流程可玩”才是“≥3 种交互”的硬门槛——今天先不逼你装完,先保证“旧作品能演示”。

二、三条绝不降的底线

① 能进能退

进得去、退得出来;退不出的作品 = 没完成。

② 检查表与实物一致

打钩必须是当场演示过的;编一栏比做不出来更严重。

③ 诚实记录

观察卡“卡在哪、晕不晕”如实写;晕不是扣分项,瞒报才是。

三、当堂自测清单(下课前 3 分钟自己打钩)

#自查项打钩
1练习 A 六项全过,名字牌是 3D 的,退出路试通并记了用时□
2练习 B 六项全过:≥4 节点、≥5 条边、回退不迷路□
3同桌不听讲解 60 秒内走通我的作品(B6 打钩)□
4我的作品在 PICO 上打开过(或已排进第 8 次课补戴名单)□
5我能说出我的 FPS / 降级等级读数(或“未读到”)□
6观察卡填完(时长 / 晕感 1—5 / 卡点 / 最想改的一处)□
7我写了 60 秒脚本(哪怕没上台)□
8我知道 M1 六栏怎么填,今晚能交□
9我知道作业 H1—H5 要交什么、10-27 23:59 截止□
10我知道没装的零件(三通道 / 擂台)在课后 H2 / H5 里补□

四、时间不够时怎么砍(新的降级优先级)

优先级保什么砍什么
1(绝不砍)每人至少在 PICO 上打开一次自己的作品(进 + 退)——
2(绝不砍)练习 B 的 B1(节点边)+ B6(同桌互测)——
3P3 上台演示 3 人(15′)5 人版 → 3 人;互评改成“举手表决哪句必须 VR”
4练习 A 的 A4 退出路 + A5 通路A1/A2/A3 的细节打磨移到课后
5教师 P1 演示 3 个零件(lab01/02/03)lab06/lab07 改成课后看演示库
6M1 当堂讲清六栏视频/图示区 → 全部改成课后自学
一句话原则:宁可少讲一个零件,也要让每个人在 PICO 里走完自己作品的主流程、并且退得出来。 这节课的产出是“一个能演示的旧作品 + 一份敢交的 M1”,不是“装了几个新功能”。
业

课后作业:H1—H8(10-27 23:59 截止)

课上时间被两段式占满(练旧 + 演示),装新零件全部在课后:把 P1 看到的零件,装进你自己的作品

今天课上只做了两件事:把旧作品练到能演示、在 PICO 里看了一遍零件。要把零件变成你自己的,得课后动手。 作业分三层:必做 H1—H5(约 2—2.5 小时)、选做 H6—H7(约 40 分钟)、挑战 H8(约 1 小时)。 必做项全交 = 课堂作业分的基本盘;选做与挑战 = 加分,加分上限 +5。
当堂交付(H0,不算课后作业):练习 A/B 两张检查表、观察卡、互测卡、60 秒脚本——下课交。

编号层次作业预计交付物喂给哪个里程碑
H0当堂两张练习检查表 + 观察卡 + 互测卡 + 60 秒脚本课上纸质 / 拍照M1 现场素材
H1必做演示复现记录:任选 3 个演示跑通并填表20′三行记录表M1“技术点”素材
H2必做把“三通道按钮”装进你自己的作品30′改后的 HTML + 录屏 + 代码位置说明M1 核心交互第 1 项
H3必做参数校准小报告(抓取 / 力度 / 平滑三组数据)30′三行数据表 + 选定参数 + 一句结论第 10 次课性能思维的起点
H4必做M1 选题一页纸(六栏)30′一页纸 PDF / 图片M1(当晚交,见下一节)
H5必做·二选一① 把 demo01 擂台玩法移植进自己作品;② 做一个 diegetic 化改造40′可玩的 HTML + 30 秒录屏M1“核心交互”的最佳原型
H6选做可访问性:单手通关 + 注视停留点自己的面板20′一句结论 + 缺哪一步的原因M1“降级方案”素材
H7选做视频对照笔记:看 2 个资源,各写 100 字“哪个零件课上做过”20′两段短笔记第 8 次课状态机讨论
H8挑战新增一个零件:双手协同 / pinch / 触觉语义扩展(三选一)60′20 行说明 + 可演示 HTMLM1 加分项;第 9 次课(M2/M3)的输入基础
H0 · 当堂 · 下课交课堂交付
两张检查表 + 观察卡 + 互测卡 + 60 秒脚本
练习 A(全景漫游器 6 项)、练习 B(多点漫游 6 项)逐项打钩;观察卡写戴了多久 / 晕感 1—5 / 卡在哪 / 最想改的一处;互测卡由同桌填(不听讲解 60 秒内走通);60 秒脚本五句话写好。
验收:每项都是当场演示过才打钩;卡点写清"环境 / 作品 / 设备";FPS / 降级读数抄上(没读到写"未读到")。
H1 · 必做 · 20′记录类
演示复现记录:3 个演示 + 3 行表
从演示库里任选 3 个(建议 lab01 悬停、lab02 抓取、lab03 投掷),逐一打开并完成一次核心操作,填三列表:
操作(我做了什么)→ 反馈(看到 / 听到 / 感觉到什么)→ 对应零件(射线 / 抓取 / 投掷……)。
每个演示再写一句:“如果我是设计师,我会改什么?”
验收:3 行齐全;每行都能在演示里复现;有一句是自己的判断,不是抄 HUD。
H2 · 必做 · 30′动手类
把一个按钮做成“三通道”
打开你自己的作品,挑一个按钮,补齐:悬停高亮(视)+ 合成短音(听)+ pulse(0.2, 30)(触);确认时换档到 pulse(0.5, 60) + 另一种音。
不引任何音频文件(守住零依赖硬门槛),用 AudioContext 合成;进入 VR 的用户手势里 ctx.resume()。
交付:改后的 HTML + ≤20 秒录屏 + 一行“改在哪个函数/哪一行”。
验收:射线扫过与按下两档反馈可区分;VR 里也响。
H3 · 必做 · 30′数据类
参数校准小报告:让“手感”变成数字
在 lab02 / lab03 上各做一组对照:
① 抓取距离 0.20 / 0.35 / 0.80 m,各抓 5 次,记成功次数与“自然 / 别扭”;
② 投掷力度 0.6 / 1.15 / 2.0,各投 5 次记命中数;
③ 平滑系数 0.05 / 0.35,各投 3 次记落点离散程度。
最后写:我选定的参数 = __,因为 __。
验收:三行数据真实(能复现);有选定值;有一句结论而不是只贴表格。
H4 · 必做 · 30′M1
M1 选题一页纸(六栏,当晚交)
主题 / 为什么必须 VR / 目标用户 / 核心交互(≥3,写“触发→发生什么→看到什么反馈”)/ 技术点 / 跑不动时的降级方案。
完整要求与 A/B 档判据见 四、里程碑 M1,示范对照见 范、示范案例。
截止:2026-10-21 当晚 23:59(不补交,后面五项里程碑都建立在它上面)。
H5 · 必做(二选一)· 40′作品类
把“可评估的小玩法”装进自己作品
① 擂台移植:把 demo01 的玩法搬进你自己作品——换主题、换规则都行,但计分 + 两通道以上命中反馈 + 重置三件不能少;
② Diegetic 改造:把作品里的计分板/提示做成“世界里的东西”(靶上刻度、墙上告示、手里拉杆),拍照对比前后。
二选一即可,做两个最多按一个加分。
验收:能连续玩两局不报错;评分板在3D 里而不是 DOM 里;重置真的能把分数/球复位。
H6 · 选做 · 20′可访问性
单手 + 注视:缺哪一步?
切到仅左手(或你作品的单手方案)把 H5 的玩法完整玩一局;再开注视停留,试试点到自己面板的按钮。
写一句结论:“能玩 / 缺__这一步”,并说明缺的原因(是输入通道不够,还是判定没接上)。
这是第 9 次课“可访问性硬门槛”的预演;如实写“缺”比硬说“能”得分高。
H7 · 选做 · 20′阅读类
视频对照笔记
从 视、视频与图示 里挑 2 个(建议:Alyx 团队谈移动方式 + 菲茨定律),各写 100 字:
“这个视频里讲的,我们课上哪个零件做过?我们做的和它差在哪?”
验收:两段各 ≥100 字,必须点名具体零件(射线/抓取/传送/触觉……),不能写“很有收获”。
H8 · 挑战 · 60′加分区
新增一个课上没讲透的零件
三选一:① 双手协同(弓箭式:一只手稳定、一只手拉,松手时机决定结果);② 手势 pinch(手部追踪可用则真机,不可用则键盘模拟);③ 触觉语义扩展(设计一套 5 种事件的强度/时长编码并写理由)。
交付 20 行说明 + 可演示 HTML。
要求:说明里必须写“为什么这个零件值得装进我的作品”;只堆代码不写理由不加分。
附:改码入口(H2 / H3 / H5 在演示库上改时用)——点开看表
想改什么打开哪个演示找哪里
三通道反馈lab01-ray-hover.htmlDEMO.onPick() 里的 beep() / pulse()
抓取距离 / attach-addlab02-grab-attach.htmlS.maxDist、parent.attach(obj) 那一行
投掷力度 / 平滑 / 重力lab03-throw-physics.htmlS.power、S.smooth、S.gravity
重力三档 / 弹性lab04-gravity-lab.htmlS.gravity、S.restitution
拉取弧线 / 接住窗口lab05-force-pull.htmlCATCH_WINDOW、贝塞尔控制点
四种 UI 放法lab06-diegetic-ui.htmlsetMode() 四个分支
移动方式 / 遮罩lab07-comfort-locomotion.htmlS.move、S.vignette
目标距离 / 面板高度lab08-fitts-goldilocks.htmltrial(A,W)、S.panelHeight
触觉强度 / pinchlab09-haptics-hand.htmlHAP 强度表、onPinch()
计分 / 计时 / 状态机demo01-basketball.htmlS.phase、shoot()、tick()

一、提交规范(命名错 = 找不到 = 按未交处理)

项要求
文件命名2308120XX_姓名_H2.html;录屏 2308120XX_姓名_H2_录屏.mp4(≤30 MB、≤20 秒)
打包2308120XX_姓名_第7次课作业.zip,内含 H1 记录表 + H2—H5 文件 + H6/H8(做了才放)
提交渠道微信发给教师(文件与压缩包按上面的命名规则;M1 当晚发,其余 10-27 23:59 前发)
截止2026-10-27(周二)23:59;M1 单独提前到 10-21 当晚 23:59
迟交24 小时内按 80% 计;超过 24 小时不收。M1 不适用迟交条款(它是后面五项的前置条件)
诚实条款截图/录屏必须自己跑出来的;引用他人代码注明出处;伪造记录按 0 分,且计入过程性评价

二、评分量规(每项 5 分制,必做 5 项共 25 分,折算课堂作业分)

维度A 档(5 分)B 档(3—4 分)C 档(1—2 分)
完成度要求项全做到,且能当场复现主体做到,缺一项只交了截图/文字,跑不起来
反馈质量三通道齐全、强度有语义(悬停/确认/命中不同档)两通道,或三通道但强度不分档只有视觉变化
可复现PC 和 VR 两端都能完成主流程,控制台无报错只有一端能完成两端都不稳
记录诚实与依据数据真实可复现,写清“改了哪个变量、为什么”有记录但缺依据记录与实物不一致 / 编造
三条扣分红线:① 伪造截图或数据(0 分);② 《交互清单》与实物不一致(该项 0 分);③ 直接提交课内案例 01—06 原文件(按抄袭处理,记入过程性评价)。

三、交之前自查(10 项,全部打钩再交)

#自查项打钩
1H1 三行记录表填完,每行写清操作 → 反馈 → 零件□
2H2 的三通道按钮在进入 VR 后也能响(录屏里有证据)□
3H3 三组数据有对照、有选定值、有一句结论□
4H4(M1)六栏没有空格子,已交□
5H5 的计分板在 3D 里,重置能真复位□
6我的作品 PC 端能走完主流程(不用头显也能演示)□
7控制台没有红色报错;主流程连走两遍不报错□
8文件命名、压缩包命名符合规范□
9引用了别人的代码/素材,已注明出处□
10我知道下次课(10-28)要带什么:M1 + 本作业 + 可玩的作品□
作业与期末的关系说清楚:H2、H3、H5 三件,如果你按“最终要放进大作业”的标准做,它们会直接变成 M2 / M3(第 9 次课起)的素材。 反过来,应付式交的作业,到第 9 次课“主流程可玩”那道硬门槛时,还得重做一遍。
范

示范案例:一个“能评分的小玩法”长什么样

两个可直接打开的标准答案:投篮擂台(作品示范)与作业样板(交付示范)

“把零件攒成一个作品”这句话太抽象。所以给两个可以直接玩、也可以直接拆的示范: 一个告诉你“完整的小玩法”是什么样,一个告诉你“合格的作业交付”是什么样。 先玩、再拆、再改——不要从零开始想。

示范作品:投篮擂台 截图
示范作品 · 投篮擂台(demo01)
罚球线 → 抓球 → 投进筐 → 计分板 +2、筐闪、音效、震动;60 秒限时、最高分持久化、ready / playing / over 三阶段状态机。
打开玩一局 →
作业示范:三项交互样板 截图
作业样板 · 三项交互 + 自动清单(demo02)
房间里 3 项交互(面板改灯光 / 抓台灯归位 / 投球入篮计数),PC 端侧栏自动生成《交互清单》与三条达标线自检;按 A 看 ①②③ 注释。
打开看样板 →

一、拆解:什么叫“可评估的小玩法”

示范作品(demo01)的统一要求只有三条,但每条都在回答一个设计问题——为什么这个玩法能被“评分”而不是“只能看”:

要求示范里怎么做的它解决了什么问题
① 目标 + 计分显示在 3D 里计分板是场景里的一块 CanvasTexture 面板,分数/时间/最高分三行玩家不用退出沉浸就知道自己做得怎么样;这也是第 8 次课“状态→UI 同步”的伏笔
② 命中给两通道以上反馈筐闪(视)+ 上扬音效(听)+ pulse(0.8, 90)(触)“差一点”和“进了”必须一眼一听就能区分,否则玩家学不会调整力度
③ 有重置按钮面板上的“重置”把球、分数、计时、阶段一起复位球一定会飞出场地。没有重置,演示 30 秒就卡死——这是擂台类玩法排行第一的翻车点
+ 阶段状态机ready → playing → over,UI 与提示音随阶段变,over 锁输入“开始前不计分、结束后不能刷分”——这是第 8 次课状态机的最小原型,今天先用起来
示范案例怎么用(三步):
① 先玩:完整打一局,感受“什么时候想再来一次”;
② 再拆:打开源码找四个东西——计分变量在哪、命中判定在哪、三通道反馈在哪、重置函数在哪;
③ 再改:换主题(投篮→投壶/投币)、换规则(+2/+1 改连击)、换反馈(换音色/换震动强度),改三处就算你的作品。

二、作业样板:一份合格交付长什么样

①《交互清单》自动生成

侧栏表格逐项列:交互名 / 触发 / 反馈 / PC 可达 / VR 可达 / 备注。学生在页面里就能看到自己“编没编”。

② 三条达标线自检

能进能退 ✔ · ≥3 种交互可用 ✔ · 控制台无报错 ✔(用 window.onerror 实时计数,报错就变红)。

③ 注释模式

按 A 在场景里打出 ①②③ 标注并高亮对应物体——拍录像时观众一眼能看懂你改了什么。

样板不是让你照抄代码,而是让你照抄“交付结构”:一个能跑的文件 + 一张清单 + 三条自检。第 9 次课验收、第 12 次课路演,用的都是同一套结构。

三、M1 示范:A 档和 B 档差在哪

栏位A 档写法(能拿满分)B 档写法(换段视频也能说通)
主题“故宫角楼·脊兽辨认训练:走近看清每只脊兽的朝向与数目”“一个 VR 故宫漫游体验”
为什么必须 VR“脊兽在高处屋檐上,必须仰头绕看 + 走近才能看清排列;平面照片看不出前后遮挡与相对高度”“沉浸感更好、更真实、更有代入感”
核心交互“① 射线点脊兽 → 高亮并显示名称;② 传送靠近屋檐 → 视角变化;③ 抓取放大镜 → 看清纹样”“点击查看信息,可以漫游”
技术点射线 + 传送 + 3D 面板 + 距离判定 + 状态计数“VR、3D、交互”
降级方案“做不完就砍放大镜,保留‘点选 + 名称’;再不够就把近景改成固定机位 3 个”“尽量做完”
判别一句话:把“为什么必须 VR”那一栏换成一段视频,如果照样成立,这一栏就白写了。 A 档的答案里一定有“绕看 / 钻入 / 尺度感 / 双手协同”这四类体验之一,而且是动作,不是形容词。
常见扣分点(按出现频率排):① 核心交互写成“点击查看”(不是 VR 交互);② 降级方案写“尽量做完”(等于没有);③ 选题超出 8 周(多人在线 / 手势识别训练 / 云 VR);④ 交互列了 10 项但只会 2 项——M1 写 10 项的,多半做不完;⑤ 六栏里有一栏空着。
四

里程碑 M1 · 选题一页纸(今晚交)

六栏一页纸,一栏都不能空;没有选题就没有后面五项里程碑

“为什么把 M1 放在第 7 次课而不是更早”——因为学生此刻才第一次在 PICO 里看到“可交互的零件库”,此时定选题,才不会写出自己做不到的方案。

写 M1 之前,先回忆 P1—P3 的三件事:① P1 里老师演的 5 个零件,哪一个让你觉得“我的作品也能用”;② P2 戴着自己作品时最想改的一处;③ P3 听到的 3 个 60 秒演示里,哪一句“只有 VR 才能成立”。这三件事就是六栏的素材。
#栏位怎么算写好了
①主题一句话,不要写“VR 体验”这种空话
②为什么这件事必须用 VR★ 必须写出一处只有 6DoF / 立体视觉才能成立的体验;可选四类:绕看 · 钻入 · 尺度感 · 双手协同。★ 如果这句话换成一段视频也能说通,就不算数
③目标用户谁、在什么情况下用
④核心交互≥3 项,写清“触发 → 发生什么 → 看到什么反馈”
⑤技术点要用到哪些:抓取 / 传送 / 3D UI / 状态机 / 音频 …
⑥跑不动时的降级方案★ 必须写:砍什么、留什么

一、M1 的分档(当晚交)

档判据
A六栏齐全;“为什么必须 VR”写出了一处非 6DoF / 立体视觉不可的体验;降级方案具体到“砍哪个功能、留什么”
B六栏齐全;“为什么必须 VR”写的是“沉浸感好”“更真实”这类换到视频也能说通的话
C缺栏,或选题明显超出 8 周能做完的范围(如多人在线、手势识别训练)
C 档不扣分,但要当堂或课后谈一次。第 8 次课的开场 15 分钟就是 M1 点评,届时从 A 档里挑 3 份讲“好选题长什么样”。

二、两条提醒

① 优先“长出来”,不要“重做”

优先在你自己前几次课做的全景 / 3D 作品上长出一个可交互段落——这是风险最低的路径,也是“复用而非重做”。

② 本学期做不完的方向

高精度手语 / 手势识别 · 多人在线 VR · 云 VR / 串流优化 · 真实医学影像管线 · 依赖眼动或面部追踪 · 纯全景漫游(没有交互)。

涉及校史、文物、机构等真实信息,不确定的一律写 【待补充:…】,不要编造。 这条从今天起适用于所有交付物,第 12 次课验收会看这一项。
两个必须能回答的问题(今晚填之前先想清楚): ① 我的选题,哪一处体验只有戴上头显才能成立?② 如果帧率撑不住、时间也不够,我先砍哪一块,保留哪一块?
视

视频与图示:课上没时间讲的原理,在这补

10 条外部视频/图文(已逐条核验标题与内容相关) + 6 个官方文档入口 + 4 张本课图示

课堂不联网:下列外链用于课后自学与H7 视频笔记;课上要放的话请课前缓存或下载。 链接全部指向公开页面(B 站 / three.js 官方 / W3C / MDN),不是我能保证永久有效的资源,打不开就按标题搜同款。

一、概念对照(按本课模块排)

知识点资源对应本课怎么看
WebXR 是什么《WebXR 教学 01 基础介绍》B 站 · 系列教程第 1 集开场 / 三条通路课前预习:建立“浏览器即平台”的概念
空间应用交互与设计(UI & UX)《PICO OS 6 开发者系列 02:空间应用交互与设计详解》B 站 · 官方开发者系列模块 A1/A4 · lab01 / lab06对照我们的“三通道反馈”与四类 UI,看工业界怎么表述
Fitts 定律《交互心理学·交互七大定律之一:菲茨定律》B 站模块 A3 · lab08看完再玩 lab08,把“为什么远距离用射线”自己推一遍
晕动症 / 动态视场角《VR 动态视场角——解决晕动症的终极方案?》B 站 · 作者自述亲历晕动症模块 C1 · lab07重点看“减少视场角”的思路,和 lab07 的隧道遮罩对照
移动方式的设计取舍《半条命 Alyx 幕后团队深度谈论玩家的移动方式(中字)》B 站 · 官方访谈中字模块 C1/C2 · lab07听他们为什么同时保留瞬移与平滑;这是“给选项”的经典案例
Alyx 的交互细节同上(访谈) + 图文《VR 眩晕的原因与解决方法》模块 B1 · lab05先看访谈里“重力手套”段落,再回 lab05 对比三段式
触觉反馈《VR 开发核心基础 39:震动反馈——应用于任何 Interactor》B 站 · 引擎向实操模块 D1 · lab09看参数怎么调;我们讲的是“强度分级语义”,不是引擎差异
控制器输入《VR 开发核心基础 07:控制接收——捕捉控制器输入》B 站输入基础 · lab01 / lab02对照案例 01 的 selectstart / squeezestart 事件
手部追踪《[教程] Quest 开发:多模态同时使用手追和手柄》B 站模块 D2 · lab09看“手追 + 手柄”并存时的切换逻辑;我们只做 pinch 确认
“少而准”的交互图文《节奏光剑测评:最好的 VR 音游》模块 B2 · 防 M1 贪多只看它怎么用“挥砍 + 节拍”两件事撑起整个游戏
视频不是“看完就算”:H7 要求你从上面挑 2 个,各写 100 字“我们课上哪个零件做过、差在哪”。 看视频的正确姿势是对照自己手上的东西,不是收藏夹 +1。

二、官方文档与示例(“抄作业地图”,课后按需查)

入口是什么什么时候用
three.js 官方 WebXR 示例总览webxr_vr_* 系列:sandbox / dragging / teleport / handinput / rollercoaster …想抄哪个零件就搜哪个文件名(模块 D3 的“抄作业地图”)
webxr_vr_sandbox射线 + UI + 传送 + 抓取的综合沙盒我们 lab01—lab04 的“官方同款”
Immersive Web 官方示例集W3C Immersive Web 工作组维护的 WebXR 样例(含手部追踪、命中测试)查“这个 API 官方怎么用”
MDN · WebXR Device API最可靠的中文/英文 API 文档查 requestSession、referenceSpace、inputSources
W3C · WebXR Gamepads Module手柄按钮、轴、hapticActuators.pulse() 的规范口径写触觉前对照一遍,别只信博客
B 站检索:VR 抓取 投掷没有单一权威教程时的检索入口按标题挑播放量高、有工程细节的看

三、本课图示(四张图看懂四个结论)

三通道反馈示意图
图 1 · 三通道反馈
一次有效交互 = 视觉 + 听觉 + 触觉至少两个通道;对应 lab01 与课后 H2。
Fitts 定律与舒适区示意图
图 2 · Fitts 定律与 Goldilocks 区
近处用手、远处用线;面板放胸口到眼高之间。对应 lab08。
晕动症与隧道视野示意图
图 3 · 晕动症与隧道视野
眼动身不动 → 冲突;少动、慢动、挡周边。对应 lab07。
Diegetic UI 四分类示意图
图 4 · Diegetic UI 四分类
世界内 / 空间 / 跟随头部 / 网页浮层(进 VR 消失)。对应 lab06。
查

配套资料、待确认项与教师检查表

凡不确定的事实一律保留标注,不编造、也不为了页面好看删掉

一、配套链接

资料是什么在哪
演示中心(九宫格)9 个零件演示的索引页,按 P1 演示顺序排;PICO 演示和作业 H1 从这里点开最快打开演示中心
示范案例 · 投篮擂台H5 的标准答案:计分板 + 三通道反馈 + 重置 + 三阶段状态机打开示范作品
示范案例 · 作业样板3 项交互 + 自动《交互清单》+ 三条达标线自检 + 注释模式打开作业样板
案例 01 · VR 交互沙盒9 项交互范式的“大沙盒”;单文件 + three.min.js 必须同目录打开案例 01
期末大作业任务书个人 WebXR 作品、占 40%、十条硬门槛、评分量规、六个里程碑打开任务书
大作业论文模板(docx)封面 + 字号字体/段落格式要求 + 五节报告结构(实验目的 / 内容 / 过程 / 结果分析 / 心得);12-02 前按它交文档下载模板(384 KB)
课堂作业墙上一次课全班已交作品的对照清单assets/vr-2026/student/works/
6 个演示案例总览6 个演示案例的索引页打开演示案例索引

二、案例 01 的数字口径(两套如实并存)

指标README 值审计值怎么用
Draw calls4950两套数字略有差异,一律说“README 报 49、审计报 50,基本一致”,不取整、不合并
三角面2.3k2348 tris同上
风险 2:性能数字 ≠ 帧率。案例 01 的渲染规模很小,在任何头显上都不构成压力,所以不要把它当“性能很好”的证据。 DrawCall / 三角面只是渲染规模指标,真机瓶颈常在填充率与纹理带宽;真机要看的是内核面板上的 FPS 与降级等级(L0/L1/L2)。 今天不用这两个数做任何结论——那是第 10 次课的内容。

三、本页内容里需要教师确认的项

项现状
头显与数量已定:PICO 每人一台(40 台),P2 全班同时上手;现场按机器发放,不需要登记型号
上课场地【待确认:本次课是否固定在一个教室,还是沿用“前两节理论 + 后两节上机”的换场安排】
课堂选定走通的通路【待确认:由教师课前实测后当堂宣布】——三条都演示,只教走通的那一条
期末大作业任务书页面已发布(vr-2026-final-project.html);任务书内容与课次里程碑口径一致
手柄握持键与触觉案例 README 与演示库都未在真机验证握持键 / 触觉 / 手部追踪;课前需实测 5 分钟,无响应则改用扳机抓取并告知全班
PICO 数量已定:每人一台(40 台),P2 全班同时上手,不需要轮转;型号不用登记,现场按机器发
投屏方式教师负责投屏(PICO 投屏助手 → PC → 教室);课前 5 分钟实测一次,备份用头显录屏导出
学生作品是否统一上线【待确认:是否收齐 40 份作品并部署到 assets/vr-2026/student/works/】——这是 P2 能不能"输网址就打开"的前提
两段式时间表用哪一版【待确认:标准版 180′(前两节 90 + 后两节 90,含课间 10′)还是加强版 200′】——标准版可直接用;加强版把 P2 加 10′、P3 扩成 5 人,需提前申请 20′
示范作品用哪个玩法【待确认:课前实测投篮筐碰撞判定是否稳】——建议投篮;不稳则换 demo02 的“投球入篮”(碰撞判定最简单)
作业提交渠道已定:微信发给教师(按提交规范的命名打包;M1 当晚发)
校史 / 文物 / 机构等真实信息M1 与后续交付物中一律标 【待补充:…】,不得编造

四、课前 10 分钟检查表(教师)

五、下课前一定要知道的七句话

① 沉浸模式下 DOM 看不见

你的界面必须是 3D 物件(名字也一样)。

② 72 Hz 的帧预算是 13.9 ms

不是 16.7 ms。面板上要认出 FPS 与降级等级 L0 / L1 / L2。

③ 注视停留只能点 3D 面板

场景实体(球、方块)仍然需要手柄——这条边界就是第 9 次课要讨论的问题。

④ 先怀疑环境,再怀疑代码

file:// 不是安全上下文,看不到“进入 VR”按钮——那通常不是你的代码坏了。

⑤ 没有反馈的交互等于没有交互

一次有效交互 = 视 / 听 / 触至少两个通道;悬停与确认强度要分档(0.2 / 0.5 / 0.8)。

⑥ 状态只有一个 S

改一处,画面 / 手感 / 面板读数同时变——这是第 8 次课状态机的起点。

⑦ 先能演,再谈装新

旧作品进不去、退不出,装十个零件也没用。今天的达标是"能演示",不是"功能多"。

下

下一课 · 第 8 次课(2026-10-28)

从“能做的事”到“能装成系统、能进资产”:交互进阶 + 开源 3D 模型管线(先做后讲)

第 8 次课是两段式:第 1—2 节(90′)在 646 机房学生自主做课堂作业,教师只做开场 5′ 与巡场,不讲课;第 3—4 节(90′)到 430 教室戴 VR 头显讲课,学生以看为主、少量体验。旧口径的“动线与状态机(M2)”不再在第 8 次课交,M2 并入第 9 次课,最终口径待教师确认。
上次课(10-14)本次课(10-21)下次课(10-28)
一句话从“一个房间”到“一条路”从“一条路”到“能演示的作品”从“零件”到“系统”,从“网上的模型”到“能用的资产”
核心对象一张图(节点 + 边)一套零件(射线 / 抓取 / 投掷 / 3D UI / 移动 / 悬停 / 触觉 / 拉取 / 转向)一台状态机(idle → hover → grab → snap)+ 一条资产管线(下载 → 转换 → 导入 → 操作 → 场景 JSON + 许可卡)
学生产出多点漫游作品 + 验收记录两张练习检查表 + 观察卡 + PICO 上一次完整演示 + M1 选题一页纸 + H1—H5 作业课堂作业 3(一页版):A 交互验证(01 五项操作与状态机记录)+ B 模型管线(03 转换 → 02 导入操作 → 场景 JSON + 许可卡)(M2 并入第 9 次课,待教师确认)
今晚要交的事只有一件:M1 选题一页纸,六栏。 交之前自己再问一遍——“为什么这件事必须用 VR”这一栏,写的是不是一句换成视频也能说通的话?