docs: record the 8K Main 10 root cause, the OSD load order, and the watchdog
README gets a section on the watchdog; HANDOFF gets ADDENDUM 12 with the full
investigation: the failing file is HEVC Main 10 while every other 8K file is
Main, Jellyfin Web builds its device profile from canPlayType('hvc1.2.4.L183')
which over-claims, the server has no force-transcode switch, and the player UI
(including the quality menu) is only created after 'playbackstart' -- which is
why a stuck video has no quality menu to click.
Also records that src/00-core.js only ever probed Main-profile codec strings, so
the documented "8K HEVC supported" result was never true for 10-bit.
This commit is contained in:
@@ -54,6 +54,45 @@ python3 pack.py --bump --publish # 构建 → 打包 → 建 Release → 推 m
|
||||
> 老路子仍然可用,作为插件的兜底:`JF_PW=... python3 deploy.py`。
|
||||
> 但**两者不要同时开** —— 装了插件就别再跑 `deploy.py`(跑完插件也会把那个标签清掉)。
|
||||
|
||||
### 1.2 播放看门狗(卡住检测)
|
||||
|
||||
`src/40-watchdog.js`。针对一种很坑的失败:**某些设备/浏览器放不出来时,Jellyfin 的播放器界面根本不会被创建**。
|
||||
|
||||
原因(已从 Jellyfin Web 源码确认):播放器 UI 只在 `playbackstart` 事件之后构建,而 `playbackstart` 要等媒体真的起来了才会触发。加载顺序是:
|
||||
|
||||
```
|
||||
HtmlVideoPlayer.play() htmlVideoPlayer/plugin.js:502
|
||||
createMediaElement() :1802 转圈 + <div.videoPlayerContainer> + <video>
|
||||
(此时还没 src)
|
||||
setCurrentSrc() :593 elem.src = url
|
||||
→ loadedmetadata → canplay → play → 'playbackstart'
|
||||
→ OSD 控制器(apps/legacy/controllers/playback/video/index.js:591)
|
||||
```
|
||||
|
||||
媒体起不来 → `playbackstart` 不触发 → **码率菜单根本不存在**,页面上只剩一个转圈和一个 `videoWidth === 0` 的 `<video>`。所以「卡住之后调不了码率」不是菜单藏起来了,是菜单还没被创建。
|
||||
|
||||
看门狗就盯这个状态(`.videoPlayerContainer` 里的 `<video>` 仍然是 `videoWidth === 0`):
|
||||
|
||||
| | 阈值 |
|
||||
|---|---|
|
||||
| 媒体报错(`video.error`) | 立即弹 |
|
||||
| 直连没画面 | 15 秒 |
|
||||
| 转码(src 已经是 hls) | 45 秒(服务器要先出片) |
|
||||
| 已经有画面 | 立即退出,不打扰 |
|
||||
| VR 会话中 | 完全不跑 |
|
||||
|
||||
弹窗会写明**具体格式**(走 Jellyfin API 查 MediaStreams),并给 20/8/3 Mbps 三档 + 「继续等待」。选一档后写入 Jellyfin 自己那套 localStorage 键然后重载:
|
||||
|
||||
```
|
||||
maxbitrate-Video-<true|false> = 20000000
|
||||
enableautobitratebitrate-Video-<true|false> = false
|
||||
```
|
||||
|
||||
> 注意 `enableautobitratebitrate` 里 `bitrate` 确实出现了两次 —— 这是 Jellyfin 上游的拼写,照抄的。
|
||||
> 之所以不用 `playbackManager.setMaxStreamingBitrate()`:那个模块没暴露到 window(已实测 `window.playbackManager === undefined`,`window.Emby` 只剩 `Page`),所以只能写设置 + 重载。
|
||||
|
||||
选过之后 120 秒内不再打扰(记在 sessionStorage)。
|
||||
|
||||
---
|
||||
|
||||
## 2. Quest 3 实测数据(已用 ADB + CDP 在真机验证)
|
||||
|
||||
Reference in New Issue
Block a user