Jellyfin Android TV版外部字幕支持问题分析与解决方案

Jellyfin Android TV版外部字幕支持问题分析与解决方案

jellyfin-androidtv Android TV Client for Jellyfin 项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-androidtv

问题背景

近期Jellyfin Android TV客户端在升级至0.18.x版本后，用户报告在使用Just Player等外部播放器时，视频文件的外部字幕（如.srt格式）无法正常显示。这个问题在0.17.9版本中并不存在，表明是版本升级引入的兼容性问题。

技术分析

从用户提供的详细测试情况来看，问题具有以下特征：

1. 版本相关性：0.17.9版本工作正常，0.18.0-0.18.2版本出现故障
2. 播放器无关性：测试使用同一版本的Just Player（v0.170）在不同Jellyfin版本下表现不同
3. 文件结构标准：用户采用标准命名规范的外部字幕文件（如movie.en.srt）

经过开发团队确认，这是由于0.18.x版本中引入的一个bug导致所有外部字幕在传递给外部播放器前被错误过滤。这个改动可能源于对播放器兼容性的优化，但意外影响了字幕传递流程。

解决方案

该问题已在0.18.3版本中得到修复。对于遇到此问题的用户，建议：

1. 升级等待：等待官方发布0.18.3版本更新
2. 临时回退：如需立即使用，可降级至0.17.9版本
3. 文件检查：确保字幕文件符合标准命名规范，与视频文件位于同一目录

技术建议

对于媒体服务器用户，建议：

1. 保持字幕文件的标准化命名（如movie.[语言代码].srt）
2. 重要播放场景建议进行版本升级前的兼容性测试
3. 定期备份客户端配置，便于版本回退

总结

这个案例展示了媒体客户端开发中的典型兼容性问题。Jellyfin团队快速响应并修复了字幕传递流程中的过滤逻辑错误，体现了开源项目对用户反馈的重视。用户在遇到类似播放问题时，可参考本文提供的分析思路进行排查。

jellyfin-androidtv Android TV Client for Jellyfin 项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-androidtv