Remux播放体验深度解析:probe数据如何让流式内容拥有本地文件级的轨道选择体验
Remux播放体验深度解析:probe数据如何让流式内容拥有本地文件级的轨道选择体验
Remux 是一款 Jellyfin 兼容 API 的自建媒体服务器,它把 Stremio 插件、本地文件、WebDAV 与种子源统一起来。而让流式内容"不输本地文件"的关键,正是它背后的 probe 数据:完整的音轨、字幕轨与视频编码元数据,让多音轨、多字幕切换开箱即用。
一、probe 数据是什么:播放前的"体检报告"
在 Remux 中,probe 数据(probe_data)是服务器对每一路媒体流做探测后得到的元数据快照,内容包括:
- 🎬 视频轨:编码(H.264 / HEVC 等)、分辨率、码率、帧率、HDR 类型、色深
- 🔊 音频轨:编码、声道布局(Stereo / 5.1 / 7.1)、采样率、语言
- 💬 字幕轨:语言、强制字幕、听障字幕、图片字幕或文本字幕
- 📊 文件级信息:总时长、总码率、文件大小、容器格式
这些数据以 Jellyfin 的 MediaSourceInfo 结构下发给客户端,因此 Infuse、Swiftfin、Jellyfin 官方客户端等无需任何改动,就能在播放器里看到完整的轨道选择面板。官方说明可直接参考 README.md 中的 "Probe data for streams" 特性条目。
二、为什么流媒体内容的轨道选择一直是痛点
传统流媒体源(如 Stremio 插件返回的 URL)只给你一个"播放地址",客户端拿到后往往只知道"有画面、有声音":
| 场景 | 没有 probe 数据 | 有 probe 数据 |
|---|---|---|
| 多音轨剧集 | 只能听默认音轨 | 按语言精确选择(英语 / 日语 / 国语…) |
| 多字幕源 | 字幕丢失或只能外挂 | 内置字幕按语言、强制标记一键切换 |
| 转码决策 | 盲目转码或直接播放 | 依据真实编码决定是否直连 / 转码 |
Remux 的目标,就是让每一路流式内容在播放前都拥有一份和本地文件同等质量的"体检报告"。
三、probe 数据的三个来源:ffprobe、RemuxDB、文件名推断
Remux 按可靠性优先级,为每个候选流收集 probe 数据(见 probe.rs):
1. 本地 ffprobe 探测(最权威)
服务器直接调用 ffprobe 解析媒体 URL,提取 streams、format 与 chapters(见 ffprobe_args):
2. RemuxDB 社区元数据(免探测秒开)
对于热门剧集,Remux 可以直接使用 RemuxDB 社区共享的 probe 数据,无需等待探测即可完成轨道展示。测试用的样例数据可以直观感受一份 probe 长什么样(h264 1080p 视频轨 + AAC 5.1 音频轨,来源标记为 remux_db):
3. 文件名推断(兜底方案)
当两种途径都不可用时,Remux 会从发布文件名推断编码、分辨率、容器等信息(见 apply_filename_guess)。
⚠️ 关键设计:三份数据都被打上 来源标记(ProbeOrigin:ffprobe / remuxdb / filename-guess)。"文件名推断"永远不会冒充真实探测——它只用于展示与排序,播放决策路径上会被识别并跳过(#L1223-L1238),杜绝"看着像 4K 实际播不了"的尴尬。
四、从原始数据到"本地文件级"的轨道选择体验
probe 数据并不只是"存下来",Remux 做了大量细节打磨,让客户端看到的轨道列表和本地文件一样清晰:
- 语言标准化:把
ger→deu、chi→zho等旧代码统一为现代代码(normalize_lang),保证客户端按语言筛选不出错 - 人类可读的轨道标题(DisplayTitle):
- 视频轨 →
1080p HEVC HDR10(分辨率 + 编码 + HDR 类型,display_title_video) - 音频轨 →
Dolby Digital - Stereo、DTS - 7.1(编码友好名 + 声道布局,display_title_audio) - 字幕轨 →
English - Forced(语言 + 强制/听障标记,display_title_subtitle)
- 视频轨 →
- HDR 精确识别:
smpte2084识别为 HDR10、arib-std-b67识别为 HLG(#L853-L865),让设备能力匹配更精准 - 默认轨严格尊重容器标记:只有真实带
default标记的音轨才算默认轨,不靠"第一条"硬凑(#L978-L983) - 章节转片段:ffprobe 的 chapters 会被识别为片头 / 片尾 / 预告 / 广告等片段(chapters_to_segments),由内置的 Probe Segments 插件合并各源片段后提供给客户端(addons/probe.rs),实现"跳过片头"等体验
五、智能容错:缓存、重试与降级,保证"总能播"
probe 不是"一次探测管终身",Remux 围绕它建立了一套完整的容错机制(probe_stream):
- 缓存命中直接用:已持久化的 probe 数据先校验源 URL 存活,存活则零探测开销返回
- 缓存过期才重探:H.264 流缺少转码判断所需的
RefFrames时,自动补一次本地 ffprobe(needs_reprobe) - 换源重试:主候选探测失败时,自动按"同为 P2P、同分辨率标签"筛选备选源依次尝试(select_candidates)
- 坏源过滤:探测出的时长远小于已知片长(如版权占位片、报错页)会被判定为失败并继续尝试下一个源(#L1537-L1570)
- 降级兜底:新探测彻底失败时,宁可回退到旧的 probe 缓存,也尽量不让播放失败(#L1389-L1398)
- 错配保护:探测结果与条目登记的文件大小不符时打 10 分钟临时标记,防止把"A 文件的报告"长期安在"B 文件"头上(#L1251-L1280)
拿到 probe 数据后,播放决策引擎会结合设备档案(DeviceProfile)+ 用户策略决定直连、直流还是转码(build_transcode_decision),字幕则按 外挂 / 内嵌 / 烧录 三条路径分发(apply_subtitle_delivery)——而这一切的前提,都是 probe 数据里那份真实的轨道清单。
六、对普通用户意味着什么
- ✅ 即装即用:无论内容来自插件、WebDAV 还是种子,轨道面板与本地文件体验一致
- ✅ 兼容现有客户端:Jellyfin 协议原生支持,无需换客户端、无需装插件
- ✅ 少转码、快开始:探测数据让直连判断更准,减少无谓转码,秒开率更高
- ✅ 自动避坑:坏源、占位片、过期缓存都会被自动识别并绕行
💡 相关迁移记录(probe 数据存储于扫描文件表)可参考:202610030001_addon_probe_on_scan.sql
七、关键路径速览
| 模块 | 路径 | 作用 |
|---|---|---|
| probe 核心 | crates/remux-server/src/playback/probe.rs | ffprobe 探测、解析、缓存与重试 |
| 播放决策 | crates/remux-server/src/playback/decision.rs | 直连 / 转码 / 字幕分发决策 |
| 片段插件 | crates/remux-server/src/addons/probe.rs | 从 probe 数据提取片头片尾等片段 |
| 文件名推断 | crates/remux-server/src/conversions.rs | 无探测数据时的兜底推断 |
| 测试样例 | crates/remux-server/src/testdata/ | 真实的 probe 数据样例 |
一句话总结:Remux 用 ffprobe 实探、RemuxDB 共享与文件名推断三层来源,配合缓存、重试、降级六道容错,把"流媒体 URL"变成了"有完整轨道清单的媒体文件"——这正是它的流式内容能拥有本地文件级轨道选择体验的全部秘密。

