Ani 项目 Jellyfin 数据源字幕支持的技术实现分析

背景与需求

在媒体播放领域，字幕是提升非原生语言内容观看体验的重要功能。Ani 作为一款开源媒体播放工具，用户提出了通过 Jellyfin 数据源获取字幕的功能需求。这一需求源于用户观看 Blu-ray 内容时对多语言字幕支持的实际使用场景。

技术现状

当前 Ani 4.0.1 版本存在以下技术特点：

1. 播放器内核尚未采用 mpv 架构
2. 现有架构对 Jellyfin 提供的字幕支持有限
3. 字幕处理能力受限于当前播放引擎的设计

解决方案演进

开发团队提出了两个阶段的技术路线：

短期方案

通过 #1408 代码提交实现基础字幕支持，预计在下一版本发布。这一方案将：

• 扩展 Jellyfin 数据源接口
• 增加字幕文件识别逻辑
• 实现基础的字幕渲染功能

长期规划

计划将播放器内核迁移至 mpv 架构，这将带来：

1. 原生支持更多字幕格式（ASS/SSA/SRT等）
2. 更精确的字幕时间轴同步
3. 高级字幕渲染效果（阴影、描边等）
4. 动态字幕样式调整能力

技术实现细节

实现完整的字幕支持需要处理以下关键技术点：

1. Jellyfin API 集成

   • 扩展现有媒体项查询接口
   • 增加字幕资源发现机制
   • 处理字幕元数据（语言、格式等）

2. 字幕处理流水线

   • 文件下载与缓存管理
   • 编码自动检测与转换
   • 时间轴校正算法

3. 渲染引擎适配

   • 字体回退机制
   • 分辨率自适应
   • 硬件加速支持

用户价值

完整实现后将带来显著体验提升：

• 支持多语言字幕切换
• 保持与原始媒体相同的字幕体验
• 消除转码导致的字幕同步问题
• 保留特效字幕的完整呈现

未来展望

随着 mpv 内核的引入，Ani 将具备更强大的媒体处理能力，为后续功能如：

• 实时字幕翻译
• AI 字幕生成
• 交互式字幕笔记 等创新功能奠定技术基础。