diff --git a/HANDOFF.md b/HANDOFF.md index 6ec007d..9687f2a 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -1,8 +1,8 @@ # Jellyfin Web VR180 — 项目交接文档 > 给新对话用。读完这份就能接手,不需要重新调查环境。 -> 最后更新:已部署版本 `2e32e6`(`NS.version = hud-6`;ADDENDUM 6 字幕深度/大小解耦 -> + 7 唤出门限/前面板精简 + 7b 锁按钮与「锁定」面板模式 + 8 画面拖动搬迁) +> 最后更新:已部署版本 `5217a3`(`NS.version = hud-7`;ADDENDUM 6 字幕深度/大小解耦 +> + 7 唤出门限/前面板精简 + 7b 锁按钮与「锁定」面板模式 + 8/8b 画面搬迁(实时拖动)) > 已在 Quest 浏览器里实机验证模块加载 + 锁定数学(`subLockAngle/subAngleDeg`,`errors: []`); > **VR 会话内的观感还没看过**。 @@ -285,7 +285,7 @@ WebXR 规范:需要 *transient activation*。前面不能有 `await`,否则 | 引导线(十字双光束) | ✅ 任何时候都显示 | | 面板唤出门限 | ✅ 只有指示线指向/靠近面板时才唤出;唤出那一下不算点击;500ms 内忽略 | | 锁按钮(面板不启动) | ✅ 面板媒体行的第五个按钮:上锁后切到「只显示锁」的最小面板,并同样自动隐藏;每次进 VR 重置为未锁 | -| 画面搬迁(180°窗口) | ✅ 面板进度条上方的拖动条:按住拖动,画面绕眼点左右上下转;连点 3 次复位;每次进 VR 回正前方 | +| 画面搬迁(180°窗口) | ✅ 面板进度条上方的拖动条:按住 0.5s 后拖动 = 搬画面;点一下 = 复位;每次进 VR 回正前方 | | 按压反馈 | ✅ 圆环放大 1.9× + 蓝填充 + 变白,300ms | | 字幕抓拖 | ✅ 注视选中 + 手移动拖(与视线解耦,避免转头就飘) | | 字幕深度/大小解耦 | ✅ 默认「锁定视角尺寸」:拉近/拉远只改深度,视角大小与画面位置不变 | @@ -412,8 +412,8 @@ subMode / subCanvasSize / subCrop / subTex / subOpacity / subPlacement subLockAngle / subAngleDeg / subTextDeg / subYOverZ ← ADDENDUM 6 ctlSubsOn / ctlSubDist / ctlSubAngle / ctlSubLock ← 控制条实际画出的值 ctlLock / ctlMode / ctlHold / pressAt / lastActivate ← ADDENDUM 7/7b 锁、面板保持与唤出判定 -videoYaw / videoPitch / videoAngleLive / videoRotMode ← ADDENDUM 8 画面搬迁 -videoRebuilds / videoReset / viewDrag / viewTaps +videoYaw / videoPitch / videoRotMode / videoTransformWritable ← ADDENDUM 8/8b 画面搬迁 +videoSpace / videoRebuilds / videoReset / viewDrag / frameErr ctlHidden / ctlVisible / ctlBeamOn / ctlDraws / ctlErr panelPose / grab / grabValue / saved errors[] 最近错误 @@ -470,7 +470,24 @@ errors[] 最近错误 拖动用**射线自身的方向差**而不是面板上的坐标:面板坐标挪几度就出界了,射线旋转无行程限制, 而且"光标下的那个点始终在光标下",才像"抓住画面拖"。 -**唯一的未知**:`XREquirectLayer.transform` 规范上可写,但运行时可能忽略。所以每会话探测一次 -(写一个已知旋转再读回):`live` = 每帧写 transform(零成本);`rebuild` = 只能重建媒体层, -那就只在**创建/松手/复位**时重建,拖动过程中画面在松手后追上。见 `stats.videoRotMode` / -`videoRebuilds`。**这条必须真机验证,离线测不出来。** +### 6.15 拖动为什么一开始"松手才动",以及复位为什么崩(ADDENDUM 8b) + +两个都是我的 bug,记在下面免得再犯: + +1. **探测用四元数分量比较 → 假阴性。** `q` 和 `-q` 是同一个旋转,运行时还可能返回归一化后的 + 值,所以"写进去再读回来比 y/w"会得出错误的"只读"结论。于是拖动走到重建分支,而那个分支 + 被限成"只在松手时执行" → 松手才动。**现在比 `position`**(精确、无符号歧义)。 +2. **复位崩溃 = 先建后毁。** 同一 `