Animation Garden 播放器弹幕旋转状态保持问题解析

问题背景

在 Animation Garden 项目的 Android 客户端中，用户反馈了一个关于播放器弹幕显示的问题：当用户在观看视频时旋转设备屏幕方向（从横屏切换到竖屏或反之），返回全屏模式后，原本显示的弹幕会全部消失，而不是保持旋转前的状态。

技术分析

现象本质

这个问题本质上属于 Android 应用在配置变更（如屏幕旋转）时的状态保持问题。当设备旋转时，Android 系统默认会销毁并重建 Activity，导致播放器状态丢失。

深层原因

1. DanmakuHostState 生命周期问题：弹幕宿主状态（DanmakuHostState）没有正确保存和恢复，导致配置变更后被重新初始化。

2. 播放时间同步缺失：旋转屏幕后，播放器没有重新同步当前播放时间到弹幕系统，导致弹幕无法在正确的时间点重新显示。

3. 弹幕重绘机制缺陷：现有的弹幕系统在屏幕旋转后没有重新填充（repopulate）当前播放时间点的弹幕数据。

解决方案

方案一：保存 DanmakuHostState

通过让 DanmakuHostState 在配置变更期间保持存活，可以确保弹幕系统的状态不会丢失。这可以通过以下方式实现：

1. 使用 ViewModel 来持有 DanmakuHostState
2. 在 onSaveInstanceState 中保存必要状态
3. 在 onCreate 或 onRestoreInstanceState 中恢复状态

方案二：重新同步播放时间

在屏幕旋转完成后，主动将当前播放时间重新同步到弹幕系统：

override fun onConfigurationChanged(newConfig: Configuration) {
    super.onConfigurationChanged(newConfig)
    danmakuView?.repopulate(currentPlayTimeMillis)
}

方案三：优化弹幕系统架构

从架构层面改进弹幕系统，使其能够：

1. 自动感知屏幕方向变化
2. 自适应不同屏幕尺寸和方向
3. 维护弹幕数据的持久化状态

实现建议

对于快速修复，建议采用方案二，因为它实现简单且效果立竿见影。长期来看，应该考虑方案三的架构优化，使弹幕系统更加健壮。

在具体实现时，需要注意：

1. 正确处理生命周期回调
2. 确保线程安全
3. 考虑性能影响，避免不必要的重绘
4. 保持与播放器状态的同步

总结

Animation Garden 播放器弹幕旋转消失问题是一个典型的 Android 配置变更处理案例。通过分析我们可以学到，在开发多媒体应用时，需要特别注意播放状态和UI元素的持久化问题。合理的状态保存和恢复机制不仅能解决屏幕旋转问题，还能提升应用的整体稳定性和用户体验。