虚拟现实技术 · 第 8 次课 · 先做后讲

先动手,再听原理:交互零件装成系统 × 开源模型变成资产

第 8 次课 · 2026-10-28 · 4 学时 —— 前两节 90′在 646 机房用线上页面完成一页版课堂作业(A 组交互验证 10 分 + B 组模型管线 10 分;教师只开场 5′ + 巡场,不讲课);后两节 90′换到 430 教室,教师戴上头显把你们刚做的事拆开讲——动手在前、原理在后

中华女子学院第 8 次课 · 2026-10-28(周三)· 4 学时 / 180 分钟第 1–2 节 646 机房 90′ 自主作业 + 第 3–4 节 430 教室 90′ 头显讲课授课人:孙琪翔数字媒体技术实验室
导

本节导览:前半场动手,后半场戴头显讲

同一个 180 分钟,改成两种角色:646 机房学生做(教师只巡场)/430 教室教师讲(学生看+少量体验)

第 7 次课你们手上有一堆能做的事(9 个交互零件)。今天要做的,是把这些“零件”装成一台机器,再把“网上的模型”变成能进作品的资产。 所以这次课换了排法:前两节我不讲,你们自己动手;后两节戴上头显,我再讲你们刚才做的事到底发生了什么。

教学底线(下课时每人至少做到这一条)
交出一份“A 组五项交互都做过并记录 + B 组管线跑通(转 GLB → 导入操作 → 场景 JSON + 许可卡)”的作业, 并且能说出“状态是怎么变的、这个模型能不能用”。分数只是结果,这两句话才是本课目标。

一、两段式分工(先记住这张表)

第 1–2 节(90′)· 646 机房第 3–4 节(90′)· 430 教室
谁在动学生动手(教师只开场 5′ + 巡场答疑)教师讲与演示(学生看,少量轮流体验)
主材料一页版作业页(vr-2026-lesson8-hw)+ 线上 01 / 02 / 03 / 04 四页01 交互实验室 / 02 模型工作台 / 03 模型转换器 / 04 头显自检页
产出A 组交互记录 + B 组 GLB / 场景 JSON / 许可卡 + S1 / S2 / S3 截图 + 说明.md观察记录(看头显演示)+ 修正后的理解 + 课后补齐
教师角色发材料、每 15′ 广播一次进度、巡场、收作业主讲、戴头显演示、控投屏、组织轮换
为什么这么排(三个现实约束):① 前 90′ 全部走线上页面(01 / 02 / 03 / 04 + 站内模型下载),学生不装软件、不下载代码、不改 HTML,打开就能做;② 头显在 430,不可能让全班在机房排队;③ 动手在前、原理在后,学生带着“我刚才卡住的地方”听后半场,注意力才在。

二、今天要做的一页作业(20 分)

A 组 · 交互验证(10 分)

用线上 01 交互实验室做 5 项:吸附 / 双手缩放 2× / Poke 直触 / 触觉模式 / 输入源三字段; 每项写“状态怎么变 + 我观察到什么”,截 S1,再用一句话说清 squeeze vs select。

B 组 · 模型管线(10 分)

下载 Fox.glb(站内)→ 03 转换器转出 GLB 并记体积变化 → 02 工作台导入后旋转 45°、缩放 1.5×、换色、播动画 → 截 S2 → 导出 scene.json。

许可卡 + 提交

许可卡.txt:模型名 / 来源 / 许可 / 能否商用 / 是否署名。连同 S1/S2/S3、scene.json、说明.md 放进 学号_姓名_第8次课,本场下课交。

今天最容易走偏的两件事:① 把前两节当成“等老师讲”——前两节我不讲,先按一页版作业页先 A 后 B 做,卡住举手; ② 把后两节当成“看电影”——头显是教具不是奖品,戴的人有任务(抓一次 / 缩一次 / 戳一次),没戴的人有观察卡,不是干等。
646

前两节 90′(646 机房):学生自主作业,教师只巡场

不讲课、不演示新东西——只做三件事:开场 5′ 说清做什么 / 交什么、每 15′ 广播一次进度与常见坑、巡场答疑

一、646 时间轴(90′,含 5′ 答疑休息)

时间环节学生做什么教师做什么
0–5′发一页作业 + 演示入口先看教师放开场演示(8′),再打开一页版作业页(vr-2026-lesson8-hw)确认 01/02/03 三个工具能开念清四件事:一页作业 20 分(A 10 + B 10)· 先 A 后 B · 提交清单与命名 · 全程线上、不装软件;示范一次“点开 01 就能操作、不用下载任何东西”
5–10′打开四个在线页(热身)依次打开 01 交互实验室 / 02 模型工作台 / 03 模型转换器 / 04 头显自检,各看一眼能不能操作只抓“打不开”的机器:白屏 → 换 Chrome / 换机位,别的先不管
10–40′A 组 · 交互验证(30′)在 01 里做 5 项(吸附 / 双手 2× / Poke / 触觉 / 输入源三字段),逐项记“状态怎么变 + 我观察到什么”,截 S1,写一句话 squeeze vs select前 3′ 投屏演示一遍五项怎么触发(T / P / H / 123);每 15′ 广播进度;巡场只看“记录写了没”
40–45′答疑与休息(5′)休息、互相看屏幕、确认 S1 截到了只答“三个人以上问的”,其余留到巡场;典型错误记下来(430 开场就用它)
45–80′B 组 · 模型管线(35′)下载 Fox.glb(站内)→ 03 转换器转 GLB 记体积 → 02 工作台导入并旋转 45° / 缩放 1.5× / 换色 / 动画 → 截 S2 → 导出 scene.json → 写许可卡广播“许可当场记,别靠记忆”;巡场查三件事:体积数字填没填 / 三个操作做了没 / 许可卡空没空
80–90′提交与自检把 S2.png(展示图)、S1.png、scene.json、许可卡.txt、说明.md 放进 学号_姓名_第8次课,交到指定共享盘 / 群文件;每人确保 S2 与一句话能直接上墙按机位清点、记下未交名单;全部作业统一上「作品墙」(不愿公开的按说明.md 第一行「不公开」处理)

二、热身只看 4 个钩子(5′ 内跑完)

钩 1
页面无白屏
四个在线页各点开一次,能看到 3D 画面 / 面板。白屏先换浏览器(Chrome / Edge),再换机位。
钩 2
控制台无红字
F12 → Console,没有红色报错。看到红字先抄下来,别自己猜。
钩 3
目标 / 卡片在
01 左上角三个目标在;02 右侧4 张模型卡在;03 有「选择文件」入口在。
钩 4
能操作
01 能抓一个方块;02 能加载一个模型;03 能拖进一个文件看到统计。能操作就算跑通。
教师巡场节奏(646 的 90′ 怎么走):0–5′ 站着讲(不开电脑)→ 5–10′ 只解决“打不开”→ 10–40′ 巡场三问(A 组五项做全了吗?状态/HUD 写了吗?S1 截到了吗?)→ 每 15′ 广播一次(T+15 / 30 / 45)→ 40–45′ 统一答疑 → 45–80′ 查体积数字与许可卡(空着的当场补)→ 80–90′ 收作业。
646 降级预案(一页):页面打不开 → 换浏览器(Chrome / Edge)/ 换机位,或两人一机共用一台;站内模型下载失败 → 用 02 工作台里已内嵌的 Fox 直接做 B2–B3(B1 的体积对比改为记录内嵌模型大小,照常给分);网络整体断 → A 组照做(单文件页可先用教师拷贝),B 组改为“PC 端 02 内嵌模型 + 口头讲管线”;投影听不清 → 把“每 15′ 广播”改成写黑板+巡场口头提醒;时间不够 → 保 A 组与 B2/B3/B4(B1 可课后补)。
练

646 课堂作业(一页版):A 组交互验证 10 分 + B 组模型管线 10 分

全程用线上页面:不装软件、不下载代码、不改 HTML;作业内容与可打印版都在一页版作业页

一、作业入口与站内模型(机房用这一份就够)

机房铁律三条:① 全程用线上页面——不装任何软件、不下载代码、不改 HTML(今天没有“改代码”这一步);② 先 A 后 B,A 组 30′、B 组 35′,卡住先看作业页提示再举手;③ 截图用 Win + Shift + S,文件名带学号+姓名。

二、A 组 · 交互验证(30′,10 分)

打开线上 01 交互实验室(PC 键盘即可),按作业页表格做 5 项并记录:①吸附 ②双手缩放到 2×(T,[]/滚轮)③ Poke 直触(P)④ 触觉模式切换(H,123)⑤ 读输入源检查器三字段;截 S1(含状态机 HUD 与目标 3/3),写一句话回答“为什么抓取用 squeeze 而不是 select”。

#动作状态怎么变评分点
①把方块吸进插槽(吸附)idle → hover → grab → snap动作做到 + 状态写对
②双手把能量球缩放到 2×(T / [] / 滚轮)双手抓 → scale 1 → 2能说出“间距 → 缩放”
③Poke 直触按下按钮(P)idle / hover → active近处直触 vs 远处射线
④触觉模式切换(H,123)short / long / patternPC 端走音效+日志降级
⑤读输入源检查器三字段handedness / profiles / gamepadPC 显示“模拟源”属正常
A 组评分(10 分)= 动作 4 + 记录 4 + 一句话 2。只点一下不给分:要写出“状态怎么变 / HUD 数字”;一句话要么说“select 是点一下、squeeze 是握住”,要么说“抓取是持续动作”。

三、B 组 · 模型管线(35′,10 分)

五步走完:下载 Fox.glb → 03 转换器转出 GLB 记体积 → 02 工作台导入并操作 → 导出场景 JSON → 写许可卡。

#做什么要交 / 要记录
B0站内下载 Fox.glb(也可换 Duck / ArmChair_01)模型名;许可要看 README_许可.md
B103 转换器:拖入 .glb → 导出 GLB源大小 / 输出大小 / 变化% + 一句话“为什么转换≠优化”
B202 工作台:导入本机 GLB → 选中 → 旋转 45°、缩放 1.5×、换色、播放/暂停动画截图 S2(含 HUD 统计)
B3导出场景 JSONscene.json,含 id / name / pos / rot / scale / color / anim
B4写许可卡许可卡.txt:模型名 / 来源 / 许可 / 能否商用 / 是否署名
B 组三个高频坑:① 拖错格式 → 03 只接受 .glb/.gltf/.obj/.fbx,站内给的就是 .glb,直接拖;② 导入后巨大或看不见 → 正常,工作台会归一化到 1.2 m,先加载再摆;③ 许可卡空着 → 该项 0 分,不确定写“待核实”。
430

后两节 90′(430 教室):教师戴头显讲,学生看+少量体验

开场就接你们刚做的三件事 → 交互原理深化 → 头显演示 1(01 交互实验室) → 休息轮换 → 模型管线与许可点评 → 头显演示 2(02 模型工作台) → 收束

一、430 时间轴(90′)

时间环节讲什么 / 演什么学生做什么
0–10′收作业 + 开场开场三句话:“你刚做的吸附 / 双手缩放,其实都是在走状态机” / “你转的 GLB 还缺一步归一化” / “你写的许可卡决定模型能不能进作品”交作业(S1/S2/S3 + scene.json + 许可卡.txt + 说明.md);拿观察卡(每人一张)
10–30′交互原理深化输入源三字段 → select vs squeeze → 状态机 → 双手变换数学 → 双阈值吸附(用你们 646 的真实错误当例子)听讲、回答、在观察卡记关键词
30–45′头显演示 1:01 交互实验室戴前先做 04 头显自检页 30 秒自检 → 投屏 → 戴入 → 演 5 步:输入源检查器 / 射线悬停→选择 / 单手抓取 / 双手变换 / 吸附+poke看投屏;戴头显的人做 3 件事(抓一次 / 缩一次 / 戳一次),其余人填观察卡
45–55′休息与设备轮换头显消毒 / 换人 / 充电;教师把演示页切到 03、02 备用轮流戴(每人 60–90 秒);没戴的补观察卡
55–75′模型管线与许可点评为什么 GLB → 转换≠优化(Duck +26.5%)→ 许可陷阱(CC-BY-NC)→ 归一化 → 当众判 2 张学生许可卡(投票“能过吗”)对照自己的许可卡改错
75–85′头显演示 2:02 模型工作台自检 → 投屏 → 戴入:加载 4 个内嵌模型(看许可角标)→ 归一化 → 拖 / 旋 / 缩 / 换色 / 播动画 → 本地导入 → 导出场景 JSON戴头显的人试着导入一个模型;其余人看投屏
85–90′收束三句话:零件要装成系统 / 模型要过管线 / 许可要写进卡;预告第 9 次课 M3 硬门槛记课后任务
两段之间的转场(约 10′,不计教学时长):646 收尾交作业 / 存截图 2′ → 教师清点提交文件夹、把待上墙的 S2 + 一句话汇总 2′ → 带队转场 646 → 430(6 层走 4 层,点名)5′ → 落座、发观察卡、点亮投屏 1′。宁可压缩点评 2 分钟,也不要压转场——迟到的开场会毁掉整个后半场。

二、两次头显演示的逐步操作

演示 1 · 01 交互实验室(30–45′)

  • A1 抬手看输入源检查器:handedness / profiles / gamepad 有真实值——真实手柄,不是模拟源
  • A2 射线扫过物体 → 扣扳机:颜色 idle → hover → active,状态机在管颜色
  • A3 握住(squeeze)抓方块 → 移动 → 松开:物体跟随、松开停住,抓取用握持不用扳机
  • A4 双手同时抓能量球 → 拉开 / 靠近 / 转角度:间距 → 缩放、相对角 → 旋转,HUD 显倍数
  • A5 方块靠近插槽(吸附)→ 戳 poke 按钮 → 退后用射线按同一个按钮:近处直触、远处射线

演示 2 · 02 模型工作台(75–85′)

  • B1 打开看 4 张模型卡:每张都有名称 + 许可角标——这不是装饰,是你在决定能不能用
  • B2 加载 Fox / Duck:自动缩到约 1.2 m、贴地、居中(NORM_HEIGHT = 1.2)
  • B3 拖 / 旋 / 缩 / 换色 / 播动画:HUD 数字同步变——每个操作都进状态
  • B4 「选择 .glb 文件」导入:模型出现,许可角标写「本地导入 · 请自行确认」——这不是许可,是提醒你去补许可卡
  • B5 「导出场景 JSON」:下载 workbench_scene.json,摆的东西要能存下来才带得走
戴头显前必做 30 秒自检:头显浏览器打开 04 头显自检页(站点上的 assets/vr-2026/lesson8/04-check)——页面会显示安全上下文 ✓ / navigator.xr 有 / immersive-vr 支持,并提示「file:// 不能进 VR,请用 http」;自检不过就不要硬戴,换台头显或改 PC 投屏。每次换人戴入都重做一次。

三、没戴头显的人:观察卡(30 秒填完,算过程性参与)

观察项怎么记
我看了哪几段演示 / 戴了多久写演示编号(A1–A5 / B1–B5)或“戴了 60 秒”
晕不晕(1—5)1 = 完全不晕,5 = 想摘;3 分以上记下来(第 9—10 次课的可访问性要用)
我卡在哪一步进不去 / 手柄抓不住 / 双手缩放控制不住 / 戳不准 / 其他
最想改的一处一句话(这句就是你期末作品交互模块的素材)
430 的讲法(学生视角):先讲“你们犯的错”,再讲“原理”;头显是教具不是奖品;投屏优先——头显里看到的和投屏上是同一件事;许可点评当众判卷——拿 1—2 张许可卡投影出来投票“能过 / 不能过”,比讲十遍条款有效。
一

Part 1 · WebXR 交互进阶:把 9 个零件装成一套系统

430 讲的五个点:输入源三字段 → select vs squeeze → 状态机 → 双手变换数学 → 双阈值吸附 / poke vs 射线

一、输入源三字段:XRInputSource 到底告诉了你什么

页面右上角的输入源检查器是这节课的“教学利器”——它把 inputSource 摊开给你看:

字段回答的问题典型值课堂要点
handedness哪只手'left' / 'right' / 'none'没有它,你无法判断“谁在抓”,吸附判定该信谁就说不清
profiles什么设备字符串数组(型号 / 能力)同一段代码要在不同头显上跑,靠它分支
gamepad按了什么、摇杆在哪buttons[] / axes[]扳机、握持键、摇杆都从这里读;不要写死按键序号
PC 上为什么看到“模拟源”:没有头显时检查器显示的是PC 模拟输入源——这不是 bug,是故意的:没有设备也能讲清字段。戴进真机后,同一个面板会显示真实手柄。

二、select vs squeeze:抓取为什么不用扳机

事件族三个事件就是适合
selectselectstart / select / selectend扳机“点一下”——按下去、抬起来,一件事结束点击、确认、开火
squeezesqueezestart / squeeze / squeezeend握持键“握住”——按住多久,就持续多久抓取、拖拽、双手变换
一句话结论:抓取是“持续动作”,所以用 squeeze。用扳机抓,会出现“按住才拿得住、一松手就掉”的别扭感,甚至“想抓却把东西点飞了”。

三、状态机:什么条件下允许发生什么

01 页面里每个物体都有自己的状态,颜色就是状态的可见证据:

idle ──hover──▶ hover ──grab──▶ grab ──snap──▶ snap
  │               │                │              │
  └─poke──▶ active│                └─release──▶ idle
                  └─unhover──▶ idle
另有 disabled(禁用):disabled ──enable──▶ idle

转移表:TRANS = { idle:{hover,grab,poke}, hover:{unhover,grab,poke,disable},
                 grab:{release,snap,disable}, snap:{release,hover,grab,reset}, … }
被拒绝的转移记在 S.lastReject(课堂上「删掉 idle→grab 出口」就能看到)
吸附半径 SNAP_DIST(页面默认 0.30 m)不只是一个数——它决定 grab → snap 这条转移什么时候允许发生。如果把 idle → grab 出口删掉,“没悬停就能抓”的入口就没了:必须先 hover 才能 grab,这不是 bug,是规则。

四、双手变换数学:间距 → 缩放,相对角 → 旋转

两只手同时抓同一个物体时(以「抓取那一帧」为基准,不是每帧累加):

  缩放:  scale = d_now / d_start        (d = 两手之间距离)
  旋转:  rot   = θ_now − θ_start        (θ = 两手连线的相对角)

反例(错的做法):每帧 scale *= (d_now / d_prev)
  → 手会抖、帧率会变,误差越缩越偏;松手 / 换手就断了
正确做法:始终相对「抓取瞬间」算绝对值 → 两手回原位,物体就回原样
为什么不能逐帧累乘:手抖、掉帧、换手都会把误差累积进去,而且松手再抓就没有基准了。“相对抓取瞬间”的绝对算法才可复现——这也是实训里 orb.scale 1 → 2、ΔrotY = 30° 能被实测验证的原因。

五、双阈值吸附 + poke / 射线两条通道

机制阈值为什么不只用一条
吸附插槽距离(SNAP_DIST 默认 0.30 m)+ 角度(朝向落在扇区内)只看距离:歪着也会被吸过去;只看角度:隔空也能吸。两个都满足才吸,才叫“对齐”
poke 直触POKE_DIST 0.14 m(手 / 柄尖到按钮)近处直接戳最自然;超过 0.14 m 就应该用射线,不用“伸长手”
射线按钮RAY_MAX 6.0 m远处用射线;同一个按钮两条通道,靠距离阈值切换
如果把 SNAP_DIST 从 0.30 放到 0.60,就变成“隔空老远就吸上”——误吸附比吸不上更糟,因为用户失去控制感。A 组做吸附时,注意 HUD 里从 hover 到 snap 的那一下“咔”,就是双阈值同时满足的瞬间。
二

Part 2 · 开源 3D 模型 → WebXR 资产管线

五个来源 → 四种许可 → GLB vs GLTF → 转换 ≠ 优化 → 归一化 → 场景 JSON + 许可卡

一、五个来源(课堂主推前三个)

站点想要什么时用许可课堂要点 / 坑
Poly Haven
polyhaven.com
真实感家具 / 道具全站 CC0(免署名、可商用)官方 API 可拿 gltf + 纹理多文件(正好练多文件转换);资产 id 大小写敏感(ArmChair_01 不是 armchair_01)
Poly Pizza
poly.pizza
低多边形 / 卡通CC0 / CC-BY 3.0(逐模型标注)网页下载,无需登录;批量 API 要 key,课堂不做
Khronos glTF 示例仓库
GitHub · glTF-Sample-Models
标准测试模型混合:CC0 / CC-BY / CC-BY-NC / 自定义raw 直链最稳;必须逐模型读许可(同一仓库里就混着 NC);CesiumMan.glb 要用旧仓库 490,956 B(新仓库已重导出为 438,044 B,对不上)
Kenney
kenney.nl
一整套同风格道具全站 CC0zip 资源包,下完解压再转
Sketchfab
sketchfab.com
只想看 / 讲许可陷阱CC / 标准许可(逐模型)下载必须登录,课堂不现场演示

二、许可:四种必须分清

许可能商用?要署名?能不能进你的作品
CC0(Public Domain)✅❌ 不要求可以最省事(ArmChair_01、Fox 的模型本体)
CC-BY(如 4.0)✅⚠️ 必须可以但作品里要写清作者与来源(CesiumMan、Fox 的绑定动画)
CC-BY-NC❌ 禁止商用⚠️ 要不能进作品只当“许可陷阱”案例(DamagedHelmet)
SCEA Shared Source(不是 CC)✅(无 NC 限制)Object Form 再分发免署名(§6)可以但要读条款(Duck;§3 禁止就它申请专利 / 寻求版权保护)
待核实未知未知只能写“待核实”(WaltHead.obj / SambaDancing.fbx 在 three.js 仓库没有许可声明)
DamagedHelmet 就是许可陷阱:3,773,916 B / 15,452 三角面 / 5 张纹理,看着最漂亮,但模型本体是 CC-BY-NC 4.0(禁止商用)。课程作品虽然不直接卖钱,但公开发布、参赛、展示都有商用风险——课堂口径:不进作品,只在 03 转换器里当“怎么读许可、怎么判定不能用”的案例(它也刻意没放进 models\ 内嵌页)。

三、GLB vs GLTF:为什么最后要“一个文件”

.glb(二进制 glTF).gltf(文本 glTF)
形态一个文件:几何 + 贴图 + 动画全打包一组文件:索引 .gltf + .bin + 贴图
传输 / 嵌入单文件,能直接内联进单文件页(base64)少一个文件就加载失败
file:// 双击✅ 可用❌ 常因 CORS / 相对路径失败
课堂结论交付用 GLB(WebXR 首选)下载时常拿到它(Poly Haven 就是 gltf+纹理),转一步再进作品

四、转换 ≠ 优化(本课最重要的一条数字)

把一个 GLB 原样“再转一次”:
  Duck.glb   120,484 B  ──03 模型转换器 GLB→GLB──▶  152,408 B    (+26.5%)

为什么变大?贴图重新编码、缓冲重排——「再转一次」不是优化。
真要变小:减面 / 贴图降采样 / Draco / meshopt(第 10 次课的内容)。
这条数字 430 现场会投出来(03 转换器的真实统计):你下载的模型转成 GLB 就完成“能用”,不是“变好”;“转了”和“优化了”是两件事。B 组作业里的“源大小 / 输出大小 / 变化%”就是让你亲眼记录这件事。

五、四个站内模型(真实字节 / 三角面 / 许可)

模型字节三角面动画许可(能否进作品)
Fox.glb162,8525763 段(Survey 3.42s / Walk 0.71s / Run 1.16s)模型 CC0(PixelMannen)+ 绑定动画 CC-BY 4.0(@tomkranis)→ 必须署名
CesiumMan.glb490,9564,6721 段(2.0s)CC-BY 4.0(另含 Cesium 商标条款,不是版权)→ 必须署名
Duck.glb120,4844,212无SCEA(非 CC;可商用、Object Form 免署名)→ 可以
ArmChair_01.glb768,5685,626无(3 张纹理)CC0(Kirill Sannikov / Poly Haven)→ 可以最省事

数据来自教师机 _manifest.json(真实解析 GLB 的 JSON chunk,不是估算);其中 Fox / Duck / ArmChair_01 三个文件已放到本站 assets/vr-2026/lesson8/models/ 供下载(许可原文见 models\README_许可.md)。

六、归一化:为什么导入后先“缩到 1.2 m”

不同来源的模型单位五花八门——有的 0.1 m 高、有的 10 m 高,原点有的在脚底、有的在中心。所以工作台导入时统一做三件事:缩放(NORM_HEIGHT = 1.2 米高)→ 贴地 → 居中。 不归一化,你的场景就是“巨人和蚂蚁”:Fox、CesiumMan、Duck、ArmChair 来自四个不同来源,进场景后全被缩到 1.2 m,这是资产管线的必要一步。

七、场景 JSON 与许可卡:把“摆好的东西”变成能带走的数据

场景 JSON(02 导出)

{
  "format": "workbench-scene",
  "unit": "meter",
  "modelCount": 4,
  "models": [
    { "id": "fox", "name": "Fox", "file": "Fox.glb",
      "license": "CC0 + CC-BY 4.0", "author": "PixelMannen / @tomkranis",
      "pos": [x,y,z], "rot": 45, "scale": 1.5, "color": "#ff0000",
      "anim": "Survey", "triangles": 576 }
  ]
}

实测:同一场景连续导出两次,字符串完全一致(可复现);VR 里摆的东西只有存成数据才带得走。

许可卡(B 组交 许可卡.txt,430 当众判卷)

┌ 资产许可卡(Asset License Card)┐
│ 资产名:______________________  │
│ 作者:________________________  │
│ 来源 URL:____________________  │
│ 许可:CC0 / CC-BY 4.0 /        │
│       CC-BY-NC / SCEA / 其他   │
│ 可商用:是 / 否                 │
│ 需署名:是 / 否                 │
│ 我改了什么:__________________  │
│ 结论:能进作品 / 不能 / 待核实  │
└──────────────────────────────┘

不确定就写“待核实”——编一个才是问题。

演

四个在线演示:一个页面只讲一件事

全部是单文件 WebXR(three.js 已内联、零外部请求):PC 打开看 PC 模式;用 https / 站点地址在头显浏览器打开,可直接进 VR

下面四页就是 646 与 430 用的同一套页面,全部在线打开、点开即用(不装软件、不用下载代码)。要进 VR 必须用 http(s)——头显浏览器里打开本站点地址即可。 每页左上角 HUD 都写着 PC / 头显操作;04 是“戴前 30 秒自检”,不是演示页。

01 交互实验室首屏:3D 场景与交互状态机 HUD、输入源检查器
DEMO 01 · Part 1 主演示
交互实验室:状态机 / 双手变换 / 吸附插槽 / poke
三个目标:把方块吸进插槽、双手把能量球缩放到 2 倍、Poke 直触按钮;右上角输入源检查器实时显示 handedness / profiles / gamepad;HUD 实时显示每个物体与每只手的状态机状态。
文件 677,112 B · 单文件零外部请求 · 三个目标:吸附 / 双手 scale 1→2 / poke;右上角输入源检查器实时刷新
02 模型工作台首屏:4 个内嵌模型卡片与场景统计 HUD
DEMO 02 · Part 2 主演示
模型工作台:4 个模型 / 归一化 / 本地导入 / 场景 JSON
内嵌 Fox、CesiumMan、Duck、ArmChair_01(许可角标在卡上);导入自动归一化到 1.2 m + 贴地 + 居中;拖 / 旋 / 缩 / 换色 / 播动画 / 复制删除;本地导入 .glb(不重新打包页面);导出场景 JSON。
文件 2,809,913 B · 4 个内嵌模型归一化到约 1.2 m · 导入后许可见「本地导入 · 请自行确认」· 场景 JSON 字段:pos/rot/scale/color/anim
03 模型转换器首屏:拖入文件、统计面板与导出 GLB 按钮
DEMO 03 · Part 2 工具页
格式转换器:GLB / GLTF / OBJ / FBX → 一个 GLB
拖入文件即可解析并统计(mesh / 三角面 / 材质 / 纹理 / 动画 / 源大小)→ 导出 GLB;支持 Poly Haven 风格多文件(.gltf + .bin + textures\ 里的贴图 一起拖)。这里能亲眼看到 “转换 ≠ 优化”。
文件 953,048 B · 支持 GLB/GLTF/OBJ/FBX → 一个 GLB · 支持 Poly Haven 多文件一起拖 · 转换≠优化(GLB→GLB 常变大)
纯 WebXR + DOM · 13,857 B · 无 three、无外部请求
DEMO 04 · 戴前 30 秒
头显自检页:先确认“这台能进 VR”
显示安全上下文 ✓ / navigator.xr 有 / immersive-vr 支持;点「进入 VR 自检会话」后实时显示帧率 / 输入源数量 / handedness / profiles / 按键数 / 轴数 / 触觉执行器 / 位姿 tracked;可触发一次手柄震动、复制自检结果。
用法:每次戴入前都做一遍;file:// 打开会明确提示“改用 http”,看到这句就说明你打开的是本地文件。http / file 两种打开均 ERRS:NO_ERROR。
01 交互实验室无头 Chrome 实测截图(1280×800)
01 交互实验室:左侧是状态机 HUD 与三个目标清单,右侧是输入源检查器——“哪只手、什么设备、按了什么键”一眼可见。
02 模型工作台无头 Chrome 实测截图(1280×800)
02 模型工作台:4 张模型卡都带许可角标,统计 HUD 显示模型数 / 三角面 / DrawCall / 纹理 / FPS。
03 模型转换器无头 Chrome 实测截图(1280×800)
03 模型转换器:左边是四类输入与统计,右边是“为什么转 GLB / GLB vs GLTF / 许可提醒”的说明区。

三张截图均为无头 Chrome 实测(1280×800,SwiftShader 软件渲染);数字是渲染规模,不是真机帧率——真机性能第 10 次课再上。

怎么打开最省事:PC → 直接点上面的卡片(新窗口),或从一页版作业页点工具链接;头显 → 头显浏览器打开本站点地址(必须 http(s),本地 file:// 进不了 VR)→ 先 04 自检 → 再进 01 / 02。
交

20 分怎么构成 · 交什么 · 怎么命名

A 组交互验证 10 分 + B 组模型管线 10 分;646 本场下课交,计入课程课堂作业 30% 的当次部分

一、分数构成(A 组 10 + B 组 10 = 20)

组分值拆分怎么拿分
A 组 · 交互验证动作 4 + 记录 4 + 一句话 2 = 1001 里 5 项都做到(吸附 / 双手 2× / Poke / 触觉 / 输入源三字段);每项写“状态怎么变 + 我观察到什么”;S1 截图;一句话答 squeeze vs select
B 组 · 模型管线转换 3 + 操作 3 + JSON 2 + 许可 2 = 1003 转出 GLB 并记体积变化;02 导入后完成旋转 45° / 缩放 1.5× / 换色 / 动画并截 S2;导出 scene.json 字段齐全;许可卡五项填满
两组各 10 分,合计 20 分;同组内不设“必做/加分”——按上面拆分逐项拿分。折算比例以教师最终通知为准(【待确认】)。430 的观察卡 / 头显体验 / 问答记为过程性评价(不单独计分)。
公开口径:全部提交作品都会放进「第 8 次课作品墙」(图片 + 一句话 + 许可);提交即视为同意以上内容公开展示;不同意公开 → 在 说明.md 第一行写「不公开」,教师按此不上墙。→ 打开作品墙

二、提交清单与命名规范

放进 学号_姓名_第8次课\命名要求(可直接发布到作品墙)
展示图(必交)S2.png16:9 · ≥1280×720 · 含页面 HUD · 不出现个人隐私(这张直接上作品墙)
一句话文案(必交)写在 说明.md 第一段≤30 字:我做了什么 + 一句结论(作品墙上显示这句)
许可卡(必交)许可卡.txt模型名 / 来源 / 许可 / 能否商用 / 是否署名;不确定写“待核实”
场景 JSON(必交)scene.json含 id / name / pos / rot / scale / color / anim,不是空文件
署名 / 公开设置说明.md作品墙按 学号_姓名 显示;不愿公开真名 → 第一行写 公开名:昵称;不同意公开 → 第一行写「不公开」
可选S1.png / S3.png / 转换的 .glbS1 用于评分(01 五项操作);S3 工作台全景;GLB 愿意交就放
交付方式:整个文件夹交教师指定的共享盘 / 群文件,文件名前缀 第8次课_学号_姓名。
提交前 60 秒自检:文件夹名有没有学号+姓名?S2 是不是 16:9、≥1280×720、含 HUD、无隐私?一句话够不够 30 字以内、能直接贴到网页上?JSON 打开是不是空的?许可卡五项填满了吗?
作品墙:全部提交作品都会放进「第 8 次课作品墙」(图片 + 一句话 + 许可)——提交即视为同意公开展示;不同意 → 说明.md 第一行写「不公开」。→ 作品墙
诚

诚实边界:哪些已经验过、哪些还没有

页面上的数字都来自真实无头验证;没有做的事不写成“已验证”

项事实课堂口径
真机头显本课四页在无头 Chrome + SwiftShader 软件渲染下实测 PASS;PICO / Quest 真机未实测(型号口径 PICO Neo3 / PICO 4 Ultra 并存,待确认)430 现场每次戴入前先做 04 自检;进不去就 PC 投屏,不硬撑
机房网络 / 站内下载作业用的 Fox / Duck / ArmChair 三个模型放在本站 models/,未在 646 机房网络实测下载下载失败 → 用 02 工作台已内嵌的 Fox 做 B2–B3;B1 体积对比改为记录内嵌模型大小
性能数字DrawCall / 三角面 / FPS 来自无头验证是“渲染规模”,不是“能跑 72Hz”;真机性能第 10 次课再上
M2 口径大作业任务书原定 10-28 交 M2 设计两张图;2026-10-27 换课+两段式后,本课课堂作业替代当次提交,动线图 / 状态机图并入第 9 次课M2 最终交付口径待教师确认(【待确认】);不写死、不替教师承诺
许可会变站点与仓库许可可能更新以 assets/vr-2026/lesson8/models/README_许可.md 与源站原文为准;不确定写“待核实”
头显数量 / 投屏可用台数与投屏方式课前才能定1 台 → 抽 2–3 人体验 60″;全坏 → 全程 PC 投屏
不要写成“已验证真机”:本课所有交互 / 模型页的真机 VR 会话、手柄扳机与握持、触觉执行器、双手同时抓取的手势识别都还没有真机验证记录。这一点在 430 会当面说清楚——诚实是这门课的评分项之一。
下

下一课 · 第 9 次课(2026-11-11):M3 硬门槛

“路要通、退得出、谁都点得到”——主流程能走通,且有一条免手柄也能走完的通路

第 7 次课(10-21)本次课(10-28,两段式)下次课(11-11)
一句话把“能做的事”做全先做后讲:交互装成系统 + 模型变成资产路要通、退得出、谁都点得到
学生产出交互测试台 + M1 选题一页纸课堂作业 3(一页版):交互验证记录 + 跑通的资产管线 + 许可卡M3 主流程可玩(硬门槛)
三句话收尾:零件要装成系统——状态机决定“什么条件下允许发生什么”;模型要过管线——下载 → 转换(≠优化)→ 导入(归一化)→ 存成 JSON;许可要写进卡——CC0 免署名、CC-BY 必须署名、CC-BY-NC 不能进作品,不确定写“待核实”。