门槛管“能不能算完成”
11 条硬门槛是闸门。一条不过 → 本作品记“待整改”,不进等级栏;3 个工作日内补交,补交合格后上限记“合格”,且不能进优秀作品推荐。
第 14 教学周 · 4 学时 / 180 分钟 · 期末大作业(个人 WebXR 作品,占总评 40%)当场路演 · 无上机考试 —— 这节课的组织问题不是“讲什么”,而是“怎么并行、怎么计时、谁来判”
十一次课的结果,今天要在一个 180 分钟的上午全部落地:40 个人、每人 3.5 分钟、当场判定
从第 7 次课的选题一页纸,到第 8 次课的交互验证 + 模型管线作业(一页版),到第 9 次课的主流程可玩、第 10 次课的性能报告、第 11 次课的功能封版——这条线上每一个里程碑都是在为今天做减法。到了今天,学生手上有的是一个已经封版、只修错不加功能的作品目录,和一次必须当众把它跑起来的 3.5 分钟。
所以这一课的组织问题不是“讲什么”,而是“怎么并行、怎么计时、谁来判”。40 个人依次上台,光讲就要 140—160 分钟,装不进 180 分钟;而“量规与硬门槛一个字不降”“40 个人都要上台讲自己的作品”这两条底线又不能动。答案只有一个:把 40 人拆到 4 个验收点上去并行,两轮换手,人人既当路演者也当互评员。
| 时段 | 时长 | 内容 | 谁主持 |
|---|---|---|---|
| 0:00—0:10 | 10′ | 开场:验收口径(量规 + 11 条硬门槛)· 分组与场地确认 · 计时规则(超时举牌、到点即停,停后不再加分)· 四条安全规矩。4 组同步收听;若分组后听不见,由评审组长复述一遍 | 教师 |
| 0:10—1:20 | 70′ | 【本轮 A】4 个验收点并行:每组 10 人路演(各 3.5′)+ 另 10 人当互评员 | 4 名评审组长 + 教师巡回 |
| 1:20—1:30 | 10′ | 课间(头显摘下放桌上,不放椅子上)· 同时完成 A→B 换场 | 学生管理员 |
| 1:30—2:40 | 70′ | 【本轮 B】4 个验收点并行:换手——上一轮的互评员上台路演,上一轮的路演者当互评员 | 同本轮 A |
| 2:40—2:55 | 15′ | 优秀作品集中复盘(4—5 人):每人 3′ 讲 + 教师 1 句点评,回到“为什么必须 VR”这一栏 | 教师 |
| 2:55—3:00 | 5′ | 课程总结(回到第 1 次课的“空间智能”展望)· 大作业展示区上线 · 达标名单 · 归档说明 | 教师 |
| 合计 180′ | 10 + 70 + 10 + 70 + 15 + 5 = 180 | ||
两个计时锚点必须准:0:10 与 1:30。误差超过 5′ 就启用降级预案,不临场商量。
11 条硬门槛是闸门。一条不过 → 本作品记“待整改”,不进等级栏;3 个工作日内补交,补交合格后上限记“合格”,且不能进优秀作品推荐。
7 维 100 分是刻度。门槛全过之后,量规分才决定优秀 / 良好 / 中等 / 合格。量规分再高,门槛不过就是“待整改”。
“待核”只在设备 / 场地致因时使用(例如全场网络故障导致无人能进 VR),由教师课后抽检补判,不得用于掩盖学生自身问题。
40 个人都要上台,还要有人当评委——这两件事能同时成立,靠的是“每人既是路演者也是互评员”
| 算法 | 结果 |
|---|---|
| 40 人 × 4 分钟(设计给的演示时长) | 160 分钟纯讲,另加换场、上下台、抽检戴头显 —— 180 分钟装不下 |
| 40 人 × 3.5 分钟(本课默认) | 140 分钟,留出 40 分钟给开场、课间、复盘与总结 —— 刚好 |
| 40 人 × 3 分钟(只投屏、不戴头显) | 120 分钟,可作为降级预案 |
结论就是一句话:本课的组织问题不是“讲什么”,而是“怎么并行、怎么计时、谁来判”。
| 分组 | 人数 | 0:10—1:20(本轮 A) | 1:30—2:40(本轮 B) |
|---|---|---|---|
| 第 1 组(验收点 1) | 10 | 路演(各 3.5′,合计 35′) | 换到验收点 2 当互评员 |
| 第 2 组(验收点 2) | 10 | 在验收点 1 当互评员 | 路演(各 3.5′) |
| 第 3 组(验收点 3) | 10 | 路演(各 3.5′) | 换到验收点 4 当互评员 |
| 第 4 组(验收点 4) | 10 | 在验收点 3 当互评员 | 路演(各 3.5′) |
| 工具 | 规则 |
|---|---|
| 计时器(手机秒表即可,由评审组长持有) | 3.5 分钟到点举牌;到点即停,停后内容不计分,但不打断已经开始的退出动作(退出没走完不能算完成,见硬门槛 1) |
| 提示牌(三张) | 剩 1 分钟 / 剩 30 秒 / 停。牌面朝学生,不出声——出声会打断演示 |
| 时段总控 | 每 10 人一轮 = 35′,加 5′ 缓冲 = 40′ 为一格;0:10 与 1:30 两个锚点必须准,误差超过 5′ 就启用降级 |
2:40 的优秀复盘段(15′)——不在路演段里挤别人的时间。| 情况 | 处理 |
|---|---|
| 全组 10 人齐 | 每人的互评员 = 同组名单里紧邻的 2 人(第 i 位由第 i±1 位评),每人实际收到 2 份互评 |
| 有人缺席 | 评审组长现场顺延一位,保证每位路演者都有 ≥2 名互评员 |
| 缺评员多于 2 人 | 评审组长顶上,并由教师补一句评语(这条不占互评分) |
| 项 | 标准配置(4 个验收点) | 每点最低要求 |
|---|---|---|
| 场地 | 4 个能同时容纳 20 人、能出声、能投屏的空间 —— 【待确认】 | 一个验收点 = 一张长桌 + 一块可投屏的屏(或一台大显示器) |
| 投屏 | 每个验收点 1 路(建议先试“笔记本全屏 → 大屏”;不通则“3 台笔记本并排、同学分片围观”,沿用第 6 次课土办法) | 一路投屏;实在没有 → 走降级预案 |
| 头显 | 型号与数量 【待确认】(【待补充】实际数量后定抽查比例) | 见下面两种并行评审预案 |
| 网络 | 不依赖——全场按“三条通路”选定的那一条走(首选 USB + adb reverse,完全不过网络,教室 AP 隔离也不怕) | 一条走通的通路 |
| 电源 | 4 个验收点的笔记本 + 头显充电位不跳闸 | 分两批插,或让学生课前充满 |
| 白板 / 屏 | 每个验收点一张验收点记录卡(本组 10 人名单 + 硬门槛勾选栏 + 计时锚点) | —— |
xr-data.json 佐证。取证首选头显系统截屏 → USB 导出,不占网络;投屏只用 4 路,不要人人投。xr-data.json;教师课后按 20% 比例抽检。| 触发 | 降到什么程度 | 代价 |
|---|---|---|
| 只剩 2 个验收点 | 2 组 × 20 人、每人 3 分钟、只投屏(不戴头显);每组 1 名组长 + 教师两点巡回。时间账:20 × 3′ × 2 轮 = 120′ + 开场 10′ + 课间 10′ + 复盘 20′ + 收束 5′ = 165′ | 每人少 30″;互评压缩为“每人评 2 人” |
| 只剩 1 个验收点 | 全班 40 人顺序路演,每人 3 分钟;取消现场互评(改课后在线);取消优秀复盘段(改为把作品发群) | 互评与复盘丢失;“人人上台”这条底线仍然保住 |
| 完全没有投屏 | 3 台笔记本并排摆在讲台上、同学分片围观;或头显回显投到笔记本 | 围观体验差,评审组长需走动听 |
| 头显不够 / 坏机 | 走预案二;再不足则每点 1 台,抽查降为每点每轮 1 人(全场抽 8 人) | 抽检覆盖率下降 |
| 全场网络故障 | 全班切到通路 ① USB 直连(不走网络);同时砍掉互评(改课后) | 互评改课后 |
| 头显全不可用 | 改为“每人 3 分钟只投屏”,但硬门槛 3 记“待核”,由教师课后逐个抽检(含退出用时),抽检通过才算过 | 当场判不了门槛 1 |
| 0:10 未按时开始 / 首格超时 >5′ | 每人降到 3 分钟(30″ 说 + 75″ 演示 + 45″ 说改动 + 30″ 缓冲);优秀复盘压到 10′ | 演示段被压得最狠 |
| 全场只剩 120 分钟 | 每人 2.5 分钟;取消优秀复盘段;互评改课后在线 | 复盘丢失 |
| 全场只剩 90 分钟 | 每人 2 分钟;取消互评与复盘;硬门槛抽查改课后(凭 M3 记录 + JSON + 课后抽检) | 只保住“上台 + 门槛口径” |
| 时间不足且无法两轮换手 | 改为“每人只讲一次”:4 组各 10 人在同一格内全部讲完(每人 3.5′ = 35′/组,两个验收点各承担 2 组 = 70′/点)——互评整体改为课后在线 | 互评丢失 |
持计时器与三张提示牌;11 条硬门槛逐条勾“过 / 不过 / 待核”,不过必须写一句原因(环境 / 作品 / 设备);要求学生当场指认并演示交互;亲自在控制台敲一遍 window.XX.S;把面板上的 FPS / DrawCall / 三角面抄进评分表;现场切一次坐姿 / 单手 / 注视停留并让他用它走一段。组长只打维度分、只勾硬门槛事实——“待核”与最终等级由教师定。
【待补充】4 名评审组长(学生管理员)名单;建议从 M3 真机验证中表现最稳、且作品已完成的学生里指定。
在 4 个验收点之间巡回,每点每次停 ≤6′,重点看四件事:① 每组前 2 人是否按 3.5′ 节奏走(前 2 人是全场的节奏样板);② 硬门槛 1 / 7 / 8 的现场证据(退出用时、四项舒适度开关、优化前后读数——这三条最容易“嘴上说做了、现场拿不出”);③ 哪些人卡在“环境”上(“六项不绿”是最高频故障,先解决环境,不要看作品代码,不让全班等一个人);④ 物色 2:40 复盘段的 4—5 人。
用同一份量规,至少完整跟 4 位同学,只打维度分、必须写“下一步改进”。互评表不当场公布,随作品归档,不进总分。
课前 30 分钟与教师一起做场地、设备、网络、白板检查;课间负责 A→B 换场与头显交接。
每个人上台一共 210 秒。哪一段超时,这一格必崩——所以先把这 210 秒背下来
| 段 | 时长 | 说什么 | 学生最容易犯的错 |
|---|---|---|---|
| ① 说做什么 | 30″ | 一句话:给谁用 · 解决什么 · 为什么必须 VR | 讲背景讲了一分钟,还没进作品 |
| ② 演示 | 90″ | 打开作品 → 点「进入 VR」 → 走主流程(跳过装饰性内容)→ 顺手带出一处“只有头显才能成立”的体验 | 边演示边解释每一步代码 |
| ③ 说改动 | 60″ | 我改了哪几处 · 为什么这么改 · 卡在哪一环(环境 / 作品 / 设备) | 只说“我做了很多”,说不出取舍 |
| ④ 缓冲 | 30″ | 上下台、换人、评审组长补问一句 | —— |
合计 30 + 90 + 60 + 30 = 210 秒 = 3.5 分钟。每一格的 35′ 就来自 10 人 × 3.5′。
| 段 | 照着说(空处照填) |
|---|---|
| ① 30″ | “我做的是____,给____用。它解决的是____。这件事用视频或普通网页 3D 做不到,因为____。” |
| ② 90″ | “现在进 VR。第一步____;这里绕到背后/钻进去/双手协同____,这一处只有戴着头显才成立。” |
| ③ 60″ | “我这次改了__处:第一处是____,因为____;第二处是____,因为____。我遇到最大的问题是____,后来发现是(环境/作品/设备)的问题。” |
| ④ 30″ | —— |
不要在台上等加载。
评审要敲 window.XX.S。
去掉书签栏一类的干扰。
微信、聊天框先关掉。
退出没走完不算完成(硬门槛 3)。
第 1 遍看超时;第 2 遍看演示段卡不卡;第 3 遍看第 ③ 段能不能说出一处取舍。
门槛是闸门,不是扣分项。判定结果只有三档:过 / 不过 / 待核;“我知道有这个功能”不算过,要现场拿得出
下表的“怎么算过”一栏,就是学生自查卡上的自查口径,与《期末大作业任务书(学生用)》第二节的 11 条门槛逐条对应,不另立一套。
| # | 门槛 | 怎么算过(一行自查) |
|---|---|---|
| 1 | 课堂作业 | 随课完成的课堂作业,各写一段描述性内容(做了什么 / 用了什么技术 / 遇到什么 / 怎么解决),写进 Word 文档 |
| 2 | 方案已确认 | 微信把要做内容发给教师并得到确认;方案里能逐条列出 ≥10 种交互方式、并说明用到的模型资产。没有确认过的方案,作品不算数。 |
| 3 | 能进能退 | 在头显里进入 VR → 走完主流程 → 三条退出路至少试通一条并报出用时。“退不出去的作品不算完成。” |
| 4 | 零外部网络依赖 | 拔网线 / 关 WiFi 仍能跑;不引任何 CDN;依赖库放同目录或内联进 HTML。(引用 assets/vr-2026/… 站内相对路径不算 CDN) |
| 5 | 无报错 | 打开控制台没有红色 JS 报错;主流程能从头到尾连走两遍(“两遍”是两次从头到尾,不是刷新两下)。 |
| 6 | 为什么必须 VR | 至少一处只有 6DoF / 立体视觉才能成立的体验(绕到背后看 / 钻进去 / 真实尺度 / 双手协同),并在 README 里写清。纯全景漫游(无交互)不过。 |
| 7 | ≥10 种交互 + 模型资产 | ≥10 种可指认、可演示的交互(抓取 / 射线点按 / 传送 / 3D 面板按钮 / 投掷 / 双手缩放…),各有提示;作品里确有模型资产(GLB / GLTF 导入或程序化建模);PC 与 VR 两端都能走完主流程。“单端能走”不过。 |
| 8 | 有目标、有反馈、进度可见 | 状态集中在一个对象里,能在控制台用 window.XX.S 查到(XX 换成你自己的全局名),并且看得到与画面一致的进度字段。 |
| 9 | 舒适度(四项齐全) | 默认传送 + Snap 45°;有隧道视野、眼高显示、一键重置、10 分钟休息提示。四项逐个点一遍,缺项即不过,不看它是否“本来就不需要”。 |
| 10 | 性能 | 有实时性能面板(FPS / 帧时间 / DrawCall / 三角面);移动头显三角面 ≤ 10 万;至少一处有前后对照的优化。读数与页面 HUD 必须一致——编数据比做不出来更严重。 |
| 11 | 可访问性与诚实 | 坐姿 / 单手 / 注视停留至少两条通路可用,能等价走完主流程并说明取舍;涉及真实信息不确定的一律写 【待补充】,不许编,README 里写明“已知简化 / 占位说明”。 |
| # | 典型的“不过”(一票否决) | 现场动作 |
|---|---|---|
| 1 | 文档里课堂作业缺段、或只列标题没有内容 | 翻 Word 文档逐段核对,缺段即“待整改” |
| 2 | 方案没在微信上确认过;或确认的方案里交互不足 10 种、没有模型资产 | 核对教师的确认记录与方案原件 |
| 3 | 进不去 VR;或进得去退不出;或三条退出路全未实测 | 现场进入 + 退出一次,看计时器读秒,退出用时写进评分表 |
| 4 | HTML 里存在任何 CDN 外链(https://…/three.min.js、字体、图标库等) | 就地断开网络 + 清缓存 + 刷新;或直接检索提交文件里的 http:// / https:// 引用 |
| 5 | 控制台出现红色 JS 报错;或第二遍走不通 | 打开控制台走一遍,再走一遍。(浏览器自身的兼容性警告、WebXR 权限提示不算 JS 报错) |
| 6 | 去掉头显换成 360° 全景图或普通 3D 网页体验毫无损失;或 README 里没这一节 | 追问“这个体验在 PC 上看还剩多少?”答不出即不过 |
| 7 | 交互 <10 种;或作品里根本没有模型资产;或 PC 端走不完主流程 | 学生当场逐条指认并演示至少 10 种;打开 assets/ 看 GLB/GLTF 文件;再在 PC 端走一遍主流程 |
| 8 | 控制台里 window.XX.S 是 undefined;或状态散在十几个全局变量里、查不出进度 | F12 → 输入 window.XX.S → 回车,看得到与画面一致的进度字段才算过 |
| 9 | 默认平滑移动;或四项中缺任意一项(“后面加”不算) | 四项逐个点一遍:传送开关、Snap 开关、隧道强度、眼高读数(1.5—1.8 m 合理区间)、重置键、休息提示阈值 |
| 10 | 拿不出任何对照(改前改后都说不出数字);或读数与面板 HUD 对不上 | 面板读数当场抄进评分表,并与性能报告比对。本课只判“有没有面板、有没有对照、数字诚不诚实”,面板读数不等于真实帧率 |
| 11 | 两条通路都只是“能切开关”、切完走不完主流程;或编造校史、文物年代、机构名称 | 现场切一次:Shift+P 坐姿 · Shift+H 单手 · Shift+G 注视停留,并真的用它走一段;再抽查 README 的真实信息条目 |
当场可验证,证据留在《评分记录表》上。
当场记原因,作品按《待整改》处理——3 个工作日内补交,上限“合格”记分,且不能进优秀作品推荐。
只在设备 / 场地致因时使用(例如全场网络故障导致无人能进 VR),由教师课后用抽检补判,不得用于掩盖学生自身问题。
门槛管“能不能算完成”,量规管“完成得多好”。打分区间建议只用于减少各验收点之间的松紧差,不是教务规定;实际以整数分为准
| 维度 | 分值 | 优(满分) | 良(约 85%) | 合格(60%) | 不合格(<60%) | 打分区间建议 |
|---|---|---|---|---|---|---|
| ① 功能完备 | 25 | 主流程两遍无阻、无报错、边角也有兜底,进度与状态对得上 | 主流程两遍通,个别反馈缺失 | 主流程可用,个别功能失效 | 主流程断裂或功能明显缺失 | 22—25 / 19—21 / 15—16 / 0—14 |
| ② 美观度 | 20 | 视觉统一、有明确设计意图、动效克制准确、信息层级清楚 | 整体整齐,有一两处风格跳脱 | 看着整齐,但没设计过 | 明显拼凑、风格冲突 | 18—20 / 15—17 / 12 / 0—11 |
| ③ 交互与人因 | 15 | ≥10 种交互各有 affordance(高亮 / 悬停 / 幽灵提示),有模型资产,PC 与 VR 等价,可访问性两条通路且说得出取舍 | ≥10 种,个别无 affordance | 7—9 种,个别两端不等价 | <7 种或单端 | 13—15 / 11—12 / 9 / 0—8 |
| ④ VR 学科理解 | 12 | 讲得清 3I(沉浸 / 交互 / 构想)、临场感要素、晕动机制,并落到自己的改动里 | 三点都说得出,只有一处落到改动 | 能复述要点 | 只是“3D 网页” | 11—12 / 9—10 / 7 / 0—6 |
| ⑤ 性能与工程 | 10 | 达 72Hz / 13.9ms 帧预算意识,有降级手段与优化对照,状态机清晰,能导出体验数据 | 有对照,降级只讲未实测 | 知道看面板,未优化 | 不看性能 | 9—10 / 7—8 / 6 / 0—5 |
| ⑥ 演示与文档 | 10 | 模板规范、讲清“做了什么、为什么”,README 诚实完整(改了什么 / 怎么运行 / 已知简化 / 占位) | 讲得完整,取舍说得笼统 | 讲得完整但说不出取舍 | 讲不清 / 无文档 | 9—10 / 7—8 / 6 / 0—5 |
| ⑦ 课堂作业 | 8 | 6 段描述性内容齐全,每段都有技术细节与问题解决过程 | 6 段齐全,个别偏简 | 写了但偏流水账 | 缺段 / 只列标题 | 7—8 / 6 / 5 / 0—4 |
量规口径与学生用任务书完全一致:功能完备 25 + 美观度 20 + 交互与人因 15 + VR 学科理解 12 + 性能与工程 10 + 演示与文档 10 + 课堂作业 8 = 100。门槛第 7 条要求 ≥10 种交互 + 模型资产;量规要拿高分,还需要每种交互都有提示、PC/VR 等价、可访问性说得清取舍。
| 原来的加分项 | 现在算在哪 |
|---|---|
| 智能交互(LLM) | 并入「交互与人因(15)」与「VR 学科理解(12)」——做出来就是分数,不需要靠加分兜底;仍须有离线降级兜底,Key 不写在前端 |
| AR 虚实融合(手机端 WebXR) | 并入「VR 学科理解(12)」与「交互与人因(15)」 |
| 思政题材 | 并入「VR 学科理解(12)」——题材真实、信息诚实、不是贴标签 |
| 总分区间 | 等级 | 附加条件 |
|---|---|---|
| 90—100 | 优秀 | 且 11 条硬门槛全过;优先进入优秀作品推荐(须作者授权) |
| 80—89 | 良好 | 且 11 条硬门槛全过 |
| 70—79 | 中等 | 且 11 条硬门槛全过 |
| 60—69 | 合格 | 含“待整改补交后上限记合格”者 |
| <60 | 不合格 | —— |
| 任意分数 | 待整改 | 只要有一条硬门槛 ✗,无论总分多少,先记“待整改”;3 个工作日内补交,按硬门槛口径重判,上限记“合格” |
| 任意分数 | 待复核 | 有硬门槛为 ?(场地 / 设备致因);教师课后抽检补判,不得用于掩盖学生自身问题 |
路演前把控制台打开,评审组长会当场敲一次 window.XX.S(XX 换成你自己声明的全局名,具体变量名以 README 声明为准)。看得到与画面一致的进度字段才算过。
F12 → Console → window.XX.S → 回车
期望:{ goal: …, step: …, progress: …, score: … } ← 与画面 HUD 一致
若为 undefined:硬门槛 8 不过
作品压缩包(四件套 + 模型资产)11-25 前微信发教师;Word 文档 12-02 前两节课交;目录名一律 ASCII 学号
| # | 交什么 | 具体要求 | 何时 / 怎么交 |
|---|---|---|---|
| 1 | 作品目录 | index.html + 依赖文件(如 three.min.js)+ assets/ 里的模型资产(GLB / GLTF);能离线跑 | 2026-11-25 前 打成 <学号>-<姓名>.zip微信发给教师 (不用 FTP) |
| 2 | README.md | 四行就够:我改了什么 · 为什么这么改 · 怎么运行 · 哪里还没做完;另需“已知简化 / 占位说明”一节 | |
| 3 | cover.jpg | 1280×720;能看出作品是什么(不要纯色、不要截图里带浏览器地址栏) | |
| 4 | xr-data.json | 从作品里导出的体验数据;必须是这次作品真跑出来的,不要手工编 | |
| 5 | Word 文档 | 按下周发布的大作业模板(封面与详细格式):课堂作业各一段 + 方案说明(≥10 种交互、模型资产清单)+ 实现与取舍 + 已知简化 | 2026-12-02 前两节课 按课堂要求提交 |
assets\vr-2026\student\works\
├─ index.html ← 大作业展示区列表页(教师维护,你不用动)
├─ three.min.js ← 全班共用一份 three.js(r128 UMD)
└─ <学号>\ ← ★ 目录名一律 ASCII 学号,例如 2023010101
├─ index.html ← 你的作品(依赖同目录,或内联成单文件)
├─ README.md ← 我改了什么 / 怎么运行 / 已知简化 / 哪些是占位
├─ cover.jpg ← 封面 1280×720
└─ xr-data.json ← 体验数据导出
| 项 | 规则 | 反例(会被退) |
|---|---|---|
| 目录名 | 一律 ASCII 学号,10 位数字,不带空格、不带中文、不带 () | 张三 · 张三_作品 · 2023010101(终版) |
| 主文件 | 必须叫 index.html(小写) | Index.html · 作品.html · main.html |
| 封面 | 必须叫 cover.jpg(小写扩展名)、1280×720 | 封面.png · cover.JPG · 名叫 cover.jpg 实际是 1920×1080 |
| 数据 | 必须叫 xr-data.json | data.json · 体验数据.json |
| 中文姓名 | 写在页面里和 README 里,不要放进目录名 | —— |
| 依赖库 | 同目录相对路径引用(./three.min.js) | C:\Users\...\three.min.js 绝对路径 · https://cdn... |
<学号>-<姓名>.zip,2026-11-25 前微信发给教师;由教师统一部署到 assets/vr-2026/final-works/<学号>/,并加入大作业展示区。学生不需要自己上传服务器,也不需要 FTP 账号。_files 文件夹,只发 .html 给老师 → 单独打开必然白屏。这是历届最高频的事故。assets/vr-2026/final-works/<学号>/,并在 final-works/works.json 里加一条记录;学生交付\<学号>\(教务留痕的正本——站点可能改版);待整改者的补交件单独放 学生交付\_补交\,并在评分表上标补交日期。assets/vr-2026/final-works/。页面是数据驱动的——作品为空时显示空态,收作业后只需在 works.json 里加条目,不必改 HTML。当前应为空(0 份),2026-12-02 集中展示后陆续上线。xr-data.json 怎么被读提交的 JSON 不是收上去压箱底的——教师会用它交叉验证学生自报的读数与完成度,把“路演那一刻的表现”变成“可复算的过程证据”。
| 字段组 | 关键内容 |
|---|---|
| 会话 | 会话时长 · 帧率分布 · 晕动暴露时长(平滑移动累计)· 瞬移次数 · 交互次数 |
accessibility | 当次使用的姿态(坐 / 站)· 惯用手 · 单手模式 · 注视停留开关 |
goals | XRCore.goal() 写入的成就:04 导览打卡评级、06 小测验得分与难度分布,同 id 覆盖不重复 |
| 步 | 动作 | 判什么 | 不合格 / 存疑怎么处理 |
|---|---|---|---|
| ① | 能打开 | 是不是合法 JSON(不报解析错) | 打不开 / 空文件 → 当场请他重新导出 |
| ② | 对身份 | 是不是本人本次作品导出的 | 对不上 → 记“待补”,不得直接采信学生口头数字 |
| ③ | 对读数 | 自报读数与 HUD 是否一致 | 对不上,按硬门槛 10 不合格处理——编数据比做不出来更严重 |
| ④ | 对交互 | “≥10 种交互”是否真被用过(用交互次数反推) | 交互次数过少却自称 ≥10 种 → 记为存疑,当场逐条追问他演示了哪几种 |
| ⑤ | 对完成度 | goals 里有没有一条完整的成就记录 | 没有任何 goals → 不能证明完成度;让他补跑一次并重新导出,仍无则交 M3 真机记录交叉印证 |
| ⑥ | 对可访问性 | 两条通路是“真测过”还是“只是切了开关” | 字段显示从未切换 → 当场切一次并真的走一段,否则硬门槛 11 记不过 |
| ⑦ | 归档 | 把结论一句话写进评分表备注栏 | —— |
它可能恰恰说明学生认真测试了平滑移动。该字段只用于复盘,绝不参与排名。
XRCore.goal() 写入的 04 打卡评级与 06 小测得分是完成度的硬证据,用于“功能完整 25”与“演示与文档 20”的判档。
DrawCall / 三角面只是渲染规模指标,真机瓶颈常在填充率与纹理带宽。FPS 与降级等级只记录,不作门槛。
window.__xrDump(VR 沉浸模式下也能取到)。导出失败时,当场在控制台敲 copy(JSON.stringify(window.__xrDump)) 兜底。这一节照学生用任务书第九节原样写,一个字不加;括号里是自查动作
| 坑 | 表现 | 怎么避 |
|---|---|---|
file:// 打开 | 没有「进入 VR」按钮 | 走三条通路之一 |
| 「网页另存为(完整)」 | 单独打开白屏 | 只存「仅 HTML」或下载原件 |
| 引用 CDN | 有网能跑,机房断网白屏 | 库放本地同目录 |
disabled / hidden 被冻进 HTML | 按钮显示“进入 VR”却点不动 | 运行时会被 JS 改的状态,代码里都要显式设一遍,别依赖 HTML 默认值 |
| 两套 three.js 混用 | 直接白屏 | UMD 版(全局 THREE)和 ESM 版(import)不能互换 |
| 沉浸模式下 DOM 看不见 | 面板消失了 | 面板要做成场景里的 3D 物件,不能用网页浮层 |
| 数字对不上 | 报告里的读数和页面 HUD 不一致 | 编数据比做不出来更严重 |
file:// 打不开 WebXR。“先怀疑环境,再怀疑代码。”disabled 那一条的意思是:只要 JS 会在运行时改这个状态,就必须在代码里显式设一遍(el.disabled = false),不要指望 HTML 里写成什么样就是什么样——冻结进 HTML 的默认值会让学生误判成“按钮点不动”。| 通路 | 怎么做 | 安全上下文 | 备注 |
|---|---|---|---|
| ① USB(首选) | 数据线连头显,跑 adb reverse tcp:8080 tcp:8080,头显浏览器开 http://127.0.0.1:8080/ | ✅ 天然 | 不走网络,校园网 AP 隔离也不怕;需开发者模式 + adb |
| ② 局域网 + 白名单 | 电脑跑本机服务器;头显在 chrome://flags/#unsafely-treat-insecure-origin-as-secure 里填 http://电脑IP:端口 | ⚠️ 要配 | 适合反复调试;IP 一变就要重填 |
| ③ 站点 https | 作品交到课程站点的学生作品目录,头显直接打开链接 | ✅ | 零配置,收作业与互评首选 |
| # | 退出路 | 怎么算过 |
|---|---|---|
| 1 | 注视(或射线)点「退出」按钮 | 视线停在按钮上,等到进度填满即退出 |
| 2 | 长按握把键 2 秒 | 手柄握把按住不放,满 2 秒退出 |
| 3 | 系统键返回 | 头显系统键 → 返回,即离开沉浸会话 |
先看清自己前后左右有没有人(尤其身后)。
要移动用传送。
不用报告、不用忍。晕了硬撑是唯一会被批评的做法。
每人一副一次性眼罩,用完即丢。
【待补充】,不许编造(硬门槛 11);今天没有上机练习,“实操”就是走完这六步;每一步都有明确的动作与责任人
window.XX.S 查验、性能读数抄录、可访问性现场切一次并走一段。| 时段 | 查什么 | 通过标准 |
|---|---|---|
| 场地 20′(逐个验收点走一遍) | 4 个验收点都能同时容纳 20 人,有一张长桌、一块屏;座位之间能侧身通过;所有插线板贴边走,不横穿通道 | 4 个点各贴一张《验收点记录卡》(本组 10 人名单 + 硬门槛勾选栏 + 0:10 / 1:30 两个计时锚点) |
| 设备 15′ | 头显全部充满电(≥70%);手柄装挂绳、电池有电;面罩与镜片已擦;一次性眼罩 ≥40 片(轮转预案下再加消毒湿巾一包、擦镜布一包) | 数据线 ≥4 根;adb 或 serve.bat 在每台验收机上可执行;按头显数量定预案(【待确认】) |
| 网络 5′ | 三条通路实测并选定一条:① USB + adb reverse(首选)② 局域网 http + 头显白名单 ③ 站点 https | 每个验收点各走通一次;打开《VR 作品自检》页确认环境项可读 |
| 文档与表格(打印装订) | 《评分记录表》× 4 · 《学生提交清单与自查卡》× 40 · 《验收点记录卡》× 4 · 《互评表》× 40 · 提示牌 × 4 套 · 计时器 ≥4 个 | 备用充电宝 2 个 |
| 白板 / 屏(每个验收点都写这四行) | ① 量规 7 维:功能完备 25 · 美观度 20 · 交互与人因 15 · VR 学科理解 12 · 性能与工程 10 · 演示与文档 10 · 课堂作业 8② 11 条硬门槛(只写标题,判定口径在教师手里)③ 每人 3.5 分钟:30″ 说做什么 → 90″ 演示 → 60″ 说改动 → 30″ 缓冲,到点即停 ④ 四条安全规矩 | 四行都要写完 |
| 记录项 | 数值 |
|---|---|
| 应到 / 实到 | __ / __ |
提交齐全(作品 + README + cover.jpg + JSON)人数 | __ |
| 11 条硬门槛全部通过人数 | __ |
| 硬门槛未通过人数(分条统计见《评分记录表》) | __ |
| 现场戴头显实跑人数 / 抽检延后人数(“待核”) | __ / __ |
| 互评表回收份数 / 优秀复盘人数 | __ / __ |
| 实际使用的降级预案(无 / 一 / 二 / 三) | __ |
| 实际每人均时长(3.5′ / 3′ / 2.5′ / 2′) | __ |
三类卡壳统计:环境 __ 人 | 作品 __ 人 | 设备 __ 人。这三类数字要进“结课后遗留问题”归档条目。
交之前先把这张卡填完。填不完的,今天不要上台。
assets/ 模型资产),已在 11-25 前微信发给教师;规则:缺一条即不合格。自查栏打勾前,先看清“怎么算过”这一栏——“我知道有这个功能”不算过,要现场拿得出。
| # | 门槛 | 怎么算过(自查口径) | 我的证据 / 备注 |
|---|---|---|---|
| 1 | 课堂作业 | 随课完成的课堂作业,各写一段描述性内容(做了什么 / 用了什么技术 / 遇到什么 / 怎么解决),已写进 Word 文档 | 缺 __ 段;最难的一段是:____ |
| 2 | 方案已确认 | 方案已在微信上经教师确认;能逐条列出 ≥10 种交互,并说明模型资产(GLB / GLTF 或程序化建模) | 确认日期 __;交互 __ 种;资产 __ 个 |
| 3 | 能进能退 | 在头显里进入 VR → 走完主流程 → 三条退出路至少试通一条(① 注视 / 射线点「退出」按钮 ② 长按握把 2 秒 ③ 系统键)并报出用时 | 退出路 ___,用时 __ 秒 |
| 4 | 零外部网络依赖 | 拔网线 / 关 WiFi 仍能跑;不引任何 CDN;依赖库放同目录或内联进 HTML | 文件里 __ 处 http/https 外链(应为 0) |
| 5 | 无报错 | 打开控制台没有红色 JS 报错;主流程能从头到尾连走两遍 | 连走 __ 遍;报错 __ 处 |
| 6 | 为什么必须是 VR | 至少一处只有头显才能成立的体验(绕到背后看 / 钻进去 / 真实尺度 / 双手协同),并在 README 里写清 | 我的这一处是:______ |
| 7 | ≥10 种交互 + 模型资产 | ≥10 种可指认、可演示的交互(抓取 / 射线点按 / 传送 / 3D 面板按钮 / 投掷 / 双手缩放…),各有提示;作品里确有模型资产;PC 和 VR 两端都能走完主流程 | 交互 ①__ ②__ ③__ ④__ ⑤__ ⑥__ ⑦__ ⑧__ ⑨__ ⑩__ 资产文件是:____ |
| 8 | 有目标、有反馈、进度可见 | 状态集中在一个对象里,能在控制台用 window.XX.S 查到(XX 换成你自己的全局名) | 我的全局名是:window.___.S |
| 9 | 舒适度(四项齐全) | 默认传送 + Snap 45°;有隧道视野、眼高显示、一键重置、10 分钟休息提示 | 眼高读数 __ m;重置键 __;休息提示 __ 分钟 |
| 10 | 性能 | 有实时性能面板(FPS / DrawCall / 三角面);移动头显三角面 ≤ 10 万;至少一处有前后对照的优化 | 优化前 __ / 优化后 __;三角面 __ |
| 11 | 可访问性与诚实 | 坐姿 / 单手 / 注视停留至少两条通路可用,且能等价走完主流程;涉及真实信息不确定的一律写 【待补充】,README 写明「已知简化」 | 我用的是:___ + ___;占位 __ 处 |
| 遍次 | 只看什么 |
|---|---|
| 第 1 遍 | 有没有超时(超过 3.5′ 就是失败) |
| 第 2 遍 | 演示段有没有卡住(加载、找不到按钮、进不去 VR) |
| 第 3 遍 | 第 ③ 段能不能说出一处取舍(不只是“我做了很多”) |
① 你改了什么? ____________________ ② 为什么这么改? ____________________ ③ 卡在哪一环(环境 / 作品 / 设备)? ______________
九项逐条打勾。有一条打不上勾,就不要上台——先找评审组长说清卡在哪一环
| # | 检查项 | 怎么算过 |
|---|---|---|
| 1 | 四件套齐 + 文档 | index.html / README.md / cover.jpg(1280×720)/ xr-data.json |
| 2 | 目录名是我的学号,纯 ASCII | 10 位数字,无空格、无中文、无括号 |
| 3 | 断网刷新一次,还能跑 | 拔网线 / 关 WiFi → 清缓存 → 刷新,主流程仍在 |
| 4 | 控制台没有红色报错 | 打开控制台走一遍主流程 |
| 5 | 我在控制台敲过 window.___.S,能看到进度 | 字段值与画面 HUD 一致 |
| 6 | 我知道退出路是哪一条、用时几秒 | 三条里试通至少一条,并记下秒数 |
| 7 | 我的 README 里有“已知简化”和 【待补充】 说明 | 四行 + 占位说明一节 |
| 8 | 我练过三遍 3.5 分钟 | 每遍掐表,第 3 遍能说出一处取舍 |
| 9 | 我把这十条自查都打过勾了 | 上一节的打勾表填完 |
协议不是安全上下文(file://、局域网 IP)、浏览器没给 immersive-vr、WebGL 不可用。先打开《VR 作品自检》看六项。
控制台有红色报错、主流程走不到结尾、读取依赖失败(两套 three.js 混用 / 依赖丢了)。
手柄没电、头显没电、数据线接触不良。“六项不绿”是最高频故障。
最后一次课要回答的不是“考什么”,而是“这 11 次课连起来是什么”
课程总结 5 分钟要回到第 1 次课的“空间智能”展望:从“用代码造世界”,到“把一个真实空间拍下来”,到“自己写一个能戴进去的空间叙事”,再到今天——你能对着一件自己做的 WebXR 作品,说清它给谁用、为什么必须 VR、你改了什么、卡在哪一环。
| 时间 | 里程碑 | 交付物 | 卡住谁不能往下走 |
|---|---|---|---|
| 10-14 课后 | 发布 | 任务书 + 选题清单发到课程主页 / 群 | 让学生有一周思考期 |
| 10-21 第 7 次课 | M1 选题定稿 | 一页纸(主题 / 为什么必须 VR / 用户 / 核心交互 / 技术点 / 降级方案) | 没有选题就没有后面五项 |
| 10-28 第 8 次课 | 课堂作业 3 | 交互验证 + 模型管线 + 许可卡(一页版)(M2 动线图/状态机图并入第 9 次课,口径待教师确认) | M2 口径以教师通知为准 |
| 11-11 第 9 次课 | M3 可玩(硬门槛) | 主流程可玩 + 免手柄通路 + 真机记录 | 不过此关,作品不算完成 |
| 11-18 第 10 次课 | M4 性能达标 | 优化前后对照 + 读数与 HUD 一致 | 戴进去才发现掉帧就来不及了 |
| 11-25 第 11 次课 | M5 功能封版 | 智能模块 + 降级方案 + 体验数据 JSON | 封版后只修错,不加功能 |
| 12-02 第 12 次课 | 交文档 · 集中展示 | 前两节交 Word 文档;后两节集中展示作品(作品已于 11-25 前微信发给教师) | —— |
index.html;assets/vr-2026/final-works/<学号>/,并在 works.json 加一条记录;学生交付\<学号>\(教务留痕的正本——站点可能改版);学生交付\_补交\,并在评分表上标补交日期。xr-data.json 原地保存,抽一份汇总进 过程数据汇总.csv(晕动暴露字段标注“不参与排名”);这一节的两类标注原样保留,不编造——补齐之后,本页与《第 12 次课》三份配套文档口径才算完全闭合
| 页面 / 文件 | 它替你回答什么 |
|---|---|
| 《VR 作品自检》 | 四项 WebXR 前提 + WebGL + 输入设备的六项状态;第 ②③④ 项有 ❌ 就先解决环境,不要去看自己的代码。点「生成自检报告」可截图或复制那段文字 |
| 大作业展示区 | 全班期末大作业作品列表:姓名 + 学号 + 提交日期 + 封面缩略图 + 「进入作品 →」,按学号升序,卡片带作品类型标签。当前为空(0 份),2026-12-02 集中展示后陆续上线 |
| 学生作品 · 联网自验工作流 | 里面的 serve.bat / serve.ps1 是零依赖本机服务器(只用 Windows 自带 PowerShell,不需要 Python / Node / 管理员) |
| vr-probe.js | 在自己的页面里加一行 <script src="vr-probe.js"></script>,即可显示 FPS / DrawCall / 三角面 / JS 报错。限制:DOM 面板在沉浸模式下看不见——低头能看到的那块 3D 面板才是头显里唯一看得见的读数 |
| 项 | 数值 | 它在哪儿用 |
|---|---|---|
| 总时长 | 180 分钟 / 4 学时 | 10 + 70 + 10 + 70 + 15 + 5 = 180 |
| 人数 / 分组 | 40 人 · 4 个验收点并行 · 每组 10 人 · 两轮换手 | 每个验收点一轮 20 人(10 人上台 + 10 人互评) |
| 每人时长 | 3.5′ = 210″(30″ + 90″ + 60″ + 30″) | 40 × 3.5′ = 140′;每格 35′ 路演 + 5′ 缓冲 = 40′ |
| 硬门槛 | 11 条,缺一条即不合格 | 判定三档:过 / 不过 / 待核 |
| 量规 | 7 维 100 分 | 25 + 20 + 15 + 12 + 10 + 10 + 8 |
| 三角面上限 | ≤ 10 万(移动头显) | 硬门槛 10;优化先看 DrawCall,不要先看面数 |
| 帧预算 | 72Hz = 13.9ms / 帧(不是 16.7 —— 浏览器合成要占时间) | 量规「性能与工程」的满分线 |
| 封面规格 | cover.jpg · 1280×720 | 提交物第 3 项 |
| 头显休息提示 | 10 分钟 | 硬门槛 9 的四项之一 |
| 眼高合理区间 | 1.5—1.8 m | 硬门槛 9 现场读数 |
| 补交期限 | 3 个工作日(【待确认】) | “待整改”的处理口径,上限记“合格” |
| 大作业占比 | 40%(平时 30% + 课堂作业 30%) | 成绩合成;无上机考试 |
| 快捷键 | 作用 | 现场怎么验 |
|---|---|---|
Shift+P | 坐姿(面板下沉 0.45 m) | 切一次,并真的用它走一段主流程 |
Shift+H | 单手模式 | 切一次并真的走一段(对抓取类交互最难保证等价) |
Shift+G | 注视停留 | 切一次并真的走一段 |
硬门槛 11 的现场动作就是:切一次,并真的用它走一段。“能切开关”不算过。最稳的两条是“坐姿 + 注视停留”。
| # | 项目 | 用途 |
|---|---|---|
| 1 | 【待补充】4 名评审组长(学生管理员)名单 | 建议从 M3 真机验证中表现最稳、且作品已完成的学生里指定;组长管计时、勾硬门槛、判交互条数、核 window.XX.S 与性能读数 |
| 2 | 【待补充】40 人分组名单(每组 10 人) | 按学号或按选题方向排;决定谁在第一轮上台、谁在第一轮当互评员 |
| 3 | 【待补充】40 名学生学号—姓名对照表 | 《评分记录表》打印用(自填:学号 / 姓名 / 选题方向三列) |
| 4 | 【待补充】优秀作品推荐名单 | 复习段当场产生的人选 + 评分表 ≥90 分者;须取得作者授权 |
| # | 项目 | 它决定什么 |
|---|---|---|
| 1 | 【待确认】上课地点与 4 个可并行验收场地的房间号 | 决定 4 个验收点能不能同时容纳 20 人、能不能出声、能不能投屏;也决定 1→2、3→4 的换场路线 |
| 2 | 【待确认】头显型号与数量 | 决定走预案一(头显 ≥40,“一人一台”)还是预案二(头显 ≈10,“10 台轮转”),进而决定每点的头显摆放与抽查顺序表 |
| 3 | 展示区收录节奏 | 展示区已建(assets/vr-2026/final-works/),当前 0 份;由教师在 works.json 增补条目。作品是否全部公开、是否需作者授权,由教师确认 |
| 4 | 【待确认】等级换算阈值 | 本页的 90—105 / 80—89 / 70—79 / 60—69 / <60 是建议换算,不是教务规定;若教务另有“五级制 / 百分制换算办法”,以教务为准;确认后请把阈值写死,避免各验收点松紧不一 |
| 5 | 【待确认】抽查戴头显实跑的人数比例(默认每组每轮 4 人) | 决定《验收点记录卡》上的抽查顺序表怎么填、每轮要预留多少设备占用时间 |
| 6 | 【待确认】待整改补交期限(本课默认 3 个工作日) | 决定“待整改”学生的补交窗口与评分表上的补交日期标注 |