① 课堂作业
- 对应各次课随课产出的课堂作业(第 8 次课为「交互验证 + 模型管线 + 许可卡(一页版)」;旧口径 M2 并入第 9 次课,口径待教师确认);
- 写成描述性内容,一个作业写一段;
- 写进大作业文档,不单独提交代码。
三部分:课堂作业(描述性内容)+ 自己设想的方案(≥10 种交互方式、必须有模型资产)+ 功能完备、越美观分越高的成品
十一条正文对应十一件事:先看清要交什么(一)、什么算合格(二)、怎么打分(三),再按时间与提交方式(四)一步一步做
这是期末大作业的学生用任务书,一个人一份。它不介绍新知识——新知识都在课页里;它只回答四个问题:交什么、什么算合格、什么时候交、怎么做才不会白做。
immersive-vr 会话完成主流程)。作品文件 2026-11-25 前交(微信发给教师,由教师统一上传到网站);2026-12-02 前两节课交 Word 文档、后两节课集中展示。不得直接提交演示案例 01–06(可复用其技术,但主题、完成度、交互数量必须明显不同)。| 节 | 讲什么 | 什么时候一定要看 |
|---|---|---|
| 一 | 一句话:你要交什么(三部分) | 现在(决定这一学期做什么) |
| 二 | 十一条硬门槛(缺一条就不合格) | 现在读一遍,11-25 提交前逐条再对一遍 |
| 三 | 评分量规:7 维 100 分 | 选题前(知道分从哪来)与展示前 |
| 四 | 关键时间与提交方式 | 现在就读:11-25 交作品、12-02 交文档 |
| 五 | 选题清单 8 个方向 + 不建议的方向 | 方案确认之前(写一页纸发给教师) |
| 六 | 三条通路 + 三条退出路 | 第一次上头显之前,以及每次进不去 VR 时 |
| 七 | 怎么交:微信发给教师、命名与目录规范 | 11-25 交作品之前必看 |
| 八 | 可以白拿的资产与性能口径 | 动手写代码的第一天(别从零造轮子) |
| 九 | 历届踩过的坑(7 条) | 调试不动的时候,先照这张表自查 |
| 十 | 安全与伦理 | 戴上头显之前;涉及真实信息、大模型 API 时 |
案例库用来读源码、当零件库;自检页用来在上头显前先确认环境;大作业展示区是全班期末作品的长期展示页——现在为空,2026-12-02 集中展示后陆续上线。
三部分:课堂作业 + 自己设想的方案 + 功能完备且美观的成品
课程的能力目标是「独立完成一个体现虚实融合 + 智能交互特点的 VR/AR 小项目」。所以你的作品要满足:能跑 · 能展示 · 体现「为什么必须用 VR」。
一个能在头显浏览器里打开、点「进入 VR」、走完主流程的页面。依赖放同目录或内联,断网也能跑。微信发给教师,由教师统一上传到网站。
Word 文件,用已发布的大作业论文模板(下载 docx,含封面与格式要求):课堂作业各一段 + 方案说明 + README 段落 + 过程与取舍。
集中展示 VR 作品:封面图 cover.jpg(1280×720)+ 体验数据 xr-data.json + 现场讲清做了什么。
不是加分项,是及格线。逐条配了「怎么算过(自查)」——能自己判,就不要等老师判
| # | 门槛 | 怎么算过(自查) |
|---|---|---|
| 1 | 课堂作业 | 随课完成的课堂案例各写一段描述性内容(做了什么 / 用了什么技术 / 遇到什么 / 怎么解决),写进大作业文档 |
| 2 | 方案已确认 | 微信把要做内容发给教师并得到确认;方案里能逐条列出 10 种以上交互方式、并说明用到的模型资产 |
| 3 | 能进能退 | 在头显里进入 VR,走完主流程,三条退出路至少试通一条并报出用时 |
| 4 | 零外部网络依赖 | 拔掉网线 / 关掉 WiFi 也能跑;不引任何 CDN,依赖库放同目录或内联进 HTML |
| 5 | 无报错 | 控制台没有 JS 报错,主流程能连走两遍 |
| 6 | 为什么必须是 VR | 至少有一处只有头显才能成立的体验(绕到背后看、钻进去、真实尺度、双手协同),并在说明里写清 |
| 7 | ≥10 种交互 + 模型资产 | 能逐条列出 ≥10 种交互(抓取 / 射线点按 / 传送 / 3D 面板 / 投掷 / 双手缩放 …),各自有提示;作品里确有模型资产(GLB/GLTF 导入或程序化建模);PC 和 VR 两端都要能走完主流程 |
| 8 | 有目标、有反馈、进度可见 | 状态集中在一个对象里,能用 window.你的名字.S 查到 |
| 9 | 舒适度 | 默认传送 + Snap 45°;有隧道视野、眼高显示、一键重置、10 分钟休息提示 |
| 10 | 性能 | 有实时性能面板(FPS / DrawCall / 三角面);三角面 ≤ 10 万;至少做一处有前后对照的优化 |
| 11 | 可访问性与诚实 | 坐姿 / 单手 / 注视停留至少两条通路可用并说明取舍;涉及真实信息不确定的一律写 【待补充】,不许编 |
第 4 / 5 / 9 / 10 / 11 条都能在电脑上先自查一轮:打开 《VR 作品自检》,看协议 / 安全上下文 / navigator.xr / immersive-vr / WebGL / 输入设备六项状态。环境项有 ❌ 就先解决环境,不要去看自己的代码。
「功能完备」与「美观度」单独占分——这正是本次要求里「越美观分越高、功能越强大分数越高」的落点
| 维度 | 分值 | 满分长什么样 |
|---|---|---|
| ① 功能完备 | 25 | 主流程两遍都通、无报错、自测通过;该有的功能一个不缺,边角场景也有兜底 |
| ② 美观度 | 20 | 界面、场景、动效、字体与色彩视觉统一;有明确的设计意图,不是「能跑就行」 |
| ③ 交互与人因 | 15 | ≥10 种交互且各有提示(高亮 / 悬停);有模型资产;PC 与 VR 等价;可访问性两条通路并说得出取舍 |
| ④ VR 学科理解 | 12 | 讲得清「沉浸 / 交互 / 构想」、临场感要素、晕动机制,而且这些理解体现在你的改动里 |
| ⑤ 性能与工程 | 10 | 达到 72Hz 帧预算意识、有降级手段与优化对照、状态机清晰、能导出体验数据 |
| ⑥ 演示与文档 | 10 | 模板规范、诚实完整;现场讲清「做了什么、为什么」 |
| ⑦ 课堂作业 | 8 | 描述性内容齐全,每段都写清做了什么、用了什么技术、遇到什么问题、怎么解决 |
XRCore.goal() 记下的成绩会随数据一起导出,可以证明你真的跑完了。| 维度 | 权重 | 优(满分) | 合格(60%) | 不合格 |
|---|---|---|---|---|
| 功能完备 | 25 | 主流程两遍无阻、无报错、边角也有兜底 | 主流程可用,个别功能失效 | 主流程断裂或功能明显缺失 |
| 美观度 | 20 | 视觉统一、有设计意图、动效克制准确 | 看着整齐,但没设计过 | 明显拼凑、风格冲突 |
| 交互与人因 | 15 | ≥10 种交互各有 affordance、有模型资产、PC/VR 等价、可访问性两条通路且说明取舍 | 7—9 种,个别两端不等价 | <7 种或单端 |
| VR 学科理解 | 12 | 能讲清 3I、临场感要素、晕动机制,并落到自己的改动里 | 能复述要点 | 只是「3D 网页」 |
| 性能与工程 | 10 | 达 72Hz 预算、有降级与优化对照、状态机清晰、数据可导出 | 知道看面板,未优化 | 不看性能 |
| 演示与文档 | 10 | 模板规范、讲清「做了什么、为什么」,诚实完整 | 讲得完整但说不出取舍 | 讲不清 / 无文档 |
| 课堂作业 | 8 | 内容齐全,每段有技术细节与问题解决过程 | 写了但偏流水账 | 缺段 / 只列标题 |
功能完备 25 + 美观度 20 + 交互与人因 15 + VR 学科理解 12 + 性能与工程 10 + 演示与文档 10 + 课堂作业 8 = 100。
不是「好不好看」的主观印象,而是四个可对照的点:视觉是否统一、有没有设计意图、动效是否克制、信息层级是否清楚。文档里要写你为美观做了什么。
原「智能交互 / AR / 思政 +5」已并入「交互与人因」与「VR 学科理解」——做出来就是分数,不必靠加分兜底。
作品 11-25 前交、文档 12-02 前两节课交、后两节课集中展示;不用 FTP
| 时间 | 交什么 | 怎么交 |
|---|---|---|
| 2026-10-20 | 大作业论文模板已发布 | 含封面与格式要求;在本页顶部与课程主页可直接下载 |
| 方案确认前 | 一页纸方案 | 微信把要做内容发给教师:主题 / 为什么必须用 VR / ≥10 种交互方式逐条列出 / 用到的模型资产 / 技术点 / 降级方案 |
| 随课 | 课堂作业 | 随课各一个;课内完成,课下整理成描述性内容写进文档 |
| 2026-11-25 前 | 大作业作品文件 | 微信发给教师,由教师统一上传到网站(不用 FTP);建议打成 zip 并写清文件名规范 |
| 2026-12-02 前两节课 | 大作业文档(Word) | 按已发布的模板与格式(下载):封面 + 课堂作业 + 方案 + README + 过程与取舍 |
| 2026-12-02 后两节课 | 集中展示 VR 作品 | 现场展示:讲清做了什么、为什么必须用 VR、技术点在哪;作品已由教师上传,可直接用网站演示 |
| 时间 | 事项 | 卡住谁不能往下走 |
|---|---|---|
| 2026-10-20 | 大作业论文模板已发布 | 没有模板就没有统一的文档格式 |
| 方案确认前 | 一页纸方案确认 | 方案没确认,作品不算数 |
| 随课 | 课堂作业 | 缺段就无法写完整文档 |
| 11-25 前 | 作品文件提交 | 过不了这条,等于没交作品 |
| 12-02 前两节 | Word 文档提交 | 文档缺失无法评分 |
| 12-02 后两节 | 集中展示 | 展示占「演示与文档」分 |
优先在你第 5—6 次课做的全景 / 3D 作品上长出一个可交互的段落——风险最低,也最容易被判「你真的做了」
| # | 方向 | 难度 | 亮点 | 主要风险 |
|---|---|---|---|---|
| 1 | 全景 + 交互混合 | ★ | 最快做出完整闭环 | 别停在「纯漫游」——第 5 章已经做过,不算作品 |
| 2 | 传统文化 VR 空间叙事(古建 / 文物 / 非遗) | ★★ | 沉浸感最强,思政契合 | 素材版权;史实不确定必须标占位 |
| 3 | 女性公共空间安全决策训练 | ★★ | 主题真实、社会价值高、与本学院定位最契合 | 情境要克制,重点是决策训练,不是惊吓体验 |
| 4 | VR 应急演练(消防 / 地震逃生) | ★★ | 有明确评分反馈 | 场景容易做大——限定一层楼 |
| 5 | VR 科学实验模拟 | ★★★ | 危险操作虚拟化,教学价值清晰 | 粒子 / 流体难做,做不出就成「看动画」 |
| 6 | VR 节奏 / 音乐互动(编钟、腰鼓、古琴) | ★★★ | 手柄触觉 + 程序化音频零素材 | 音频同步是硬骨头;课内做过,要有明显增量 |
| 7 | VR 数字展厅 / 博物馆导览(含智能讲解) | ★★ | 可复用全景素材 + 会讲解的 NPC | LLM 有延迟和幻觉 → 必须备离线兜底 |
| 8 | VR 口述史 / 校史空间 | ★★ | 用空间讲时间线,校本特色 | 真实信息多,占位纪律要严 |
| 方向 | 为什么这一学期做不完 |
|---|---|
| 高精度手势 / 手语识别 | 要自采数据、自己训模型 |
| 多人在线 VR | 网络同步本身是一门课 |
| 云 VR / 串流优化 | 依赖实验室网络 |
| 真实医学影像处理 | 跨专业代价高 |
| 依赖眼动 / 面部追踪 | 头显开放度有限 |
| 纯全景漫游(无交互) | 课内已经做过,硬门槛第 7 条(≥10 种交互)也过不了 |
想看真实完成度长什么样,可以翻 课堂作业墙(第 5 次课 15 份同学作品);想找可复用的实现,读 课内案例 01—06 案例库的源码——注意:只能当零件库,不能交它们本身。大作业展示区现在为空,2026-12-02 集中展示后上线,届时可对照同班同学的完成度。
先怀疑环境,再怀疑代码——这一节一半的价值在这句话上
WebXR 只在安全上下文里可用。用 http://电脑IP:8080 直接开,头显里看不到「进入 VR」按钮,学生会误判成「我代码坏了」。
file:// 不是安全上下文 → navigator.xr 是 undefined → 页面上根本没有「进入 VR」按钮。「装进头显」的正确说法是「在头显里通过 https / localhost / 白名单地址打开」,不是「把 html 拷进去」。| 通路 | 怎么做 | 要不要配 |
|---|---|---|
| ① USB(首选) | 数据线连头显,跑 adb reverse tcp:8080 tcp:8080,头显浏览器开 http://127.0.0.1:8080/ |
需开发者模式 + adb;不走网络,教室网络再怎么隔离都不怕 |
| ② 局域网 | 电脑跑本机服务器;头显在 chrome://flags/#unsafely-treat-insecure-origin-as-secure 里填 http://电脑IP:端口 |
要配;IP 一变就得重填 |
| ③ 站点 https | 作品交到课程站点的学生作品目录 | ✅ 最省事,收作业与互评首选 |
serve.bat / serve.ps1(不需要装 Python / Node,也不需要管理员权限)。file:// 打不开 WebXRWebXR 会调用摄像头、手柄、眼动、空间追踪等敏感能力,所以规范要求它只在安全上下文(secure context)里可用:https: / http://localhost / http://127.0.0.1 算,file:// 与局域网 http://192.168.x.x 都不算。
页面上没有「进入 VR」按钮,控制台里 navigator.xr 是 undefined。这不是你的场景做错了,是打开方式不对——换第 ① 或第 ③ 条通路即可。
把退出按钮做成场景里的 3D 物件,不是网页浮层——沉浸模式下 DOM 看不见(见第九节)。
手柄通路:不依赖视线、不依赖 UI,手边最顺手的一条。
头显系统自带的一层保险;但不能只靠它——它是最后手段,不是你的设计。
file:// 或局域网 IP?是就换通路;navigator.xr / immersive-vr 有 ❌ 就是环境问题;作品 11-25 前微信发给教师(教师上传网站,不用 FTP);文档 12-02 前两节课交 Word
把作品目录打成一个压缩包,文件名写成 <学号>-<姓名>.zip,11-25 前通过微信发给教师。压缩包内按下面的目录组织:
<学号>/ ├─ index.html ← 你的作品(依赖库同目录,或内联成单文件) ├─ README.md ← 我改了什么 / 怎么运行 / 已知简化 / 哪些是占位 ├─ cover.jpg ← 封面 1280×720 ├─ xr-data.json ← 体验数据导出 └─ assets/ ← 模型资产(GLB / GLTF 等)与贴图、音频
| 提交物 | 要求 |
|---|---|
index.html | 作品本体。可带同目录依赖,或内联成真单文件;断网也能跑 |
README.md | 四行就够:我改了什么 · 为什么这么改 · 怎么运行 · 哪里还没做完(含「已知简化」与事实占位说明) |
cover.jpg | 封面图,1280×720 |
xr-data.json | 体验数据导出(含 XRCore.goal() 记录的完成度 / 得分) |
assets/ | 模型资产(GLB / GLTF)与贴图、音频;硬门槛第 7 条要求作品里确有模型资产 |
assets/vr-2026/final-works/(收录清单在 final-works/works.json)。| 部分 | 写什么 |
|---|---|
| 封面与格式 | 按已发布的大作业论文模板(下载 docx;封面、字体字号、章节结构、图表规范) |
| 一、课堂作业 | 随课完成的课堂作业(第 8 次课为交互验证 + 模型管线 + 许可卡(一页版)),一个作业一段:做了什么 / 用了什么技术 / 遇到什么问题 / 怎么解决 |
| 二、方案说明 | 主题、为什么必须用 VR、≥10 种交互方式逐条列出、模型资产清单、降级方案 |
| 三、实现与取舍 | 关键实现、性能优化前后对照、可访问性取舍、为美观做了什么 |
| 四、已知简化 | 没做完的、占位的事实信息、后续可如何完善 |
_files 文件夹。
只发 .html 给老师 → 依赖全丢,单独打开必然白屏。<学号>-<姓名>.zip;index.html + README.md + cover.jpg(1280×720)+ xr-data.json,另有 assets/ 模型资产;课内已有的库、内核、案例与演示,全部可以直接用;接上内核,舒适度与可访问性门槛基本就达标
| 资产 | 拿到什么 |
|---|---|
three.min.js(r128 UMD) |
站点共用一份,作品用相对路径引用即可,别再复制 603 KB |
共享 XR 工程内核 _xr_core.js |
72Hz 帧预算 + 动态降级 · 隧道视野 · 传送 / Snap 范式 · 眼高校准 · 坐姿 / 单手 / 注视停留 · 体验数据导出 · 休息提示 · 成就闭环。你作品的舒适度与可访问性门槛,接它基本就达标 |
| 六个课内案例(01—06) | 当零件库和参考实现读源码,但不能交它们本身 |
《VR 作品自检》页 + vr-probe.js |
四项 WebXR 前提 / FPS / DrawCall / 三角面 / JS 报错,一行代码接入 |
| 性能演示 | DrawCall 对照实验室(101 次 → 2 次)· 移动 VR 性能预算计算器 |
| 可达性演示 | 从入口走几步 · 视锥可见性检查器 |
72Hz = 13.9 ms目标帧率是 72Hz,但每帧预算不是 16.7 ms——浏览器合成要占时间,所以按 13.9 ms 算。
一体机的算力与功耗都有上限,超过这个量级很容易掉帧。这是保险线,不是随便定的。
优化顺序:先看 DrawCall(提交了多少次绘制命令),再看三角面。同一个画面,100 个方块各交一次 → 101 次 DrawCall;合成一个 InstancedMesh → 2 次。
_xr_core.js把库放同目录,用相对路径引入。接上之后,传送 + Snap、隧道视野、眼高显示、休息提示、体验数据导出就都有了——硬门槛第 9、10、11 条与量规「性能与工程」直接受益。
vr-probe.js在自己的页面里加一行 <script src="vr-probe.js"></script>,就有 FPS / DrawCall / 三角面 / JS 报错四类读数,还会把读数画进 3D 场景——沉浸模式下只有 3D 面板看得见。
七条,全部真实发生过;调试不动的时候,先从头对一遍再动代码
| 坑 | 表现 | 怎么避 |
|---|---|---|
file:// 打开 |
没有「进入 VR」按钮 | 走三条通路之一 |
| 「网页另存为(完整)」 | 单独打开白屏 | 只存「仅 HTML」或下载原件 |
| 引用 CDN | 有网能跑,机房断网白屏 | 库放本地同目录 |
disabled / hidden 被冻进 HTML |
按钮显示「进入 VR」却点不动 | 运行时会被 JS 改的状态,代码里都要显式设一遍,别依赖 HTML 默认值 |
| 两套 three.js 混用 | 直接白屏 | UMD 版(全局 THREE)和 ESM 版(import)不能互换 |
| 沉浸模式下 DOM 看不见 | 面板消失了 | 面板要做成场景里的 3D 物件,不能用网页浮层 |
| 数字对不上 | 报告里的读数和页面 HUD 不一致 | 编数据比做不出来更严重 |
都不是代码问题:安全上下文、依赖是否随作品走。记住口号「先怀疑环境,再怀疑代码」。
页面「看起来对」但「点不动」,多半是HTML 里的默认状态与运行时不符,或者两套库的加载方式冲突。
沉浸模式里 DOM 不渲染、报告数字必须可复现——这两条不是 bug,是WebXR 与学术诚实的基本常识。
四条底线:人身安全 · 事实诚实 · 隐私与版权 · 密钥安全
戴上之前先看清周围有没有人;戴着头显不许走动(要移动用传送)。教室设备一人一台,但空间是共享的。
眼镜同学先戴眼镜再戴头显;每人一副一次性眼罩。
作品里涉及真实人物、校史、文物:不确定就标 【待补充】,不许编造。这一条同时是硬门槛第 11 条。
用到大模型 API:Key 不能写在前端(课堂演示级可以,正式产品必须走自家后端代理 + 限流 + 内容审核)。这条会讲,也会考。
| 加分方向 | 额外要求 |
|---|---|
| 智能交互(LLM) | 必须有离线降级兜底:断网 / 超时 / 幻觉时,作品要能继续走完主流程;Key 不进前端 |
| AR 虚实融合 | 手机端 WebXR 同样只在安全上下文可用;演示时准备好走 http 白名单或站点 https |
| 思政题材 | 史实、机构、人物信息不确定一律标 【待补充】;素材要有版权说明 |
一份任务书 + 三个配套页面;有问题先在课页与自检页里找答案
| 页面 | 什么时候用 |
|---|---|
| 课内案例 01—06 案例库 | 读源码、抄技术、当零件库(不能交它们本身) |
| 课堂作业墙 | 看第 5 次课全班 15 份课堂作业做到了什么程度 |
| 大作业展示区 | 当前为空(0 份);2026-12-02 集中展示后陆续上线,届时你的作品也会出现在这里 |
| VR 作品自检 | 每次上头显之前跑一遍六项环境状态;出问题时先看它 |
一 · 一句话:你要交什么 二 · 十一条硬门槛 三 · 怎么评分 四 · 关键时间与提交方式 五 · 选题清单 六 · 三条通路与三条退出路 七 · 怎么交 八 · 可以白拿的资产 九 · 历届踩过的坑 十 · 安全与伦理