From cf731c16c22932a7c15070da7ff0bbc5951c6176 Mon Sep 17 00:00:00 2001 From: catShark <1716967236@qq.com> Date: Sun, 18 Oct 2026 11:58:23 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20ADDENDUM=2013=20=E2=80=94=20the=20real?= =?UTF-8?q?=20root=20cause=20is=20nvidia-vaapi-driver=200.0.14?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Records the full evidence chain (VAAPI fails at 8K Main 10 while CUDA/NVDEC and 8-bit 8K both work; chrome://gpu shows the driver advertising Main 10 up to 8192x8192), the upstream bug (self-referential CUVIDDECODECREATEINFO initializer, fixed in 0.0.18), the correct Chrome/VAAPI setup on Kubuntu, and what it means for the plugin (nothing once the driver is updated; and why 0.5.0.0's gate was wrong and 0.5.1.0 fixed it). --- HANDOFF.md | 98 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 98 insertions(+) diff --git a/HANDOFF.md b/HANDOFF.md index 373c4f5..c8cf03d 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -935,3 +935,101 @@ window.__JFVR.capsDiag() - [ ] 探测目前只覆盖 HEVC。AV1 / VP9 走同一套机制,但库里没有这类片源,先不做。 - [ ] 网络带宽那一维不在设备档案范围内(档案是在播放开始时判一次的)。Jellyfin 自带的 Auto 码率探测管这个。 - [ ] 看门狗(§1.2)现在退居为纯兜底:如果检测结果准了,它就不应该再触发。它仍然保留,作为「声称能播结果没播出来」的最后一道。 + +--- + +## 19. ADDENDUM 13 — 真机根因:`nvidia-vaapi-driver` 0.0.14 的自引用初始化器 + +### 19.1 结论(先看这个) + +本机(Kubuntu / NVIDIA TU116M GTX 1660 Ti Mobile / Chrome 152)播不了 8K Main 10, +**根因不在 Jellyfin、不在插件、也不在显卡硬件**,而在 `nvidia-vaapi-driver` 的版本: + +``` +已安装: nvidia-vaapi-driver 0.0.14-1 (2025-06-08,Ubuntu 26.04 仓库里只有这个) +已修复: 0.0.18 (2026-08-31) +``` + +**升级到 0.0.18 即可,不需要转码、不需要插件做任何补偿。** + +### 19.2 证据链 + +**1) 硬件能做,中间层不行** —— 同一文件、同一台机器: + +| 路径 | 结果 | +|---|---| +| `ffmpeg -hwaccel vaapi`(走 nvidia-vaapi-driver) | ❌ `Failed to create decode context: 2 (resource allocation failed)` | +| `ffmpeg -hwaccel cuda`(直连 NVDEC) | ✅ 正常 | +| VAAPI 解 8K **Main(8-bit)** | ✅ 正常 | +| VAAPI 解 1080p **Main 10** | ✅ 正常 | + +→ 只有 **8K + 10-bit** 这个组合失败;硬件本身没问题。 + +**2) Chrome 侧的配置是对的** —— `chrome://gpu` 实测: + +``` +Graphics Feature Status + * Video Decode: Hardware accelerated ← VAAPI 生效中 +Video Acceleration Information + Decode hevc main : 144x144 to 8192x8192 pixels + Decode hevc main 10 : 144x144 to 8192x8192 pixels ← 驱动"声称"支持 +``` + +**驱动声称支持 8K Main 10,实际建不出解码器。** 于是: + +``` +canPlayType('hvc1.2.4.L183') → truthy + → Jellyfin Web 声明 maxHevcLevel=183 / main|main 10 + → 服务器选 DirectPlay(日志里没有任何 ffmpeg) + → Chrome 真正解码时 cuvidCreateDecoder 失败 + → 黑屏 / 一直转圈(而 OSD 只在 playbackstart 之后创建,所以连码率菜单都没有) +``` + +**3) 上游 bug** —— 0.0.14 的 `src/vabackend.c`: + +```c +CUVIDDECODECREATEINFO vdci = { + .ulWidth = vdci.ulMaxWidth = vdci.ulTargetWidth = picture_width, // ← 在自身初始化器里引用自己 + .ulHeight = vdci.ulMaxHeight = vdci.ulTargetHeight = picture_height, // C 里这是未定义行为 +``` + +修复提交 `a565237`(2026-07-09)标题即 **"fix: drop self-referential CUVIDDECODECREATEINFO initializer"**, +把赋值移出初始化器;`#449`(2026-07-17 合入)把同样的修复镜像到另一个函数。**0.0.17 仍有问题,0.0.18 已修复。** + +### 19.3 Kubuntu 上正确让 Chrome 用显卡 + +用户现有的启动参数**是对的**(`chrome://gpu` 已确认 `Video Decode: Hardware accelerated`): + +``` +--enable-features=VaapiOnNvidiaGPUs,VaapiVideoDecodeLinuxGL,VaapiVideoDecoder +--disable-features=UseChromeOSDirectVideoDecoder +``` + +配套条件: + +- `nvidia-vaapi-driver` **≥ 0.0.18**(当前 0.0.14 → 这是要补的一环) +- 驱动 README 要求内核参数 `nvidia-drm.modeset=1`(**本机当前未设置**,`/proc/cmdline` 里没有) +- `LIBVA_DRIVER_NAME=nvidia` +- 注意:驱动 README 明说 *"specifically designed to be used by Firefox … may not operate correctly in other applications"*、*"Chrome is currently unsupported"*。Chrome 能用但不受官方支持。 + +升级(Ubuntu 仓库只有 0.0.14,需从源码构建): + +```bash +sudo apt install meson ninja-build libva-dev libegl-dev gstreamer1.0-plugins-bad libffmpeg-nvenc-dev +git clone --branch v0.0.18 https://github.com/elFarto/nvidia-vaapi-driver +cd nvidia-vaapi-driver && meson setup build && sudo meson install -C build +``` + +### 19.4 这对插件意味着什么 + +升级驱动后:Chrome 能真正解 8K Main 10 → `decodingInfo` 报 `smooth:true` → 插件不拦任何档 +→ 直连 8K → 看门狗也不会触发。**插件侧不需要做任何补偿。** + +但 **0.5.0.0 的判定逻辑本身有个缺陷,已在 0.5.1.0 修掉**:它在 `smooth === false` 时就压低 +level 上限,而 Jellyfin 的档案**无法表达「Main 支持到 8K,Main 10 只到 4K」**(level 上限和 +profile 列表来自同一条 Main 10 判断链)。所以在那台「8-bit 8K 正常、10-bit 8K 失败」的机器上, +拦掉 `2:183` 会把**整库 61 个 8-bit 8K 文件**一起拖进转码 —— 而 NAS 转 8K 只能出 1280×640。 + +0.5.1.0 改成:**只有当同位深的 Main(8-bit)档也不可用时,才压低 level 上限**(为此补测了 +Main L5.1 / L6.1 / L6.2 作为对照)。代价是「8-bit 能解、10-bit 不能」的设备仍会声称 10-bit 并在 +那种文件上黑屏 —— 那正是 `40-watchdog.js` 存在的意义。