虚拟现实技术 · 期末大作业 · 个人作品

期末大作业任务书(学生用)

三部分:课堂作业(描述性内容)+ 自己设想的方案(≥10 种交互方式、必须有模型资产)+ 功能完备、越美观分越高的成品

中华女子学院课程编号 1050080280 · 2026 秋 · 2023 级数字媒体技术 1 班占总评 40% · 没有上机考试模板已发布:2026-10-20(含封面与格式要求,可直接下载)作品提交:2026-11-25 前,微信发给教师并由教师上传网站(不用 FTP)文档提交:2026-12-02 前两节课(Word)· 作品展示:后两节课编制:2026-10-17
导

这份任务书怎么用

十一条正文对应十一件事:先看清要交什么(一)、什么算合格(二)、怎么打分(三),再按时间与提交方式(四)一步一步做

这是期末大作业的学生用任务书,一个人一份。它不介绍新知识——新知识都在课页里;它只回答四个问题:交什么、什么算合格、什么时候交、怎么做才不会白做。

本次大作业的基本盘:个人作品 · 占总评 40% · 没有上机考试 · 由三部分组成:① 课堂作业(随课完成,写成描述性内容,一个作业一段)+② 自己设想的方案(不少于 10 种交互方式、必须有模型资产,需提前与教师确认)+③ 功能完备、越美观分越高的成品(WebXR,头显浏览器打开、进入 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 时

二、配套页面

模板里有什么:① 封面(课程代码 1050080280、课程名称、学号 / 姓名 / 二级学院 / 专业、论文题目);② 字号字体与段落格式要求(一级目录小三黑体 / 二级目录四号黑体 / 正文小四宋体 / 首行缩进 2 字符 / 1.5 倍行距 / 脚注宋体小五 / 数字字母 Times New Roman);③ 报告结构:一、实验目的;二、实验内容;三、程序过程(过程描述 + 抓图、代码);四、运行结果与测试分析;五、心得体会;④ 成绩栏。填写时不要改样式,只替换占位内容。

案例库用来读源码、当零件库;自检页用来在上头显前先确认环境;大作业展示区是全班期末作品的长期展示页——现在为空,2026-12-02 集中展示后陆续上线。

任务书当前状态:结构与要求已按 2026-10-17 的最新安排更新;大作业论文模板已于 2026-10-20 发布。文档格式以模板为准(封面、字号字体、段落格式、章节结构);本页只补充内容与评分要求。下面第一组按钮里可直接下载模板(docx)。
一

一句话:你要交什么

三部分:课堂作业 + 自己设想的方案 + 功能完备且美观的成品

一份由三部分组成的大作业:① 课堂作业的描述性内容;② 你自己设想的方案(≥10 种交互方式、必须有模型资产);③ 按这个方案做出来的、功能完备且越美观分越高的 WebXR 成品。

① 课堂作业

  • 对应各次课随课产出的课堂作业(第 8 次课为「交互验证 + 模型管线 + 许可卡(一页版)」;旧口径 M2 并入第 9 次课,口径待教师确认);
  • 写成描述性内容,一个作业写一段;
  • 写进大作业文档,不单独提交代码。

② 自己设想的方案

  • 不少于 10 种交互方式(不是「有交互」,是能逐条列出来、各自说得清用法与提示);
  • 必须有模型资产:导入的 GLB / GLTF,或程序化建模形成的可复用资产;
  • 可与上学期「前端图形学实用技术」的大作业有相似性;
  • 必须提前与教师确认:微信把要做内容发给教师。

③ 功能完备且美观

  • 功能完备:主流程走得通、交互都能用、断网也能跑;
  • 越美观分越高:界面、场景、动效、视觉统一性都计入评分;
  • 功能越强大分数越高:在完备的基础上做深、做稳,并说清取舍。

形式与数量

  • 用网页做(Three.js / WebXR),不用 Unity;
  • 一个人做一件——不是小组项目;
  • 现场展示,讲清做了什么、技术点在哪;
  • 主题自选,但不能把课内案例 01—06 交一遍。

要满足的三件事

课程的能力目标是「独立完成一个体现虚实融合 + 智能交互特点的 VR/AR 小项目」。所以你的作品要满足:能跑 · 能展示 · 体现「为什么必须用 VR」。

一、交付物长什么样

作品文件(11-25 前)

一个能在头显浏览器里打开、点「进入 VR」、走完主流程的页面。依赖放同目录或内联,断网也能跑。微信发给教师,由教师统一上传到网站。

文档(12-02 前两节课)

Word 文件,用已发布的大作业论文模板(下载 docx,含封面与格式要求):课堂作业各一段 + 方案说明 + README 段落 + 过程与取舍。

展示(12-02 后两节课)

集中展示 VR 作品:封面图 cover.jpg(1280×720)+ 体验数据 xr-data.json + 现场讲清做了什么。

为什么禁止直接交课内案例:案例 01—06 是课上一起写过的参考实现,交它们等于交课堂练习。可以读它们的源码、抄它们的技术,但主题、完成度、交互数量都必须明显不同——这一条在评分量规里直接对应「VR 学科理解」与「演示与文档」两维。
二

十一条硬门槛(缺一条就不合格)

不是加分项,是及格线。逐条配了「怎么算过(自查)」——能自己判,就不要等老师判

#门槛怎么算过(自查)
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 可访问性与诚实 坐姿 / 单手 / 注视停留至少两条通路可用并说明取舍;涉及真实信息不确定的一律写 【待补充】,不许编
「缺一条就不合格」是字面意思。翻车最多的是第 3 条(退不出去)和第 10 条(戴进去才发现掉帧);第 1、2 条是这次新增的硬要求——课堂作业没写全、方案没确认,作品做得再好也不完整。

一、上机前先用自检页跑一遍

第 4 / 5 / 9 / 10 / 11 条都能在电脑上先自查一轮:打开 《VR 作品自检》,看协议 / 安全上下文 / navigator.xr / immersive-vr / WebGL / 输入设备六项状态。环境项有 ❌ 就先解决环境,不要去看自己的代码。

二、怎么用这份清单

  1. 方案确认之前通读一遍——避免选一个天然撞门槛的题(比如「纯全景漫游」过不了第 7 条);
  2. 11-25 交作品之前逐条打勾——第 3、5、7、9、11 条必须是真机验过的,不能是「应该可以」;
  3. 12-02 交文档之前再逐条打勾一遍——文档里要能对得上每一条的说明。
三

怎么评分:7 维合计 100 分

「功能完备」与「美观度」单独占分——这正是本次要求里「越美观分越高、功能越强大分数越高」的落点

一、必评七维(合计 100 分)

维度分值满分长什么样
① 功能完备25主流程两遍都通、无报错、自测通过;该有的功能一个不缺,边角场景也有兜底
② 美观度20界面、场景、动效、字体与色彩视觉统一;有明确的设计意图,不是「能跑就行」
③ 交互与人因15≥10 种交互且各有提示(高亮 / 悬停);有模型资产;PC 与 VR 等价;可访问性两条通路并说得出取舍
④ VR 学科理解12讲得清「沉浸 / 交互 / 构想」、临场感要素、晕动机制,而且这些理解体现在你的改动里
⑤ 性能与工程10达到 72Hz 帧预算意识、有降级手段与优化对照、状态机清晰、能导出体验数据
⑥ 演示与文档10模板规范、诚实完整;现场讲清「做了什么、为什么」
⑦ 课堂作业8描述性内容齐全,每段都写清做了什么、用了什么技术、遇到什么问题、怎么解决
「功能完备」与「美观度」为什么要单独占 45 分:本次大作业的要求就是「功能完备,越美观分越高,功能越强大分数越高」。能跑通只是及格线,做得好不好看、做得深不深,是这 45 分要回答的问题。
过程数据不排名:晕动暴露高,可能恰恰说明你在认真测试平滑移动,这是好事。
但完成度 / 得分数据算证据:用内核的 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。

② 「美观」怎么判

不是「好不好看」的主观印象,而是四个可对照的点:视觉是否统一、有没有设计意图、动效是否克制、信息层级是否清楚。文档里要写你为美观做了什么。

③ 为什么不再设「+5 加分」

原「智能交互 / AR / 思政 +5」已并入「交互与人因」与「VR 学科理解」——做出来就是分数,不必靠加分兜底。

先保门槛,再冲高分:硬门槛第 7 条要求 ≥10 种交互(及格线),而量规里「交互与人因」要拿高分,还需要每种交互都有提示、PC 与 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、技术点在哪;作品已由教师上传,可直接用网站演示
两个闭合时间要记牢:11-25 前交作品文件(微信发给教师,由教师上传网站);12-02 前两节课交 Word 文档,后两节课集中展示。晚交按扣分处理。

一、倒排:每一关卡住谁

时间事项卡住谁不能往下走
2026-10-20大作业论文模板已发布没有模板就没有统一的文档格式
方案确认前一页纸方案确认方案没确认,作品不算数
随课课堂作业缺段就无法写完整文档
11-25 前作品文件提交过不了这条,等于没交作品
12-02 前两节Word 文档提交文档缺失无法评分
12-02 后两节集中展示展示占「演示与文档」分
为什么方案要提前确认:这次要求「不少于 10 种交互方式 + 模型资产」,需要在动手前就逐条列清楚——否则做到一半才发现交互数量不够、或者根本没有模型资产,就要返工。

二、从确认方案到提交的自检节奏

确认前
先把「为什么必须 VR」写死
这一句话决定了后面所有交互的设计依据。写不出来,说明这个题用普通网页也能做——换题比硬做省时间。
确认后
10 种交互逐条列成表
方案里要能一行一种交互、写清用法与提示方式,并注明用到的模型资产。列不出来,说明交互数量还没达标。
随课
先能玩,再看性能
主流程先走通、记录退出用时;性能优化放在后面——顺序反过来会陷入「一直在调性能,主流程还没通」。
11-25 前
优化必须有前后对照
「我优化了」不算证据,「DrawCall 从 101 降到 2」才算。对照数据要能对上页面 HUD(见第九节),并随作品一起交给教师。
12-02 前
文档按模板收口
用已发布的模板(下载):封面、格式、课堂作业各一段、方案说明、README 段落、已知简化,一并写清。
12-02 当天
前两节交文档、后两节集中展示
一句话说清「我做了什么、为什么」;再说清「我卡在哪一环——环境、作品还是设备」。展示时作品已由教师上传到网站。
五

选题清单(8 个方向)

优先在你第 5—6 次课做的全景 / 3D 作品上长出一个可交互的段落——风险最低,也最容易被判「你真的做了」

#方向难度亮点主要风险
1 全景 + 交互混合 ★ 最快做出完整闭环 别停在「纯漫游」——第 5 章已经做过,不算作品
2 传统文化 VR 空间叙事(古建 / 文物 / 非遗) ★★ 沉浸感最强,思政契合 素材版权;史实不确定必须标占位
3 女性公共空间安全决策训练 ★★ 主题真实、社会价值高、与本学院定位最契合 情境要克制,重点是决策训练,不是惊吓体验
4 VR 应急演练(消防 / 地震逃生) ★★ 有明确评分反馈 场景容易做大——限定一层楼
5 VR 科学实验模拟 ★★★ 危险操作虚拟化,教学价值清晰 粒子 / 流体难做,做不出就成「看动画」
6 VR 节奏 / 音乐互动(编钟、腰鼓、古琴) ★★★ 手柄触觉 + 程序化音频零素材 音频同步是硬骨头;课内做过,要有明显增量
7 VR 数字展厅 / 博物馆导览(含智能讲解) ★★ 可复用全景素材 + 会讲解的 NPC LLM 有延迟和幻觉 → 必须备离线兜底
8 VR 口述史 / 校史空间 ★★ 用空间讲时间线,校本特色 真实信息多,占位纪律要严
共通提示:优先在你自己第 5—6 次课做的全景 / 3D 作品上,长出一个可交互的段落。风险最低,也最容易被判「你真的做了」。

一、不建议的方向(不是不好,是这一学期做不完)

方向为什么这一学期做不完
高精度手势 / 手语识别要自采数据、自己训模型
多人在线 VR网络同步本身是一门课
云 VR / 串流优化依赖实验室网络
真实医学影像处理跨专业代价高
依赖眼动 / 面部追踪头显开放度有限
纯全景漫游(无交互)课内已经做过,硬门槛第 7 条(≥10 种交互)也过不了

二、怎么用这张清单

  1. 先按难度挑:★ 与 ★★ 一共五个方向,是这一学期能做完的区间;★★★ 只有在你已经有余力时才选;
  2. 再按「风险能不能接受」挑:素材版权、史实不确定、场景规模——这三个风险都能靠「限定范围 + 标占位」降下来;
  3. 最后按「为什么必须 VR」挑:说不出这一点的方向,换成 ★ 的第 1 个也比重做一遍强。

想看真实完成度长什么样,可以翻 课堂作业墙(第 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:// 打不开 WebXR

规范层面的原因

WebXR 会调用摄像头、手柄、眼动、空间追踪等敏感能力,所以规范要求它只在安全上下文(secure context)里可用:https: / http://localhost / http://127.0.0.1 算,file:// 与局域网 http://192.168.x.x 都不算。

你看到的现象

页面上没有「进入 VR」按钮,控制台里 navigator.xr 是 undefined。这不是你的场景做错了,是打开方式不对——换第 ① 或第 ③ 条通路即可。

三、三条退出路(每条作品都该有)

① 注视(或射线)点「退出」按钮

把退出按钮做成场景里的 3D 物件,不是网页浮层——沉浸模式下 DOM 看不见(见第九节)。

② 长按握把键 2 秒

手柄通路:不依赖视线、不依赖 UI,手边最顺手的一条。

③ 系统键返回

头显系统自带的一层保险;但不能只靠它——它是最后手段,不是你的设计。

至少试通一条,并报出用时。退不出去的作品不算完成。三条都试一遍更好:只有一条出口的应用,在真实课堂里一定会出事。

四、进不去 VR 时的排查顺序

  1. 先看地址:是不是 file:// 或局域网 IP?是就换通路;
  2. 再看自检页:打开 《VR 作品自检》,六项里协议 / 安全上下文 / navigator.xr / immersive-vr 有 ❌ 就是环境问题;
  3. 再看浏览器与设备:换个浏览器、重启头显浏览器再试;
  4. 最后才怀疑代码:到这一步,绝大多数情况是进入按钮没有由人手点一次——进 VR 必须人手点一次,这是规范要求,装成应用也一样。
七

怎么交

作品 11-25 前微信发给教师(教师上传网站,不用 FTP);文档 12-02 前两节课交 Word

提交分两条线,不要混:① 作品文件——2026-11-25 前打成压缩包发微信给教师,由教师统一上传到网站;② 文档——2026-12-02 前两节课交 Word 文件,用已发布的大作业论文模板(下载;含封面与格式要求)。两条都不走 FTP。

一、作品文件:打包发给教师

把作品目录打成一个压缩包,文件名写成 <学号>-<姓名>.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 条要求作品里确有模型资产
目录名一律用学号(ASCII);教师部署后,页面上显示中文姓名,展示区按学号升序排列。
上传后的展示位置:大作业展示区 assets/vr-2026/final-works/(收录清单在 final-works/works.json)。

二、文档:12-02 前两节课交 Word

部分写什么
封面与格式按已发布的大作业论文模板(下载 docx;封面、字体字号、章节结构、图表规范)
一、课堂作业随课完成的课堂作业(第 8 次课为交互验证 + 模型管线 + 许可卡(一页版)),一个作业一段:做了什么 / 用了什么技术 / 遇到什么问题 / 怎么解决
二、方案说明主题、为什么必须用 VR、≥10 种交互方式逐条列出、模型资产清单、降级方案
三、实现与取舍关键实现、性能优化前后对照、可访问性取舍、为美观做了什么
四、已知简化没做完的、占位的事实信息、后续可如何完善

三、交作业姿势(历届最高频的事故)

⚠️ 右键 →「网页另存为(完整)」会带出一个 _files 文件夹。 只发 .html 给老师 → 依赖全丢,单独打开必然白屏。
正确做法:右键 →「另存为 → 网页(仅 HTML)」,或者直接下载原件;如果作品确实带同目录依赖(含模型资产),就把整个目录压缩成一个 zip 再发。

四、提交前对一遍这张表

  1. 作品压缩包已在 11-25 前微信发给教师,文件名是 <学号>-<姓名>.zip;
  2. 目录名是纯 ASCII 学号,没有空格、没有中文;
  3. 四件齐:index.html + README.md + cover.jpg(1280×720)+ xr-data.json,另有 assets/ 模型资产;
  4. 拔网线打开一遍:能跑、控制台无报错、能点「进入 VR」;
  5. README 四行齐:我改了什么 · 为什么这么改 · 怎么运行 · 哪里还没做完;
  6. 数字对得上:README 与报告里的读数,和页面 HUD 上的一模一样(见第九节最后一条);
  7. Word 文档已按已发布的模板写好(下载 docx),12-02 前两节课按规定提交。
八

可以白拿的资产(千万别从零造轮子)

课内已有的库、内核、案例与演示,全部可以直接用;接上内核,舒适度与可访问性门槛基本就达标

资产拿到什么
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 算。

移动头显三角面 ≤ 10 万

一体机的算力与功耗都有上限,超过这个量级很容易掉帧。这是保险线,不是随便定的。

先看 DrawCall,不要先看面数

优化顺序:先看 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 面板看得见。

三、现在就能点开看

提醒一句:这些资产是「白拿」,不是「白交」。用现成的库和内核把主流程跑通,省下来的时间要花在你的主题、你的交互、你的「为什么必须 VR」上——那才是分数所在。
九

历届踩过的坑(照这个清单自查)

七条,全部真实发生过;调试不动的时候,先从头对一遍再动代码

坑表现怎么避
file:// 打开 没有「进入 VR」按钮 走三条通路之一
「网页另存为(完整)」 单独打开白屏 只存「仅 HTML」或下载原件
引用 CDN 有网能跑,机房断网白屏 库放本地同目录
disabled / hidden 被冻进 HTML 按钮显示「进入 VR」却点不动 运行时会被 JS 改的状态,代码里都要显式设一遍,别依赖 HTML 默认值
两套 three.js 混用 直接白屏 UMD 版(全局 THREE)和 ESM 版(import)不能互换
沉浸模式下 DOM 看不见 面板消失了 面板要做成场景里的 3D 物件,不能用网页浮层
数字对不上 报告里的读数和页面 HUD 不一致 编数据比做不出来更严重

一、这七条背后的三类原因

环境类(第 1—3 条)

都不是代码问题:安全上下文、依赖是否随作品走。记住口号「先怀疑环境,再怀疑代码」。

状态与版本类(第 4—5 条)

页面「看起来对」但「点不动」,多半是HTML 里的默认状态与运行时不符,或者两套库的加载方式冲突。

认知类(第 6—7 条)

沉浸模式里 DOM 不渲染、报告数字必须可复现——这两条不是 bug,是WebXR 与学术诚实的基本常识。

最后一条单独强调一遍:报告里的数字必须与页面 HUD 一致。评分时会当面对读数;对不上,其他部分做得再好也会被质疑。编数据比做不出来更严重。
十

安全与伦理

四条底线:人身安全 · 事实诚实 · 隐私与版权 · 密钥安全

① 戴上之前先看清周围

戴上之前先看清周围有没有人;戴着头显不许走动(要移动用传送)。教室设备一人一台,但空间是共享的。

② 眼镜同学先戴眼镜

眼镜同学先戴眼镜再戴头显;每人一副一次性眼罩。

③ 真实信息不确定就标占位

作品里涉及真实人物、校史、文物:不确定就标 【待补充】,不许编造。这一条同时是硬门槛第 11 条。

④ 大模型 Key 不能放前端

用到大模型 API:Key 不能写在前端(课堂演示级可以,正式产品必须走自家后端代理 + 限流 + 内容审核)。这条会讲,也会考。

一、做「加分项」时的额外要求

加分方向额外要求
智能交互(LLM)必须有离线降级兜底:断网 / 超时 / 幻觉时,作品要能继续走完主流程;Key 不进前端
AR 虚实融合手机端 WebXR 同样只在安全上下文可用;演示时准备好走 http 白名单或站点 https
思政题材史实、机构、人物信息不确定一律标 【待补充】;素材要有版权说明
一句话收束这份任务书:做出一个能跑、能演示、能说清「为什么必须用 VR」的作品,比做出一个看起来很大但走不完主流程的作品,分数高得多。
附

索引与返回

一份任务书 + 三个配套页面;有问题先在课页与自检页里找答案

一、配套页面

页面什么时候用
课内案例 01—06 案例库读源码、抄技术、当零件库(不能交它们本身)
课堂作业墙看第 5 次课全班 15 份课堂作业做到了什么程度
大作业展示区当前为空(0 份);2026-12-02 集中展示后陆续上线,届时你的作品也会出现在这里
VR 作品自检每次上头显之前跑一遍六项环境状态;出问题时先看它

二、十条正文(回看用)

一 · 一句话:你要交什么 二 · 十一条硬门槛 三 · 怎么评分 四 · 关键时间与提交方式 五 · 选题清单 六 · 三条通路与三条退出路 七 · 怎么交 八 · 可以白拿的资产 九 · 历届踩过的坑 十 · 安全与伦理