写法 ① · 按索引固定(演示案例 02)
好处是不会抢位置;代价是顺序感弱——你随便捡哪块都行,顺序不对也能拼对。
第 9 次课 · 演示案例 02「密室逃脱 · 敦煌寻宝」(二)——上周(10-28)交的是课堂作业 3(交互验证 + 模型管线 + 许可卡,一页版);M2 动线图/状态机图并入本课、口径待教师确认;这一周要证明作品真的能用,而且不是你能用,是一个陌生人戴上头显也能用
上一课证明"有没有目标";这一课证明"目标能不能被点得到、能不能被退得出来"
上周(10-28)交的是课堂作业 3:交互验证 + 模型管线 + 许可卡(一页版)。旧口径的 M2(动线图 + 状态机图 + 可玩入口)并入本课,最终交付口径待教师确认。这一周要证明的是"它真的能用"——而且不是"你能用",是一个不熟悉你作品的人,戴上头显也能用。
| # | 问题 | 一句话判据 | 本页在哪 |
|---|---|---|---|
| ① | 抓得住吗 | 手伸到多近才抓得住?太远抓不到,太近会误抓 | 一、抓得住吗 |
| ② | 放得对吗 | 松手那一刻凭什么判断"这是放对了"?距离阈值 + 吸附槽 | 二、放得对吗 |
| ③ | 顺序对不对 | 不按设计的顺序做会怎样?报错之后还能不能接着玩 | 四、顺序与失败代价 |
| ④ | 点得到吗 | 不用手柄的人能不能走完整个流程?走到哪一步就走不动了 | 五、谁都点得到 |
| ⑤ | 退得出去吗 | 玩完了怎么退出?退不出去的作品,是最严重的可用性事故 | 真机验证 |
这节课最难的不是写代码,是"替别人试":你要站在一个没有手柄、坐着的、只用一只手的用户的位置上,把自己的作品从头走一遍。
| 时段 | 时长 | 段 | 内容 | 产出 |
|---|---|---|---|---|
| 0:00—0:10 | 10′ | ① 开场 | 课堂作业 3(一页版)点评 + 卡点统计;M2 动线图/状态机图并入本课(口径待确认)(只讲优点;问题一律说"有同学的作品") | "做的时候才发现想不清楚"的问题清单 |
| 0:10—0:55 | 45′ | ② 讲授 | 抓取 / 放置 / 顺序校验 + 谜题与失败代价设计(★ 四处现场改码) | 五条实现口径 |
| 0:55—1:05 | 10′ | ③ 课间 | ——(若本次课需换场,这 10′ 就是换场时间) | —— |
| 1:05—1:40 | 35′ | ④ 讲授+实操 | 人因与可访问性三件套(Shift+P / Shift+H / Shift+G)+ 边界讨论 | 每人当堂按过一次三件套 |
| 1:40—2:45 | 65′ | ⑤ 工作室 + 真机验证 | 打通主流程 + 补免手柄通路 + 戴头显走完整流程并抄用时 | 主流程可玩 + 免手柄通路 + 真机记录 |
| 2:45—3:00 | 15′ | ⑥ 收束 | 三条退出路当场报用时 + M3 提交要求 | 退出用时进全班统计 |
【待确认】【待确认】,并同时给出两套组织预案:本课次涉及的真实信息只在两处出现,均按占位处理,不引用任何具体洞窟编号或文物流转信息:
· 案例场景里的敦煌壁画名称、洞窟编号、藏经洞史实 → 【待补充:壁画与洞窟信息以敦煌研究院公开资料为准】;
· 若学生 M3 作品涉及校史题材,中华女子学院校史节点 → 【待补充:校史信息以学校官方公开资料为准】。
案例与 three.min.js、_xr_core.js 同目录,离线可跑;三件套快捷键由共享 XR 工程内核提供,不是案例自己写的。
attach() 与"最近的那一个"演示案例 02 的抓取规则:0.45 m 内,挑最近的那一块碎片——"最近"是规则,不是"我想要"
抓取这个动作,很多人以为是一大段代码。其实就是一行 attach。真正需要你决定的只有一件事:手伸到多近,才算抓得住?
grab(obj, holder) 里,核心一行是 holder.attach(obj)——把物体挂到控制器上;squeezestart(握持键被按下)——不是扳机;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);
bd(3 分钟)| 改成 | 现象 | 用户的感受 |
|---|---|---|
0.15 | 抓不到——手就在碎片上,按握持键没反应 | "这游戏坏了" |
1.5 | 隔着半间房,碎片自己飞过来 | "这也太简单了" |
松手(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 布置的作业方向)
⚑ 要让学生自己看出来的一件事:release() 里没有"放错了"这个分支——阈值内就吸附,阈值外就掉在原地。"放错"这件事在你的作品里到底发生了没有?
进了沉浸模式,网页的 DOM 面板不渲染——你在 HTML 里写的 <button> 在头显里根本没存在过
<div> 或右上角 HUD,戴上头显一定看不见、也点不到。按键必须是场景里的一个物件。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.keysx = 24 + col*116、y = 150 + row*90、w = 100、h = 76——每个键在 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 位
}
var CODE = '3719'——它是星象提示给出的,不是让用户猜的;display.length < 4——一个很便宜的防误触,挡住"用户一直按一直按"。S.step 与"失败有代价但不惩罚"什么叫顺序?就是你没做完第一步,第二步不认你
演示案例 02 用一个对象 S 装着全部状态,其中 step 是唯一的裁判:
S.step | 状态 | 谁能推进它 |
|---|---|---|
| 0 | 找碎片 | 3 块碎片全部放置完成 → 进 2 |
| 2 | 点星 | S.starProgress 满 4 → 进 3 |
| 3 | 输密码 | 密码正确 → 进 4(门开) |
| 4 | 通关 | —— |
这就是最小成本的顺序校验:每一个动作入口,先问一句"现在轮到你了没有"。
clickStar() 的第一行就是这道门:if (S.step !== 2) { toast('先找齐壁画碎片'); return false; }keypadPress() 也一样:if (S.step !== 3) { toast('密码锁还没通电'); }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]),故意点错一颗,观察三件事:
Dunhuang 的对象上,控制台能直接调——Dunhuang.keypadPress('OK')、Dunhuang.clickStar(Dunhuang.stars[2])。你们自己的作品也应该留一个能从控制台推进状态的入口,调试能省一半时间。| 步骤 | 谜题 | 交互方式 | 状态推进 |
|---|---|---|---|
| ① | 找齐 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 };
});
你在内核之外自己做了一块面板,不登记,坐姿时它就不动——这正好是你们接下来改自己作品时会踩的坑。
因为内核不会自己认识你的面板。你不告诉它,它就只会算工程面板那几块。
一个很细但很关键的反馈设计:准星命中时收缩并变金——这就是进度条;眼睛移开进度重置;同一个目标不重复触发,所以你不用怕"看多了一眼又点一次"。
Shift+P → Shift+H(循环到"仅左手")→ Shift+G;⚑ 结论留白,让学生自己说出来——教师说的话不超过 10 句,动作要慢,问题写在屏上不要马上回答
Shift+G 注视模式,放慢动作演四步:
Shift+G,用注视也点得动(停留 1.2 s,准星收缩变金),连按 OK 开门都可以;"同一个作品里,为什么有些东西不用手柄也能点,有些东西死活点不动?"
| 元素 | 类型 | 免手柄能不能用 | 为什么 |
|---|---|---|---|
| 工程面板 | UI | 能 | 内核的注视计时器直接管 |
| 密码键盘(案例自有) | UI | 能 | 案例用 XRCore.uiHit() 委托给内核 |
| 四颗星 | 场景实体 | 不能 | 判定走手柄射线命中(clickStar) |
| 壁画碎片 | 场景实体 | 不能 | 抓取绑在 squeezestart(握持键)上 |
| 传送落点 | 场景 | 不能 | 同样走手柄射线 |
| 想替代的动作 | 替代方案 | 代价 |
|---|---|---|
| 点星 | 注视停留 1.2 s | 4 颗星 × 1.2 s ≈ 5 s 纯等待,节奏垮掉;顺序谜题变成"耐心测试" |
| 抓碎片 | 注视停留 1.2 s → 吸到手上 | 注视没有"握持"这个动作语义,你得自己发明一个;且误触代价高(看到哪抓到哪) |
| 传送 | 注视地面 + 停留 | 与"看着地面思考"冲突;低头看地面是自然动作,很容易误触发 |
全部是"打开源码、改一个数 / 一个数组、看结果"——每个 ≤ 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,同一个键盘点得动、注视也点得动;星星和碎片就是不行 | 把"面板支持了、场景物件没支持"变成学生自己得出的结论(见上一节) |
| 项 | 事实 | 怎么处理 |
|---|---|---|
手柄 squeeze 与触觉 | 在 PICO 固件上的表现未验证(演示案例 02 README「六、性能与验证」明确写入) | 课前 5 分钟实测:握持键能否触发抓取、触觉是否有反馈;不通过就把抓取改成"扳机就近抓取",并当堂说明这是已知简化——不要装作没这回事 |
| 演示案例 02 真机跑通一遍 | 含进入与退出从未在头显上验证 | 课前 30 分钟用当次要用的演示案例 02 在头显里真机跑通一遍(含进入与退出),并确认 Shift+P / Shift+H / Shift+G 按键真的生效 |
| 来源 | DrawCall | 三角面 |
|---|---|---|
演示案例 02 README_教学说明.md 第六节 | 42 | 1.2k |
标准_大四课程标准.md 的 verify.py 复核 | 44 | 1240 |
draw calls / 三角面 只是渲染规模指标,不等于能跑满 72Hz;真机瓶颈常在填充率与纹理带宽。本课次不把这两个数当帧率结论。这一段占全部时间的 36%,是本课次的重心;顺序不能颠倒
| 小段 | 时长 | 做什么 | 判据 |
|---|---|---|---|
| ⑤-1 打通主流程 | 30′ | 在自己电脑上,把自己作品的"入口 → 第一个目标 → …… → 通关"完整走通两遍 | 控制台无 JS 报错;连走两遍结果一致 |
| ⑤-2 补一条免手柄通路 | 15′ | 至少补一条不用手柄也能推进的通路(三选一或全做),并写下它覆盖到哪一步、覆盖不到哪一步 | 【表 B】填满;"覆盖不到哪里"必须写出来 |
| ⑤-3 真机验证 | 20′(含组织时间) | 戴上头显,从头走完整流程:抄用时、记卡点、记退出路 | 【表 C · 真机验证记录卡】填满 |
做完这三件事,把结果填进【表 A】:
| 备选通路 | 怎么做 | 难度 |
|---|---|---|
| A · 注视停留点面板 | 作品接了共享 XR 工程内核:XRCore.ui([你的面板]) 登记 + XRCore.uiHit(fn) 委托命中判定 | 中 |
| B · 键盘快捷键 | 在 PC 端给每一个关键动作绑一个键(必须写进 README) | 低 |
| C · 备用 2D 控制面板 | 在页面角落放一排按钮,和 3D 面板功能等价 | 低 |
照这个句式写,不要写成"支持免手柄":
本作品的可访问性覆盖范围: - 能免手柄完成的:______(例:打开提示面板、切换提示层次、输入密码) - 不能免手柄完成的:______(例:抓取碎片、按顺序点星) - 原因:______(例:抓取绑在握持键上,注视通道没有覆盖场景实体的判定) - 我用三件套里的哪几条:Shift+P 坐姿 / Shift+H 单手 / Shift+G 注视(可多选)
【待确认】 的设备数量二选一)40 人同时上机,不轮转;教师 + 2 名学生管理员巡场。
· 0—3′ 就位、开机、跑《VR 作品自检》——巡场先解决"六项不绿"的人;
· 3—33′ 任务 1;33—48′ 任务 2;
· 48—58′ 分批进入任务 3;守住"戴头显前先看周围人"这条规矩,管理员掐表记用时;
· 58—65′ 回到座位立刻填【表 C】。
5 人一组 × 8 组,每组 8 分钟。一组戴头显时,其余人在电脑上做任务 1 / 任务 2 与 PC 端等价验证。
三条纪律:① 严格 8 分钟一到就换人,前一组把记录卡带走继续填,不要在头显旁边讨论;② 一组里先商量好谁先戴,推让一次就烧掉 1 分钟;③ 任何情况下都不减的是"人人戴上",减的是"任务 1 走两遍 → 走一遍"。
| 级别 | 触发条件 | 降到什么程度 |
|---|---|---|
| 一级 | 个别学生进不去 VR | 不要全班等;让同桌先帮;教师只处理"六项不绿"的环境问题 |
| 二级 | 网络整体不顺(大面积进不去) | 全班切到通路 ① USB 直连;同时砍掉免手柄通路的"VR 内"部分(降级为键盘快捷键通路,注明取舍) |
| 三级 | 时间不够(只剩 20 分钟) | 只保"戴上头显走完主流程 + 三条退出路试通一条 + 报退出用时";任务 1 的"两遍"改成"一遍";FPS / DrawCall 改成课后补 |
这节课的产出是"一条能走通、能退出的流程",不是"一套知识"
再补两条(本课次要加强的):
| 通路 | 怎么走 | 依赖 | 适合 |
|---|---|---|---|
① 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 链接 | 需要先把文件放上站点 | 收作业与互相看 |
serve.bat 时 Windows 弹防火墙询问,必须点"允许"。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 | 任何情况下都可用,是最后的安全网 |
| 现象 | 先查什么 |
|---|---|
| 头显打不开页面 | ① 走通路 ①(USB,不依赖网络);② 换手机热点;③ 打开已装为应用(PWA)的版本 |
| 页面能开,但按钮显示"不支持 WebXR" | 先看是不是安全上下文(协议不是 https / 不是 127.0.0.1 / 没加白名单) |
| 进了 VR 看不见自己的面板 | 这是正常现象——沉浸模式下网页 DOM 不渲染,面板必须是 3D 物件 |
| 手柄握持键抓不住东西 | 课前 5 分钟已实测;若现场失效 → 改用扳机就近抓取,并说明这是已知简化 |
| 进不去 VR / 进去黑屏 | 退出重进一次;换通路;仍不行 → 换备用头显,原机登记课后查 |
| 退不出来 | ① 视线停退出按钮 → ② 长按握把 2 秒 → ③ 系统键 → ④ 长按电源强制重启 |
注视模式(Shift+G)没反应 | 确认是 PC 焦点窗口;确认页面加载了共享内核 _xr_core.js;确认准星出现了 |
全部课内完成,不卡时间;做不完登记后到实验室补做。今天的产出是三样东西,不是一张好看的截图
| 维度 | 权重 | 看什么 |
|---|---|---|
| 主流程完整 | 30% | 入口→通关可重复、无报错、失败可恢复 |
| 交互实现 | 25% | 抓取(attach())· 放置判定(阈值 + 槽位)· UV 命中 3D UI · 顺序校验(S.step) |
| 人因与可访问性 | 20% | 三件套测过几条;免手柄通路覆盖边界说清楚;取舍理由 |
| 舒适与退出 | 15% | 三条退出路至少一条、报出用时;默认传送 + Snap |
| 诚实与文档 | 10% | README 写明已知简化与覆盖不到的地方;不确定信息标 【待补充】 |
| # | 情况 | 为什么不算 |
|---|---|---|
| 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) 委托 |
| # | 要打勾的 |
|---|---|
| ① | 白板五行已写好:本课命题 / 三件套参数 / 达标五条 / 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 台轮转 |
一句话口径(板书就写这一句):路子不通、或退不出去的作品,画面再好看也不算完成。
M3 是 11-11 第 9 次课的交件,卡住谁不能往下走——不过此关,作品不算完成。判定只看三样,不看画质、不看功能数量。
| # | 判定项 | 过 | 不过 |
|---|---|---|---|
| A | 主流程可玩(硬门槛) | 从入口到通关,能连走两遍,两遍结果一致;控制台无 JS 报错 | 中间有任何一步"只能靠老师帮你跳过";或第一遍能过、第二遍状态残留导致过不去 |
| B | 一条免手柄通路 | 至少一条不用手柄也能推进的通路存在,并且能说清它覆盖到哪一步、覆盖不到哪一步 | 完全依赖手柄;或声称"支持免手柄"但说不出覆盖边界——说不清 = 不过 |
| C | 真机验证记录(硬门槛) | 用时 / 卡点 / 退出路三样齐全,卡点写了具体在哪一步 | 三项缺一;或卡点栏写"没卡"/"很顺利"——无信息量 = 不过 |
| 卡在哪 | 补做安排 |
|---|---|
| 卡在 A 主流程 | 第 10 次课课前 20 分钟一对一补;先查环境(三条通路),再查代码 |
| 卡在 B 免手柄通路 | 允许降级为"键盘快捷键通路"(PC 端可完成主流程 + 至少一处 VR 内免手柄),但必须在 README 写明取舍 |
| 卡在 C 真机记录 | 课后到实验室补做并补填【表 C】;不占用第 10 次课的 M4 时间 |
| 交什么 | 形式 | 交到哪 |
|---|---|---|
| ① 主流程可玩 | 截图 / 录屏 / 或下次课现场演示,证明"入口 → 通关"能连走两遍 | 【待确认:学生的提交路径与截止时间以教师当堂通知为准】 |
| ② 免手柄通路说明 | 【表 B】填满,必须写清覆盖到哪一步、覆盖不到哪一步 | |
| ③ 真机验证记录 | 【表 C】填满:用时 / 卡点 / 退出路(三样缺一不可) |
期末大作业十条硬门槛里,第 1 条就是"能进能退"(三条退出路至少试通一条),第 9 条是"可访问性:坐姿 / 单手 / 注视停留至少两条通路可用并能等价完成主流程,说明取舍"。M3 只是中途门槛。
好看和跑得动是两件事——帧预算是 13.9 ms,不是 16.7 ms
下次课的案例是 03 节奏竞技 · 编钟之韵(反馈、判定、程序化音频)。开场要用的,就是今天统计出来的东西。
| 要点 | 一句话 |
|---|---|
| 帧预算 | 72 Hz ⇒ 13.9 ms——不是 16.7 ms,因为浏览器合成要占时间 |
| 先看 DrawCall | 不要先看面数;手段是实例化 / 合批 / 贴图复用 / 阴影分辨率 |
| 动态降级 | L1 降像素比 → L2 关阴影,可逆 |
| 舒适度 | 隧道视野、默认传送 + Snap 45° |
| 今天记下的数别丢 | 今天抄的 FPS / DrawCall / 三角面下次课要用;读数必须和页面 HUD 对得上 |
| 时间 | 里程碑 | 交付物 |
|---|---|---|
| 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 |