# 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/` | > ⚠️ 老路子(`deploy.py`):注入写在**容器内文件**里,`jellyfin/jellyfin:latest` 一升级就没了, > 得重跑 `deploy.py`。**现在已经有插件版了,见下面 §1.1,优先用插件。** ### 1.1 插件化(推荐,已实现) JFVR 同时也是一个标准的 **Jellyfin 插件**,通过自建 Gitea 仓库分发,走 Dashboard 的 「添加存储库 → Catalog 安装」,**不再改容器内任何文件**。 | 项 | 值 | |---|---| | 插件仓库地址 | `https://git.cat-shark.xyz/cat-shark/jellyfin_vr_web_plugin/raw/branch/main/manifest.json` | | 插件名 / GUID | `Jellyfin Web VR` / `7d33ef59-f9b0-412b-93bd-5cd5353018de` | | 目标 ABI | `12.0.0.0`(Jellyfin 只保留 `targetAbi <= 服务器版本` 的条目,所以一份包覆盖整个 12.x) | | 插件代码 | `plugin/Jellyfin.Plugin.JFVR/`(C#,net10.0,对 `Jellyfin.Controller 12.1.0`) | | 打包 / 发布 | `python3 pack.py` / `python3 pack.py --bump --publish` | | 脚本端点 | `/JFVR/jfvr.js`(bundle 内嵌在 DLL 里,URL 带内容哈希做缓存键) | | 状态查询 | `/JFVR/status` | | 设置页 | Dashboard → 插件 → Jellyfin Web VR(开关注入 / 覆盖脚本 URL) | **安装**:Dashboard → 插件 → 目录 → ⚙️ → ➕ → 粘贴上面的仓库地址 → 保存 → 在 Catalog 里找到 **Jellyfin Web VR** → 安装 → **重启 Jellyfin**。 **工作方式**:`ScriptInjectionStartupFilter` 在**请求时**把 `` 插到 `index.html` 的 `` 之前。磁盘上的 `/jellyfin/jellyfin-web/` 一个字节都不动, 所以升级 Jellyfin 不会丢。如果检测到老 `deploy.py` 留下的 `