Jellyfin-Android应用清除通知导致播放停止问题分析

问题现象

Jellyfin-Android应用在用户尝试清除所有系统通知时，会出现视频播放意外停止的问题。这个问题主要发生在使用集成播放器(ExoPlayer)的情况下，当用户从通知栏执行"清除所有通知"操作时，应用会错误地终止正在进行的视频播放。

技术背景

在Android系统中，媒体播放应用通常会创建一个持久性通知来显示当前播放内容并提供控制功能。Jellyfin-Android应用实现了这一标准行为，通过PlayerNotificationHelper类管理播放通知。该通知包含播放控制按钮(如播放/暂停、停止等)，并通过广播接收器响应这些操作。

问题根源分析

经过代码审查，发现问题出在通知处理逻辑上：

1. 当用户清除所有通知时，系统会发送一个ACTION_STOP广播
2. 应用当前的实现无条件地响应这个广播，调用viewModel.stop()方法
3. 这导致无论当前播放状态如何，应用都会停止播放
4. 特别值得注意的是，这个问题只影响视频播放，因为音乐播放器有专门的"可关闭通知"选项控制这一行为

解决方案探讨

针对这个问题，可以考虑以下几种技术方案：

1. 禁止视频播放通知被清除：最直接的解决方案是修改通知属性，在视频播放期间将通知设置为不可清除(PERSISTENT)。这样"清除所有通知"操作就不会影响到播放通知。

2. 区分清除来源：更精细的控制是检测ACTION_STOP广播的来源，区分是用户主动点击停止按钮还是系统清除操作。但这需要更复杂的广播处理逻辑。

3. 统一通知行为：可以考虑让视频播放通知也支持"可关闭通知"选项，与音乐播放器保持一致，给用户更多控制权。

实现建议

基于Android最佳实践和用户体验考虑，推荐采用第一种方案，原因如下：

• 实现简单可靠，只需修改通知构建时的标志
• 符合用户预期，视频播放通知通常需要持续显示
• 避免意外操作导致播放中断
• 与大多数主流媒体播放应用行为一致

具体实现需要在构建通知时添加FLAG_NO_CLEAR标志，示例代码修改如下：

val notification = NotificationCompat.Builder(context, channelId)
    .setContentTitle(title)
    .setContentText(artist)
    .setSmallIcon(R.drawable.ic_notification)
    .setLargeIcon(bitmap)
    .setStyle(style)
    .setPriority(NotificationCompat.PRIORITY_HIGH)
    .setVisibility(NotificationCompat.VISIBILITY_PUBLIC)
    .setDeleteIntent(createPendingIntent(Constants.ACTION_STOP))
    .setContentIntent(contentIntent)
    .setOngoing(true)  // 添加这一行使通知持久化
    .addAction(action)
    .build()

兼容性考虑

在实现这一修复时，需要考虑不同Android版本的兼容性：

1. Android 8.0及以上版本要求创建通知渠道，持久性通知需要设置适当的重要性级别
2. 需要确保通知仍然可以被用户通过应用内操作关闭
3. 在应用进入后台时，通知应保持可见但可管理

用户体验优化

除了修复问题外，还可以考虑以下用户体验改进：

1. 添加明确的播放状态指示
2. 优化通知布局，显示更多播放信息
3. 支持更多播放控制操作
4. 提供通知行为的用户设置选项

总结

Jellyfin-Android应用在通知处理逻辑上存在一个边界条件问题，导致清除系统通知时意外停止播放。通过将视频播放通知设置为不可清除，可以简单有效地解决这个问题，同时保持应用行为的合理性和一致性。这一改进将提升应用的稳定性和用户体验，避免意外操作中断播放。