Jellyfin Android客户端直播流停止播放问题解析

问题背景

在Jellyfin Android客户端(2.6.0版本)中，当用户停止播放电视直播流(如通过M3U调谐器)时，系统未能正确释放调谐器资源。这一问题源于客户端发送的播放停止信息不完整，导致服务器端无法执行正确的资源清理流程。

技术分析

问题本质

Jellyfin服务器端在处理直播流停止事件时，需要客户端提供LiveStreamId字段来识别并关闭特定的直播流。然而，Android客户端当前实现中：

1. 在构造PlaybackStopInfo对象时，仅包含基本字段(ItemId、PositionTicks、PlaySessionId和Failed)
2. 缺少关键的LiveStreamId字段传递
3. 导致服务器无法执行CloseLiveStream操作

对比分析

其他客户端如Jellyfin Media Player发送的停止播放信息包含完整字段：

• VolumeLevel
• IsMuted
• IsPaused
• LiveStreamId
• 其他播放状态信息

而Android客户端仅发送：

• ItemId
• PositionTicks
• PlaySessionId
• Failed

影响范围

该问题主要影响：

1. 使用集成播放器(ExoPlayer)播放直播流的情况
2. 使用M3U调谐器等直播源
3. 导致服务器资源持续占用，可能影响其他用户的观看体验

解决方案

修复方案

经过社区验证的有效修复方案包括三个关键修改：

1. 在JellyfinMediaSource构造函数中添加liveStreamId字段
2. 在媒体源初始化时正确传递mediaSourceInfo.liveStreamId
3. 在发送PlaybackStopInfo时包含liveStreamId参数

实现细节

核心修改点在于完善数据传递链：

1. 从媒体源信息中获取liveStreamId
2. 通过构造函数保留该标识符
3. 在播放停止时将其包含在通知消息中

技术启示

该案例展示了客户端-服务器交互中数据完整性的重要性。在设计播放控制协议时，需要注意：

1. 不同播放类型(点播vs直播)可能需要不同的停止参数
2. 服务器端依赖的标识符必须在客户端完整传递
3. 各客户端实现应保持行为一致性

后续发展

该问题已被社区成员确认并验证修复方案，相关代码修改已提交至项目主分支。这一改进将包含在未来的稳定版本中，彻底解决直播流资源释放问题。