Jellyfin Android TV客户端蓝牙音频播放问题分析与修复

Jellyfin Android TV客户端蓝牙音频播放问题分析与修复

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

问题背景

在Jellyfin Android TV客户端v0.17.0-beta.4版本中，用户报告了一个与蓝牙音频相关的播放故障。当使用第一代Fire Stick 4K设备时，如果连接了蓝牙耳机进行音频输出，视频播放会立即失败并显示"too many errors"错误信息。而通过电视扬声器输出音频时则完全正常。

问题表现

该问题具有以下典型特征：

1. 在播放开始时如果已连接蓝牙耳机，播放会立即失败
2. 如果在播放过程中连接蓝牙耳机，播放也会立即中断
3. 问题出现在所有音频设置组合下（包括Direct/Stereo模式和Bitstream AC3开关的各种组合）
4. 前一版本v0.16.11不存在此问题

技术分析

这个问题属于音频输出路径切换导致的播放异常。在Android TV平台上，当音频输出设备从默认的HDMI（电视扬声器）切换到蓝牙设备时，系统需要重新初始化音频处理管道。在这个过程中，如果播放器没有正确处理音频设备变更事件，就会导致播放中断。

对于Fire Stick这类资源有限的设备，蓝牙音频处理会带来额外的计算负担，可能触发以下潜在问题：

• 音频缓冲区处理异常
• 编解码器重新初始化失败
• 音频/视频同步丢失

解决方案

开发团队已经确认该问题并在内部修复（通过PR #3786）。修复方案主要涉及：

1. 增强音频设备变更事件的监听和处理逻辑
2. 优化播放器在音频输出设备切换时的状态管理
3. 改进错误恢复机制，避免因短暂的音频路径切换导致播放完全中断

用户建议

对于遇到此问题的用户，可以采取以下临时解决方案：

1. 暂时使用电视扬声器进行音频输出
2. 回退到v0.16.11稳定版本
3. 等待包含修复的下一个版本发布

该修复将包含在即将发布的版本中，届时用户可以正常使用蓝牙耳机进行播放。对于其他Android TV设备用户，如果遇到类似问题，也可以参考此解决方案。

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