虚拟现实技术 · 第 9 次课 · 实现与验证

路要通、退得出、谁都点得到

第 9 次课 · 演示案例 02「密室逃脱 · 敦煌寻宝」(二)——上周(10-28)交的是课堂作业 3(交互验证 + 模型管线 + 许可卡,一页版);M2 动线图/状态机图并入本课、口径待教师确认;这一周要证明作品真的能用,而且不是你能用,是一个陌生人戴上头显也能用

中华女子学院4 学时 · 180 分钟授课人:孙琪翔2026-11-11(周三)数字媒体技术 2023 级 · 40 人
导

本课导览

上一课证明"有没有目标";这一课证明"目标能不能被点得到、能不能被退得出来"

本页已并入第 9 次课专题页(2026-11-11):第 9 次课以「Agent 通过 MCP 指挥 Blender 建模」为主线(前两节课堂练习、后两节讲授),本页的交互实现与可访问性内容已并入该专题页作为附录;本页保留全文,供查阅与回看。

上周(10-28)交的是课堂作业 3:交互验证 + 模型管线 + 许可卡(一页版)。旧口径的 M2(动线图 + 状态机图 + 可玩入口)并入本课,最终交付口径待教师确认。这一周要证明的是"它真的能用"——而且不是"你能用",是一个不熟悉你作品的人,戴上头显也能用。

本课命题:交互的难点不在"能不能点",在"点不到时怎么办"。
今天的产出 = 三样东西:① 主流程可玩(入口 → 通关,能连走两遍、控制台无报错);② 一条"免手柄也能走完"的通路说明(含它覆盖不到哪一步);③ 真机验证记录(用时 / 卡点 / 退出路,三样缺一不可)。

一、五个问题,前四个在电脑上就能做完

#问题一句话判据本页在哪
①抓得住吗手伸到多近才抓得住?太远抓不到,太近会误抓一、抓得住吗
②放得对吗松手那一刻凭什么判断"这是放对了"?距离阈值 + 吸附槽二、放得对吗
③顺序对不对不按设计的顺序做会怎样?报错之后还能不能接着玩四、顺序与失败代价
④点得到吗不用手柄的人能不能走完整个流程?走到哪一步就走不动了五、谁都点得到
⑤退得出去吗玩完了怎么退出?退不出去的作品,是最严重的可用性事故真机验证

这节课最难的不是写代码,是"替别人试":你要站在一个没有手柄、坐着的、只用一只手的用户的位置上,把自己的作品从头走一遍。

二、180 分钟怎么分(逐段相加已核对)

时段时长段内容产出
0:00—0:1010′① 开场课堂作业 3(一页版)点评 + 卡点统计;M2 动线图/状态机图并入本课(口径待确认)(只讲优点;问题一律说"有同学的作品")"做的时候才发现想不清楚"的问题清单
0:10—0:5545′② 讲授抓取 / 放置 / 顺序校验 + 谜题与失败代价设计(★ 四处现场改码)五条实现口径
0:55—1:0510′③ 课间——(若本次课需换场,这 10′ 就是换场时间)——
1:05—1:4035′④ 讲授+实操人因与可访问性三件套(Shift+P / Shift+H / Shift+G)+ 边界讨论每人当堂按过一次三件套
1:40—2:4565′⑤ 工作室 + 真机验证打通主流程 + 补免手柄通路 + 戴头显走完整流程并抄用时主流程可玩 + 免手柄通路 + 真机记录
2:45—3:0015′⑥ 收束三条退出路当场报用时 + M3 提交要求退出用时进全班统计
核对行:10 + 45 + 10 + 35 + 65 + 15 = 180 分钟;教学时长 = 180 − 10(课间)= 170 分钟。
⚠️ 第 6 次课的教训:第一版方案按 110 分钟排而实际只有 90 分钟,超了 30 分钟。本表已逐段相加核对过。

三、设备与场地:一律 【待确认】

头显型号、数量、上课地点与是否换场,教师尚未确认,所以本页一律写 【待确认】,并同时给出两套组织预案:
· 预案 A · 一人一台(头显数量 ≥ 人数):40 人同时上机,不轮转,教师 + 2 名学生管理员巡场;
· 预案 B · 10 台轮转(头显数量 ≈ 10):5 人一组 × 8 组,每组 8 分钟,一组戴头显时其余人在电脑上做任务 1 / 任务 2。
两套预案的共同底线(不降):每个人都要在头显里走完自己作品的主流程,并至少试通一条退出路。上课前一天必须确认,不要临场决定。

本课次涉及的真实信息只在两处出现,均按占位处理,不引用任何具体洞窟编号或文物流转信息:
· 案例场景里的敦煌壁画名称、洞窟编号、藏经洞史实 → 【待补充:壁画与洞窟信息以敦煌研究院公开资料为准】;
· 若学生 M3 作品涉及校史题材,中华女子学院校史节点 → 【待补充:校史信息以学校官方公开资料为准】。

案例与 three.min.js、_xr_core.js 同目录,离线可跑;三件套快捷键由共享 XR 工程内核提供,不是案例自己写的。

一

抓得住吗:attach() 与"最近的那一个"

演示案例 02 的抓取规则:0.45 m 内,挑最近的那一块碎片——"最近"是规则,不是"我想要"

抓取这个动作,很多人以为是一大段代码。其实就是一行 attach。真正需要你决定的只有一件事:手伸到多近,才算抓得住?

一、抓取的动作与触发器

var best = null, bd = 0.45;          // ← 抓取距离
for (每块碎片 o) {
  var d = 控制器 到 o 的距离;
  if (d < bd && !o.placed) { bd = d; best = o; }   // 越近越优先
}
if (best) grab(best, c);
实现口径 1:抓取 = 就近取最近的一个,不是一个范围。所以两块碎片叠在一起时,你抓到的可能不是你想抓的那块——"最近"是规则,不是"我想要"。

二、★ 现场改 bd(3 分钟)

改成现象用户的感受
0.15抓不到——手就在碎片上,按握持键没反应"这游戏坏了"
1.5隔着半间房,碎片自己飞过来"这也太简单了"
太小抓不到,太大乱抓。这个数不是你"想"出来的,是你"调"出来的。演示案例 02 选 0.45,是它的选择,不是标准答案。
二

放得对吗:放置判定 = 距离阈值 + 吸附槽

松手(squeezeend)调 release(obj);它里面没有"放错了"这个分支,只有一件事:量一下距离

var p  = obj.getWorldPosition();         // 碎片当前在哪
var fp = muralFrame.getWorldPosition();  // 壁画框在哪
if (p.distanceTo(fp) < 1.6 && !f.placed) {
    // 吸附到对应凹槽
    var slotX = -0.95 + f.idx * 0.95;
    obj.position.set(fp.x + slotX, fp.y, fp.z + 0.16);
    placeFragment(f);
}

两个数决定了一切:1.6 m 是"算不算放到框上"的阈值;slotX 是"吸到哪个槽"。

一、★ 现场改 1.6(3 分钟)

改成现象一句话
0.5太远放不进——明明站在框前面,松手还是掉地上阈值是"手感",不是"正确值";你要为你的场景调一个数
4.0太近误触发——在门口一松手,碎片自己飞过去吸上

二、吸附槽:为什么"放对了"还要再看一次代码

演示案例 02 的槽位是按碎片索引固定的:slotX = -0.95 + f.idx * 0.95——第 0 块 → −0.95,第 1 块 → 0,第 2 块 → 0.95。也就是说:无论你先捡到哪一块,它都只会去自己固定的那个位置。

写法 ① · 按索引固定(演示案例 02)

好处是不会抢位置;代价是顺序感弱——你随便捡哪块都行,顺序不对也能拼对。

写法 ② · 自动找最近的空槽

听起来更聪明,但你要多想一件事:两块碎片同时靠近同一个空槽的时候,谁赢?(这是演示案例 02 布置的作业方向)

实现口径 2 与 3:放置判定 = 距离阈值,不是一个"放对了"的 flag;只要落在阈值内,就自动吸到槽位。两种写法都对,但你得知道你选了哪一种,以及代价是什么。

⚑ 要让学生自己看出来的一件事:release() 里没有"放错了"这个分支——阈值内就吸附,阈值外就掉在原地。"放错"这件事在你的作品里到底发生了没有?

三

点得到吗:UV 命中 3D 密码键盘

进了沉浸模式,网页的 DOM 面板不渲染——你在 HTML 里写的 <button> 在头显里根本没存在过

先记住这个坑:进入沉浸模式后,浏览器的网页覆盖层不渲染。所以把按钮/面板写成页面的 <div> 或右上角 HUD,戴上头显一定看不见、也点不到。按键必须是场景里的一个物件。

一、按键是画在 canvas 上、贴到一块平面上的

canvas 384 × 512  →  THREE.CanvasTexture  →  PlaneGeometry(0.62, 0.82)  →  贴到墙上
var labels = ['1','2','3','4','5','6','7','8','9','C','0','OK'];
kp.keys.push({ id: labels[i], x: 24 + col*116, y: 150 + row*90, w:100, h:76 });

命中靠 uv:射线打到平面的哪一点 → 换算成 canvas 的像素坐标 → 落在哪个键的矩形里 → 就是按了哪个键。这就叫 UV 命中。

二、★ 打开 buildDoor(),三样东西一起看

labels

['1'…'9','C','0','OK']——12 个键的名字与顺序。

kp.keys

x = 24 + col*116、y = 150 + row*90、w = 100、h = 76——每个键在 canvas 上的矩形。

canvas 尺寸

384 × 512——所有坐标系都以它为准。

★ 现场改一处:把 labels 里 'OK' 的位置和 'C' 换一下,看墙上的键盘跟着变。

"改布局 = 改两个数组,不用重新建模。"这就是"逻辑全部暴露"的好处——这正是这个案例值得当教材的原因。

三、密码:错了只清空,不锁死

function keypadPress(id){
  if (id === 'C') { keypad.display = ''; }              // 清除键
  else if (id === 'OK') {
    if (S.step !== 3)                  toast('密码锁还没通电');   // 顺序门
    else if (keypad.display === CODE)  openDoor();                // 对 → 开门
    else { toast('密码错误'); keypad.display = ''; }              // 错 → 只清空
  } else { if (keypad.display.length < 4) keypad.display += id; } // 最多 4 位
}
为什么不锁死?因为这是一个体验作品,不是银行 App。用户输错了,你的目标是让他再试一次,不是让他记住教训。
四

顺序校验:S.step 与"失败有代价但不惩罚"

什么叫顺序?就是你没做完第一步,第二步不认你

演示案例 02 用一个对象 S 装着全部状态,其中 step 是唯一的裁判:

S.step状态谁能推进它
0找碎片3 块碎片全部放置完成 → 进 2
2点星S.starProgress 满 4 → 进 3
3输密码密码正确 → 进 4(门开)
4通关——

这就是最小成本的顺序校验:每一个动作入口,先问一句"现在轮到你了没有"。

一、⚑ 这一屏最值得抄下来的一段

function clickStar(st){
  if (S.step !== 2) { toast('先找齐壁画碎片'); return false; }   // 门
  if (st.lit)       { toast('这颗星已点亮');   return false; }   // 已点过
  var expectIdx = STAR_ORDER[S.starProgress.length];            // 该点哪一颗
  if (st.idx !== expectIdx) {
      for (全部星) { 熄灭、order = -1; }        // ← 代价:全部熄灭
      S.starProgress = [];                      // ← 代价:进度清零
      toast('顺序不对,星辰归位重来');
      return false;                             // ← 但:没有任何锁死
  }
  ...
}

代价是什么

进度清零、四颗星全部熄灭、有音效与提示——这足够让用户知道他做错了。

不惩罚是什么

不扣时间 · 不锁死 · 不用刷新页面——立刻可以重来。这保证他不会放弃你的作品。

正确顺序(演示案例 02):STAR_ORDER = [2, 0, 3, 1],星名见 names = ['角','亢','氐','房'] → 也就是 氐 → 角 → 房 → 亢。

二、★ 演示:错序 → 复位 → 接着玩

用控制台直接调 Dunhuang.clickStar(Dunhuang.stars[0]),故意点错一颗,观察三件事:

  1. 已亮的星全部熄灭;
  2. 提示"顺序不对,星辰归位重来";
  3. 再点正确的那颗,仍然能推进。
这三条合起来才是完整的"失败处理"。少任何一条,用户体验就掉一档:少了复位,用户可以乱点通关;少了提示,用户不知道为什么失败;锁死了,用户直接退出。
顺手一个调试技巧:这些函数挂在一个叫 Dunhuang 的对象上,控制台能直接调——Dunhuang.keypadPress('OK')、Dunhuang.clickStar(Dunhuang.stars[2])。你们自己的作品也应该留一个能从控制台推进状态的入口,调试能省一半时间。
实现口径 4 与 5:顺序校验必须有"复位"这一半;失败有代价但不惩罚——点错星只是重来,密码输错只是清空,可以立刻重输。

三、⚑ 谜题设计:线性,但每一步都不一样

步骤谜题交互方式状态推进
①找齐 3 块壁画碎片直接抓取(握持键)+ 走到壁画框旁松手S.fragments[i] = true
②壁画拼合无操作(自动过场 / 提示)S.step: 0 → 2
③按顺序点亮 4 颗星射线点击 + 顺序校验S.starProgress 满 4 → step 3
④石门 4 位密码3D UI 键盘(UV 命中)正确 → 门开 → 通关

⚑ 四步,四种交互——这就是"线性但不枯燥"的做法。反例(要让学生自己认出来):如果四步全是"点一个按钮",这就不叫谜题链,叫四个进度条。

四、提示要分层:giveHint() 按 step 给不同粒度

同一个"提示"按钮,在三个步骤给三种不同的话:找碎片(step 0)→ 给位置;点星(step 2)→ 给下一颗是哪一颗;密码(step 3)→ 直接给密码。

提示是难度的调节旋钮,不是一句话。找碎片是空间搜索,最费时间;密码只是记忆力,卡在那里没有任何意义。⚑ 提问:你的作品里,"提示"现在给了什么?(很多人根本没写提示。)
五

谁都点得到:人因与可访问性三件套

三个键,全部由共享 XR 工程内核提供——你的作品只要接了同一个内核,这三个键自动就有;但"自动就有"只到面板这一层

一、先把默认假设拆开:它排除了谁

你的作品现在假设用户:站着 · 两只手 · 两个能用的手柄 · 眼睛正常 · 不戴眼镜也行 · 不觉得晕。把这条假设拆开:

假设谁被排除了
站着 / 能站轮椅使用者、久坐不适的人、空间不够的人
两只手都在单臂用户、临时空不出手的人(拿着一支笔、拄着拐)
右利手左利手(约十分之一的人)——40 人的班,四五个
双手柄都在、都有电手柄漂移 / 没电 / 没配对的人
手持控制器动作受限用户——手抬不起来、抖动、抓握无力
能看清小字低视力用户
这不是道德课。"约十分之一是左利手"、"有人暂时腾不出手"——这些是产品问题。一个作品如果只有一种输入方式,它就只有一个很窄的用户群。

二、三个键的真实参数(照抄,不要靠记忆)

键功能真实参数现场要看见什么
Shift+P 坐姿 / 站立 坐姿时工程面板与案例自有 UI 一起下沉 0.45 m、下倾 0.18 rad 站着很舒服、抬手就能点的面板,坐下就够不着——下沉之后坐着也能点到最下面一排键
Shift+H 惯用手与单手 循环 双手 → 单手(自动)→ 仅右手 → 仅左手 → 双手;单手模式下只接受主手的扳机 / 抓握 切到"仅左手"后用右手去点——没有任何反应,右手突然变成了摆设
Shift+G 注视停留点击 视线中心射线命中 UI,停留 1.2 s 即触发;命中处有注视准星,命中时收缩并变金,移开就重置、同一目标不重复触发(内核参数 gazeMs = 1200) 不用手柄,用眼睛点完整块密码键盘(包括最后按 OK 开门)

三、注册与委托:两个必须记住的词

XRCore.ui([keypad.panel]);   /* 把"我自己做的面板"登记给内核,坐姿时才一起下沉 */

XRCore.uiHit(function(rc){   /* 把"我的面板有没有被打中"委托给内核的注视计时器 */
  ...
  return { id:'xxx', fire:function(){}, dist:hit.distance };
});

不登记会怎样

你在内核之外自己做了一块面板,不登记,坐姿时它就不动——这正好是你们接下来改自己作品时会踩的坑。

为什么要委托

因为内核不会自己认识你的面板。你不告诉它,它就只会算工程面板那几块。

一个很细但很关键的反馈设计:准星命中时收缩并变金——这就是进度条;眼睛移开进度重置;同一个目标不重复触发,所以你不用怕"看多了一眼又点一次"。

四、本段的当堂动手(10 分钟)

  1. 打开演示案例 02,依次按 Shift+P → Shift+H(循环到"仅左手")→ Shift+G;
  2. 在【表 B · 免手柄通路验证表】上边按边填:这一步能不能不用手柄完成?卡在哪?
⚠️ 这是今天下午你自己作品的选题依据——三件套里你打算支持哪几条,今天下午就要定。而"你的场景实体怎么支持",是你要自己决定的事。
六

一条通道铺到一半:本课的高潮

⚑ 结论留白,让学生自己说出来——教师说的话不超过 10 句,动作要慢,问题写在屏上不要马上回答

现场切到 Shift+G 注视模式,放慢动作演四步:
  1. 同一个密码键盘:手柄射线点得动;切到 Shift+G,用注视也点得动(停留 1.2 s,准星收缩变金),连按 OK 开门都可以;
  2. 接着去点星星:注视模式下点不动——停 1.2 秒、再停 2 秒,都没反应;
  3. 再去抓一块壁画碎片:注视模式下也抓不了——停多久都行,抓不了;
  4. 停下来,问全班一句(写在屏上,不要马上回答):

"同一个作品里,为什么有些东西不用手柄也能点,有些东西死活点不动?"

教师注意(这一段最关键):不要自己说出答案。等 2—3 个学生说完,再确认他们的说法。学生的答案应该指向下面这三句。

一、把刚才看到的东西列成一张表

元素类型免手柄能不能用为什么
工程面板UI能内核的注视计时器直接管
密码键盘(案例自有)UI能案例用 XRCore.uiHit() 委托给内核
四颗星场景实体不能判定走手柄射线命中(clickStar)
壁画碎片场景实体不能抓取绑在 squeezestart(握持键)上
传送落点场景不能同样走手柄射线
两张"能"、三张"不能",差别在哪儿?——结论这一行让学生说出来,教师再写上去:
"面板可免手柄,场景实体仍需手部输入。"
这不是案例的 bug,是真实产品里最常见的可访问性问题:一条替代通道铺到了一半,就以为铺完了。它在真实产品里天天发生——因为做的人有手柄,试的人也有手柄。

二、⚑ 该不该替?——取舍清单

想替代的动作替代方案代价
点星注视停留 1.2 s4 颗星 × 1.2 s ≈ 5 s 纯等待,节奏垮掉;顺序谜题变成"耐心测试"
抓碎片注视停留 1.2 s → 吸到手上注视没有"握持"这个动作语义,你得自己发明一个;且误触代价高(看到哪抓到哪)
传送注视地面 + 停留与"看着地面思考"冲突;低头看地面是自然动作,很容易误触发
判断句(板书):能替代的替代;不能替代的,要说出来。
"说出来" = 写进 README(这就是诚实);"不说" = 骗人(用户以为你支持了,戴上头显才发现不行)。
照这个句式写,不要写成"支持免手柄":"本作品的可访问性覆盖范围:面板可免手柄;场景实体的抓取与选择仍需手柄。"

三、下课前的三句话

  1. 本课命题:交互的难点不在"能不能点",在"点不到时怎么办";
  2. 可访问性的诚实口径:面板可免手柄,场景实体仍需手部输入——能替代的替代,不能替代的要说出来;
  3. 接下来 65 分钟的顺序不能颠倒:先改(在电脑上打通主流程、连走两遍、控制台无报错)→ 再补(至少补一条免手柄通路,写下它覆盖到哪一步、覆盖不到哪一步)→ 最后戴(戴上头显走完整流程,抄用时 / 记卡点 / 报退出路)。
所有人在戴上头显之前,先把代码改完。不许一边改一边戴——那样一个人会占住一台头显一整段时间。
例

案例演示 · 现场要放的四处改码

全部是"打开源码、改一个数 / 一个数组、看结果"——每个 ≤ 3 分钟;本课次只放这四处加一处高潮演示

#演示怎么演要让学生看见什么
A ★抓取距离把 bd = 0.45 改成 0.15 和 1.5,各抓一次太小抓不到、太大隔着半间房就吸走——阈值是调出来的,不是想出来的
B ★放置判定把 release() 的 1.6 → 0.5 再 → 4.0,各放一次太远放不进(站在框前松手,碎片掉地上)、太近误触发(在门口一松手就算放好)
C ★错序复位控制台调 Dunhuang.clickStar(Dunhuang.stars[0]),先点错一颗已点亮的星全部熄灭、提示"顺序不对,星辰归位重来";再点一次就能接着玩
D ★UV 命中 3D 键盘打开 buildDoor(),指出 labels 与 kp.keys 坐标;把 'OK' 与 'C' 换个位置按键是一个画在 canvas 上的矩形,命中靠 uv 换算成像素坐标;改布局 = 改两个数组
E ★⚑本课高潮切 Shift+G,同一个键盘点得动、注视也点得动;星星和碎片就是不行把"面板支持了、场景物件没支持"变成学生自己得出的结论(见上一节)
⚠️ 诚实交底(必须说):"这个案例从来没有在任何头显上跑过。"6 个演示案例的全部结论来自 headless Chrome + SwiftShader 软件渲染;帧率、眩晕感、手柄映射、会话进出,均未实测。所以它们的帧率、手感、手柄映射——要等你们今天戴上去,才第一次被真的验证。

一、课前两条必须做的实测

项事实怎么处理
手柄 squeeze 与触觉在 PICO 固件上的表现未验证(演示案例 02 README「六、性能与验证」明确写入)课前 5 分钟实测:握持键能否触发抓取、触觉是否有反馈;不通过就把抓取改成"扳机就近抓取",并当堂说明这是已知简化——不要装作没这回事
演示案例 02 真机跑通一遍含进入与退出从未在头显上验证课前 30 分钟用当次要用的演示案例 02 在头显里真机跑通一遍(含进入与退出),并确认 Shift+P / Shift+H / Shift+G 按键真的生效

二、性能数字:两个口径如实并列

来源DrawCall三角面
演示案例 02 README_教学说明.md 第六节421.2k
标准_大四课程标准.md 的 verify.py 复核441240
两个数都要如实说,不要圆成"两个都对"——差异来自统计口径(何时取样、是否含面板绘制)。
并且注意口径本身:draw calls / 三角面 只是渲染规模指标,不等于能跑满 72Hz;真机瓶颈常在填充率与纹理带宽。本课次不把这两个数当帧率结论。
实

上机实操:65 分钟,先改、再补、最后戴

这一段占全部时间的 36%,是本课次的重心;顺序不能颠倒

三个小段的判据,一张表看完:
小段时长做什么判据
⑤-1 打通主流程30′在自己电脑上,把自己作品的"入口 → 第一个目标 → …… → 通关"完整走通两遍控制台无 JS 报错;连走两遍结果一致
⑤-2 补一条免手柄通路15′至少补一条不用手柄也能推进的通路(三选一或全做),并写下它覆盖到哪一步、覆盖不到哪一步【表 B】填满;"覆盖不到哪里"必须写出来
⑤-3 真机验证20′(含组织时间)戴上头显,从头走完整流程:抄用时、记卡点、记退出路【表 C · 真机验证记录卡】填满

一、任务 1:打通自己的主流程(在电脑上做,不戴头显)

做完这三件事,把结果填进【表 A】:

  1. 打开控制台(F12),清空一次,然后完整走一遍,看有没有红色报错;
  2. 再走第二遍——重点看"状态有没有残留"(第一遍通关后,第二遍能不能从头开始?);
  3. 对照你上周/本课补的状态机图(M2 并入本课),检查每一步是不是真的按图走了。
⚠️ 常见的三个"看起来通了":
① 第一遍能过、第二遍过不去 → 你的状态没归零(去找你的"重置"函数);
② 中间某一步"只能靠老师帮我跳过" → 这不算通;
③ 控制台有红色报错但游戏还能玩 → 这不算无报错。

二、任务 2:补一条免手柄通路(在电脑上做)

备选通路怎么做难度
A · 注视停留点面板作品接了共享 XR 工程内核:XRCore.ui([你的面板]) 登记 + XRCore.uiHit(fn) 委托命中判定中
B · 键盘快捷键在 PC 端给每一个关键动作绑一个键(必须写进 README)低
C · 备用 2D 控制面板在页面角落放一排按钮,和 3D 面板功能等价低
必须写清楚(这是本次课的重点,不是可选项):"我的免手柄通路,覆盖到哪一步?覆盖不到哪一步?"只写"支持免手柄"而不写边界 = 不算过。

照这个句式写,不要写成"支持免手柄":

本作品的可访问性覆盖范围:
- 能免手柄完成的:______(例:打开提示面板、切换提示层次、输入密码)
- 不能免手柄完成的:______(例:抓取碎片、按顺序点星)
- 原因:______(例:抓取绑在握持键上,注视通道没有覆盖场景实体的判定)
- 我用三件套里的哪几条:Shift+P 坐姿 / Shift+H 单手 / Shift+G 注视(可多选)

三、巡场时教师只问三句话

  1. 你卡在哪一步?
  2. 这一步是环境问题、作品问题、还是设备问题?(三分类,直接对应记录表)
  3. 退出来用了哪条路、几秒?
"已经做完的人"是这节课最大的资源——让他们去帮"卡住的人",比教师一个人巡场快得多。

四、40 人同时上机怎么组织(两套预案,按 【待确认】 的设备数量二选一)

预案 A · 一人一台(头显数量 ≥ 人数)

40 人同时上机,不轮转;教师 + 2 名学生管理员巡场。
· 0—3′ 就位、开机、跑《VR 作品自检》——巡场先解决"六项不绿"的人;
· 3—33′ 任务 1;33—48′ 任务 2;
· 48—58′ 分批进入任务 3;守住"戴头显前先看周围人"这条规矩,管理员掐表记用时;
· 58—65′ 回到座位立刻填【表 C】。

预案 B · 10 台轮转(头显数量 ≈ 10)

5 人一组 × 8 组,每组 8 分钟。一组戴头显时,其余人在电脑上做任务 1 / 任务 2 与 PC 端等价验证。
三条纪律:① 严格 8 分钟一到就换人,前一组把记录卡带走继续填,不要在头显旁边讨论;② 一组里先商量好谁先戴,推让一次就烧掉 1 分钟;③ 任何情况下都不减的是"人人戴上",减的是"任务 1 走两遍 → 走一遍"。

两套预案的共同底线(不降):每个人都要在头显里走完自己作品的主流程,并至少试通一条退出路。

五、三级降级

级别触发条件降到什么程度
一级个别学生进不去 VR不要全班等;让同桌先帮;教师只处理"六项不绿"的环境问题
二级网络整体不顺(大面积进不去)全班切到通路 ① USB 直连;同时砍掉免手柄通路的"VR 内"部分(降级为键盘快捷键通路,注明取舍)
三级时间不够(只剩 20 分钟)只保"戴上头显走完主流程 + 三条退出路试通一条 + 报退出用时";任务 1 的"两遍"改成"一遍";FPS / DrawCall 改成课后补
任何情况下都不降的三条:① 达标线本身;② 每个人都要在头显里真的走完自己作品的主流程;③ "能退得出去"没有降级选项。
验

真机验证:安全三条、单人脚本、三条退出路

这节课的产出是"一条能走通、能退出的流程",不是"一套知识"

一、就位与安全(5 分钟,全班一起做,一条都不能省)

站到座位旁,先不要戴。三条一起念:
  1. 戴上之前,先看清自己前后左右有没有人(尤其身后);
  2. 戴着头显时不许走动——本课作品用传送 + Snap 转向,不需要移动身体;
  3. 眼镜同学先戴眼镜,再戴头显;线材走身后。

再补两条(本课次要加强的):

二、三条通路:课前选定一条,课上只教那一条

通路怎么走依赖适合
① USB + adb reverse(最稳)数据线连头显(开发者模式 + 允许 USB 调试)→ 笔记本执行 adb reverse tcp:8080 tcp:8080 → 头显浏览器打开 http://127.0.0.1:8080/一根数据线。完全不经过网络教室网络差;一插就通,天生安全上下文,不用加白名单
② 局域网 + 白名单笔记本起服务(serve.bat,零依赖)→ 头显浏览器打开 chrome://flags/#unsafely-treat-insecure-origin-as-secure,把 http://电脑IP:8080 填进去并 Enabled → 重启浏览器头显与笔记本同一网段、网络不隔离不插线、反复调试
③ 站点 HTTPS把作品放到课程站点的学生作品目录,头显直接打开 https 链接需要先把文件放上站点收作业与互相看
⚠️ 通路 ② 的三个坑:① 电脑 IP 一变就要重填;② 校园网 / 手机热点可能开「客户端隔离」,两台机器根本连不上,只能走 ①;③ 第一次运行 serve.bat 时 Windows 弹防火墙询问,必须点"允许"。
不要课上临时试第二条。40 台设备一起等一个没验证过的功能,是最容易把课拖垮的场面。
口诀(第 5 次课已确立,全程沿用):先怀疑环境,再怀疑代码。"进入 VR"只在安全上下文里可用——https: / http://localhost / http://127.0.0.1 算;你电脑的局域网 IP(http://192.168.x.x)不算。用局域网 IP 打开时看不到「进入 VR」按钮、控制台里 navigator.xr 是 undefined——那不是学生的代码写错了,是环境不满足。这是本节课第一大故障源。

三、单人操作脚本(教师投屏演示一遍,学生照做)

步做什么学生会卡在哪
①打开《VR 作品自检》,六项全绿第 ②③④ 项有 ❌ → 先解决环境,不要看作品代码
②打开自己的作品 → 点「进入 VR」进 VR 必须由人手点一次,这是规范要求
③★ 走一遍主流程并连走两遍,控制台无红色报错"第一遍能过、第二遍过不去" → 状态没归零,去找你的重置函数
④慢慢环视一周,抬头低头各看一眼说出一个具体的东西("我看见壁画框"),不要只说"很清楚"
⑤试免手柄通路:注视停留 / 键盘快捷键 / 2D 面板面板可以免手柄,场景实体(抓取、点星)仍需手柄射线
⑥★ 完整走一遍主流程,记下总用时用时要真的掐表,不是估的
⑦走完 → 至少试通一条退出路,报出用时只留一条出口的应用,在真实课堂里一定会出事
⑧抄 FPS / DrawCall / 三角面,立刻填【表 C】数字必须和页面 HUD 对得上(编数据比做不出来更严重)
探针:在自己页面里加一行 <script src="vr-probe.js"></script>(从 《VR 作品自检》那一页取)。它会把读数画进 3D 场景——因为沉浸模式下浏览器不渲染网页覆盖层,低头才能看到的那块面板,才是头显里唯一看得见的读数。

四、三条退出路(至少试通一条,并当场报用时)

路怎么做备注
①注视 / 射线点自己页面里的「退出 VR」按钮前提:作品里真的有这个按钮;注视模式下停留时间按内核约定
②长按握把 2 秒前提:页面接了这条兜底;课前 5 分钟实测握持键
③按头显系统键 → 退出 VR任何情况下都可用,是最后的安全网
退不出去的作品,是最严重的可用性事故——因为你没法解释,别人也没法帮你。
顺序:学生自己先试 ① → ② → ③,教师兜底。三条退出路一条都没试通,M3 直接不过。

五、故障速查(贴在讲台)

现象先查什么
头显打不开页面① 走通路 ①(USB,不依赖网络);② 换手机热点;③ 打开已装为应用(PWA)的版本
页面能开,但按钮显示"不支持 WebXR"先看是不是安全上下文(协议不是 https / 不是 127.0.0.1 / 没加白名单)
进了 VR 看不见自己的面板这是正常现象——沉浸模式下网页 DOM 不渲染,面板必须是 3D 物件
手柄握持键抓不住东西课前 5 分钟已实测;若现场失效 → 改用扳机就近抓取,并说明这是已知简化
进不去 VR / 进去黑屏退出重进一次;换通路;仍不行 → 换备用头显,原机登记课后查
退不出来① 视线停退出按钮 → ② 长按握把 2 秒 → ③ 系统键 → ④ 长按电源强制重启
注视模式(Shift+G)没反应确认是 PC 焦点窗口;确认页面加载了共享内核 _xr_core.js;确认准星出现了
一句话原则:坏一台,换一台;课不停,不等人。

六、为什么这节课要花 65 分钟在验证上

"你今天做的所有事情,都能在你的电脑上看到结果。但有四件事只有戴上头显才知道:
① 你的东西在离眼睛十厘米的地方,看着是不是太大或太小;
② 你的手柄真的能抓住你要抓的东西吗;
③ 走完一整套要多久——这个数你在电脑上永远掐不准;
④ 你能不能退出去。
前三条决定你的作品好不好用。第四条决定你的作品算不算做完了。"
作

达标线与评价量规

全部课内完成,不卡时间;做不完登记后到实验室补做。今天的产出是三样东西,不是一张好看的截图

一、本节达标五条(缺一条不算过)

  1. 路子通:从入口到通关能连走两遍,控制台无报错;
  2. 放得对:抓取与放置各有一个说得出数值的判定(阈值 / 槽位);
  3. 不锁死:顺序做错或密码输错之后,能立刻重来,不需要刷新页面;
  4. 能戴能退:头显里走完主流程,三条退出路至少试通一条并报出用时;
  5. 说得出边界:能回答"我的免手柄通路覆盖到哪一步、覆盖不到哪一步"。
两条硬门槛:A 主流程可玩 且 C 真机验证记录(含退出路)。路径不通或退不出去的,不进入下面的量规打分。

二、本节量规(五维,当场判达标用;与期末量规同源)

维度权重看什么
主流程完整30%入口→通关可重复、无报错、失败可恢复
交互实现25%抓取(attach())· 放置判定(阈值 + 槽位)· UV 命中 3D UI · 顺序校验(S.step)
人因与可访问性20%三件套测过几条;免手柄通路覆盖边界说清楚;取舍理由
舒适与退出15%三条退出路至少一条、报出用时;默认传送 + Snap
诚实与文档10%README 写明已知简化与覆盖不到的地方;不确定信息标 【待补充】
保留"可访问性"为必评维度——它在期末量规里已并入「交互与人因 20 分」,不再作为加分项。这条改动的原因就是第 9 次课把它教成了硬要求。

三、任何情况下都不降的三条

  1. 达标线本身;
  2. 改动必须有依据——不能瞎填阈值,你得说得出"为什么是 0.45 / 1.6";
  3. 记录表上的数字必须和页面 HUD 对得上——编数据比做不出来更严重。

四、"看起来过了其实没过"的四种情况

#情况为什么不算
1老师帮着跳过一步老师能跳过的,陌生人跳不过去
2只在 PC 上跑通M3 要的是真机记录,PC 端的绿灯不算
3能进不能退这一条单独判:三条退出路一条都没试通,直接不过
4写"很顺利、没卡点"卡点是作业的一部分——你写不出卡点,说明你没认真走

五、本节要填的四张表(学生任务卡)

表填什么对应
表 A 主流程走向记录表一行一步:这一步做什么 / 我是怎么触发的(手柄/鼠标/键盘/注视)/ 推进到哪个 step / 有无卡顿 / 控制台有无报错;最后三行填抓取距离、放置距离、顺序校验做错时的处理判据 A
表 B 免手柄通路验证表B-1 演示案例 02 四项(数字键 / OK / 星星 / 碎片);B-2 自己作品的 1—3 条通路 + "可访问性覆盖范围"声明原文判据 B
表 C 真机验证记录卡走的哪条通路 / 自检六项 / 主流程总用时 / 退出第几路 / 退出用时 / FPS / DrawCall / 三角面 / 卡点(至少一条,写"没卡"视为未通过) / 只有戴上头显才知道的事判据 C
表 D M3 自查清单A—C 三项 + D-1 说到判据数值 / D-2 不锁死 / D-3 报了退出用时 / D-4 按过三件套 / D-5 知道已知简化 / D-6 没有编造真实信息M3 结论

签字确认那一行照原样保留:"我确认本卡上的数字与页面 HUD 对得上,没有填写我没实测过的数据。"

查

一页速查

把这一页抄在笔记本上,本课的骨架就齐了

一、八句话速查

主题要记住的
本课命题交互的难点不在"能不能点",在"点不到时怎么办"
抓取attach() 一行挂上手;规则是0.45 m 内取最近的一个,不是一个范围
放置判定距离阈值 + 吸附槽:p.distanceTo(fp) < 1.6,吸到 slotX = −0.95 + idx×0.95
3D 键盘沉浸模式不渲染 DOM 按钮 → 按键是 canvas 贴图 + UV 命中;labels 与 kp.keys 共用 384 × 512 坐标系
密码var CODE = '3719';错了只清空、不锁死;最多 4 位
顺序校验S.step 是唯一裁判;每个动作入口先问"现在轮到你了没有"
失败的设计失败有代价但不惩罚——代价是重来,不惩罚是不扣时间 · 不锁死 · 不用刷新
可访问性边界面板可免手柄,场景实体仍需手部输入;能替代的替代,不能替代的要说出来

二、三个键的真实参数(照抄)

键参数
Shift+P坐姿:下沉 0.45 m、下倾 0.18 rad;自有面板要先 XRCore.ui([面板]) 登记
Shift+H循环双手 → 单手(自动)→ 仅右手 → 仅左手 → 双手;单手时只接受主手
Shift+G注视停留 1.2 s(gazeMs = 1200)触发;移开重置、同一目标不重复触发;自有面板要 XRCore.uiHit(fn) 委托

三、上机五句话

  1. 先怀疑环境,再怀疑代码——看不到「进入 VR」按钮时,先看是不是安全上下文;
  2. 进 VR 必须人手点一次,这是规范要求,装成应用也一样;
  3. 先在电脑上改完,再戴头显——不许一边改一边戴;
  4. 退出有三条路:注视/射线点按钮 / 长按握把 2 秒 / 系统键。至少试通一条并报出用时;
  5. 记录表上的数字必须和页面 HUD 对得上——编数据比做不出来更严重。

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

#要打勾的
①白板五行已写好:本课命题 / 三件套参数 / 达标五条 / M3 硬门槛 / 三条退出路
②演示案例 02 在头显里跑通了一遍(含进入与退出);三件套各按过一次,按键真的生效
③课前 5 分钟实测手柄 squeeze:握持键能否触发抓取、触觉是否有反馈;不通过就准备好"改成扳机抓取"的说法
④三条通路已选定一条,课堂上只教走通的那一条
⑤四个演示已在教师机上预演:bd · 1.6 · clickStar() 错序复位 · Shift+G 注视点键盘
⑥控制台调试入口确认可用:Dunhuang.keypadPress('OK')、Dunhuang.clickStar(Dunhuang.stars[2])
⑦课堂作业 3(交互验证 + 模型管线 + 许可卡,一页版)收件情况已排序、可投屏;M2 动线图/状态机图并入本课,收件口径待确认(开场点评用;点名只讲优点)
⑧学生任务卡已打印 40 份(含表 A / B / C / D)
⑨头显电量 ≥ 70%、手柄挂绳已装、面罩与镜片已擦、一次性眼罩 ≥ 40 片;2 名学生管理员已指定并拿到操作卡
⑩设备数量与场地已确认(【待确认】 → 确认后写下实际数):头显型号 ___ | 数量 __ 台 | 上机地点 ___;据此选定 预案 A 一人一台 或 预案 B 10 台轮转

五、课后两件事(教师)

  1. 填完操作卡第八节的现场记录表,特别是"环境 / 作品 / 设备三类卡壳各多少人"——它是第 10 次课开场的备课依据;
  2. 把 M3 交上来的三样东西收齐,并统计"没过 M3 的人卡在哪一样"——这是第 10 次课课前一对一补做的名单。
门

M3 主流程可玩:硬门槛

一句话口径(板书就写这一句):路子不通、或退不出去的作品,画面再好看也不算完成。

M3 是 11-11 第 9 次课的交件,卡住谁不能往下走——不过此关,作品不算完成。判定只看三样,不看画质、不看功能数量。

一、判定三项

#判定项过不过
A主流程可玩(硬门槛) 从入口到通关,能连走两遍,两遍结果一致;控制台无 JS 报错 中间有任何一步"只能靠老师帮你跳过";或第一遍能过、第二遍状态残留导致过不去
B一条免手柄通路 至少一条不用手柄也能推进的通路存在,并且能说清它覆盖到哪一步、覆盖不到哪一步 完全依赖手柄;或声称"支持免手柄"但说不出覆盖边界——说不清 = 不过
C真机验证记录(硬门槛) 用时 / 卡点 / 退出路三样齐全,卡点写了具体在哪一步 三项缺一;或卡点栏写"没卡"/"很顺利"——无信息量 = 不过

二、三样之外的加分观察项(不计入是否过)

三、没过怎么办(不当场否定,给补做路径)

卡在哪补做安排
卡在 A 主流程第 10 次课课前 20 分钟一对一补;先查环境(三条通路),再查代码
卡在 B 免手柄通路允许降级为"键盘快捷键通路"(PC 端可完成主流程 + 至少一处 VR 内免手柄),但必须在 README 写明取舍
卡在 C 真机记录课后到实验室补做并补填【表 C】;不占用第 10 次课的 M4 时间
不减的底线:A 与 C。免手柄通路允许按上面的方式降级,但"能退得出去"没有降级选项。

四、M3 提交要求(课上念一遍)

交什么形式交到哪
① 主流程可玩截图 / 录屏 / 或下次课现场演示,证明"入口 → 通关"能连走两遍【待确认:学生的提交路径与截止时间以教师当堂通知为准】
② 免手柄通路说明【表 B】填满,必须写清覆盖到哪一步、覆盖不到哪一步
③ 真机验证记录【表 C】填满:用时 / 卡点 / 退出路(三样缺一不可)

五、今天测出来的每一条边界,期末都要写进 README

期末大作业十条硬门槛里,第 1 条就是"能进能退"(三条退出路至少试通一条),第 9 条是"可访问性:坐姿 / 单手 / 注视停留至少两条通路可用并能等价完成主流程,说明取舍"。M3 只是中途门槛。

下

下次课预告 · 2026-11-18(第 10 次课)

好看和跑得动是两件事——帧预算是 13.9 ms,不是 16.7 ms

下次课的案例是 03 节奏竞技 · 编钟之韵(反馈、判定、程序化音频)。开场要用的,就是今天统计出来的东西。

一、下次课开场就用今天的两个统计

二、下次课讲什么

要点一句话
帧预算72 Hz ⇒ 13.9 ms——不是 16.7 ms,因为浏览器合成要占时间
先看 DrawCall不要先看面数;手段是实例化 / 合批 / 贴图复用 / 阴影分辨率
动态降级L1 降像素比 → L2 关阴影,可逆
舒适度隧道视野、默认传送 + Snap 45°
今天记下的数别丢今天抄的 FPS / DrawCall / 三角面下次课要用;读数必须和页面 HUD 对得上
今天没走通通路的同学,课后到实验室补齐——下次课一上来就是 M4 的起点,没有缓冲。没过的也可以先看自己的卡点属于哪一类:环境、作品,还是设备。

三、期末倒排(回头看一眼自己站在哪)

时间里程碑交付物
10-21 第 7 次课M1 选题定稿一页纸(主题 / 为什么必须 VR / 用户 / 核心交互 / 技术点 / 降级方案)
10-28 第 8 次课课堂作业 3交互验证 + 模型管线 + 许可卡(一页版)(M2 并入第 9 次课,口径待确认)
11-11 第 9 次课M3 可玩(硬门槛)主流程可玩 + 免手柄通路 + 真机记录——不过此关,作品不算完成
11-18 第 10 次课M4 性能达标优化前后对照 + 读数与 HUD 一致
11-25 第 11 次课M5 功能封版智能模块 + 降级方案 + 体验数据 JSON
12-02 第 12 次课M6 路演答辩作品目录 + README + cover.jpg + JSON