# 存档说明 ·「故宫有字」A-Frame 原型（第一代）

## 这是什么

课程 VR 场景的**第一代原型**，做于 **2026-09-21**，用 A-Frame 写成。
它的目的有两个，都不是"做一个好看的场景"：

1. **验证 PICO 浏览器到底支不支持 WebXR** —— 当时课上最大的未知数就是这个；
2. **复现参考视频里那种课堂演示形态** ——「浏览器 + 3D 场景 + 图文讲解 + 热点跳转」。

它做到了两件后来一直沿用的事：

- 页面上那四行**能力自检**（安全上下文 / `navigator.xr` / `immersive-vr` / 进入 VR 按钮），
  并且写明了一条至今仍然关键的话：**不是安全上下文时 `navigator.xr` 缺失是正常的，不能据此判断设备支不支持**；
- **用视线注视（fuse 1.2 秒）触发热点跳转**——这个交互范式后来成了本课程 VR 演示的默认做法
  （因为课堂上一半的故障都出在手柄上）。

## 现在它的位置

| 代际 | 工程 | 技术栈 | 现在放哪 |
| --- | --- | --- | --- |
| **第一代（本页）** | 故宫有字 · 图文导览原型 | A-Frame | 这里 |
| 第二代 | 太和殿 · 故宫沉浸式场景（含性能实测文档） | A-Frame | `../legacy-aframe/` |
| **第三代（主线）** | 紫禁城 WebXR 沉浸漫游 + 7 个逐点演示 | 自写 Three.js | `../gugong_webxr.html`、`../demos/` |

## 两点如实说明

- **保留原样存档，没有做任何修改**（含它的四行自检与 4 个热点）。
- **它从未在真实头显上验证过**。当时的进度记录写得很清楚：卡在"需要在头显上做一次安全上下文有效的测试"这一步——
  手上没有设备。所以本页只能保证"页面逻辑与场景完整"，**不能保证 PICO 上一定能进沉浸模式**。
  要验证环境，请用 `../../check/`（VR 作品自检）。

## 文件构成

| 文件 | 说明 |
| --- | --- |
| `index.html` | 场景与四行自检面板（A-Frame 声明式写法） |
| `js/demo.js` | 讲解内容、用 Canvas 生成中文贴图（A-Frame 默认字体不含中文字形）、能力自检逻辑 |
| `js/aframe.min.js` | A-Frame 本地库（**不依赖 CDN**，断网可用） |

> 原工程里的 `README.md` 与两个 `start-*.bat`（USB 转发 / 局域网启动脚本）**没有收录**——
> 它们写的是本机开发时的绝对路径与操作步骤，属于开发环境信息，不适合公开页面。
> 需要那套"USB + `adb reverse` / 局域网 + 白名单"的做法，见
> [`../../student/`](../../student/)（学生作品 · 联网自验工作流）。
