# Jellyfin Web VR — Quest 3 / WebXR MVP 给 Jellyfin Web 播放页注入一个「VR 播放」按钮,在 Meta Quest 3 浏览器里直接进入 VR180 / VR360 沉浸播放,不用再手动切全屏 + 选投影。 --- ## 1. 当前部署状态 已注入到 `192.168.123.199` 上的 Jellyfin 容器 `Jellyfin`(当前版本 `mvp-2e32e6`,`NS.version = hud-6`,含 ADDENDUM 6 + 7 + 7b + 8): | 项 | 值 | |---|---| | 脚本 | `/jellyfin/jellyfin-web/jfvr-mvp.js`(容器内) | | 注入点 | `/jellyfin/jellyfin-web/index.html` 的 `` 之前 | | 备份 | `/vol2/jellyfin/config/_vr_backup/index.html.orig` | | 两个入口都生效 | `http://192.168.123.199:8096/web/` 与 `https://jellyfin.cat-shark.xyz/web/` | > ⚠️ 注入写在**容器内文件**里,`jellyfin/jellyfin:latest` 一升级就没了,重跑 `deploy.py` 即可。 > 正式版应改用 **JavaScript Injector 插件**(`n00bcodr/jellyfin-plugins` 的 `12/manifest.json`,targetAbi 12.0.0.0) > 或 **File Transformation**,这样升级不丢、可开关。 --- ## 2. Quest 3 实测数据(已用 ADB + CDP 在真机验证) ### 2.0 设备与能力 ``` Quest 3 Android 14 (SDK 34) build UP1A.231005.007.A1 Quest Browser 152.1.0.34.52.1079628208 (Chromium 152.0.7977.83) UA Mozilla/5.0 (X11; Linux x86_64; Quest 3) ... Chrome/152 ... VR Safari/537.36 ``` | 检测项 | `http://192.168.123.199:8096` | `https://jellyfin.cat-shark.xyz` | |---|---|---| | `isSecureContext` | false | **true** | | `navigator.xr` | false | **true** | | `immersive-vr` | — | **true** | | **`XRMediaBinding.createEquirectLayer`** | — | **true** ← 首选路径可用 | | `XRWebGLBinding` | — | true ← 回退路径可用 | | `MAX_TEXTURE_SIZE` | 8192 | 8192 | | `MAX_RENDERBUFFER_SIZE` | 16384 | 16384 | | 8K HEVC `decodingInfo` | supported / powerEfficient | **supported:true, powerEfficient:true** | 结论:**HTTPS 下 Quest 浏览器提供全部所需 WebXR 能力,8K HEVC 走硬件解码。** ### 2.1 网络实测:HTTPS 域名在 Quest 上就是内网直连 ``` Quest 3 IPv6 : 2409:8a14:44a:e360:70b9:446e:d5f7:10a7/64 NAS IPv6 : 2409:8a14:44a:e360:520:8aa2:7736:4f12/64 ← 同一 /64 domain AAAA → NAS 自己的局域网 IPv6 服务端连接表 : [NAS]:443 ← [Quest]:35860 (ESTAB, IPv6) ``` 60 MB 文件在 Quest 浏览器上实测: | Run | 吞吐 | TTFB | |---|---|---| | 1 | 450 Mbps | 11 ms | | 2 | 620 Mbps | 7 ms | | 3 | **702 Mbps** | 12 ms | 对比:从局域网 PC 用 curl 走 IPv6 只有 4.29 MB/s(34 Mbps),走 IPv4 阿里云中转只有 94 KB/s。 > 慢的根因:NAS 上跑着 **`npc` 内网穿透客户端**,域名的 **A 记录 `39.105.149.197` 是阿里云上的 nps 服务端**, > 走 IPv4 就是 NAS → 阿里云 → 你。**走 IPv6 则完全不出内网。** > > 所以 **不需要为了速度退回 HTTP**。8K 片源码率仅 21 Mbps,702 Mbps 有 30 倍余量。 ### 2.2 如果仍想用 `192.168.123.199:8096` WebXR 要求「安全上下文」。实测结果: | 入口 | `isSecureContext` | `navigator.xr` | WebXR | |---|---|---|---| | `http://192.168.123.199:8096` | **false** | **false** | ❌ 需先做 §2.1 | | `https://jellyfin.cat-shark.xyz` | true | true | ✅ 直接可用 | 用内网 HTTP 地址 —— Quest 浏览器开 flags Meta Quest 2/3/3S(**OS 79+**)浏览器支持在 HTTP 模式下使用 WebXR,需显式授权: 1. Quest 浏览器地址栏输入 `chrome://flags` 2. 搜索 `insecure` 3. 启用 **`unsafely-treat-insecure-origin-as-secure`** 4. 在下方输入框填:`http://192.168.123.199:8096` (**必须带 `http://` 和端口号**;多个用逗号分隔) 5. 点空白处失焦 → 屏幕底部出现 **Relaunch** → 点它 6. 回到 `chrome://flags` 确认 flag 仍启用且 URL 已保存 代价:这台设备专属、浏览器更新后可能需要重设。 ### 2.3 兜底:让局域网内解析到内网 IPv4 如果某天 IPv6 不可用,且 Quest 落到了 IPv4(阿里云中转)导致慢,最一劳永逸的修法是在 **OpenWrt 路由器(192.168.123.1)** 上加一条静态解析,让局域网内所有设备都解析到内网 IP: - LuCI:`网络 → DHCP/DNS → 一般设置 → 地址`,添加 `/jellyfin.cat-shark.xyz/192.168.123.199` - 或 SSH 到路由器: ```sh uci add_list dhcp.@dnsmasq[0].address='/jellyfin.cat-shark.xyz/192.168.123.199' uci commit dhcp && /etc/init.d/dnsmasq restart ``` 之后 `https://jellyfin.cat-shark.xyz` 在局域网内全程走内网,证书依然有效,所有设备(不只 Quest)都受益。 --- ## 3. 实操:如何在真机上验证(ADB + CDP) ```bash ADB=/opt/SideQuest/resources/platform-tools/adb # SideQuest 自带的 adb # 1) 看设备(SideQuest 的无线 ADB) $ADB devices -l # 2) 把 Quest 浏览器的 DevTools 端口转发出来 $ADB forward tcp:9222 localabstract:chrome_devtools_remote curl -s http://127.0.0.1:9222/json/version # 3) 让 Quest 打开某个页面 $ADB shell am start -a android.intent.action.VIEW \ -d "http://192.168.123.199:8096/web/index.html" \ -n com.oculus.browser/.OculusLauncherActivity # 4) 截图 / OCR $ADB exec-out screencap -p > /tmp/quest/shot.png # 4128x2208 tesseract /tmp/quest/shot.png - --psm 6 ``` 拿到 `9222` 后可以直接用 `agent_browser --cdp http://127.0.0.1:9222` 接管 Quest 浏览器, 在页面上跑 `Runtime.evaluate`、读网络、发输入事件。 > 注:Quest 浏览器**不把 `console.log` 转发到 logcat**,所以诊断要走 CDP `Runtime.evaluate` 或页面 UI。 --- ## 4. 使用步骤(Quest 3 里) 1. 打开 Jellyfin(§2.1 或 §2.2 任一入口) 2. 进媒体库,播放一个 VR 视频 3. 右下角出现蓝色 **「VR 播放」** 按钮 → 点它 4. 面板里确认 **投影**(180°/360°)和 **立体**(单目/左右/上下) - 自动按文件名 + 分辨率判断;**8192×4096(2:1)会默认选 180° + 左右** 5. 点 **「进入 VR」** → 进入沉浸模式;摘头显即退出 进不去时展开面板里的 **「诊断信息」**,把内容贴回来。 --- ## 5. 在 VR 里修掉的两个关键缺陷 真机(Quest 3 + CDP)实测发现并修复: ### 5.1 卡顿 —— 帧率不匹配(3:2 pulldown) | 项 | 实测值 | |---|---| | 视频帧率 | **59.94 fps** | | XR 会话默认 | **90 Hz**(实测 87.9 fps) | | `session.supportedFrameRates` | `[72, 80, 90, 120]` | | `session.frameRate`(初始) | **0**(未指定) | 90 ÷ 59.94 = 1.5 → 视频帧在显示上被交替重复 1 次、2 次 —— 经典 3:2 pulldown 抖动。 2D 播放时系统会自动匹配刷新率,所以「web 端流畅、进 VR 就卡」。 **修复**:进 VR 后调用 `session.updateTargetFrameRate(120)`。120 ÷ 60 = 2,每帧均匀显示两次。 ``` 修复前 fps : 87.9 修复后 fps : 114.9 (20 秒稳定 111–115,丢帧 0.000%) ``` ### 5.2 字幕丢失 —— libass 被冻结 两个独立原因叠加: **(a) 字幕画布不在 XR 场景里。** Jellyfin Web 12 用 libass 渲染 ASS 到独立的 `canvas.libassjs-canvas`,和 `