GSYVideoPlayer自定义播放器横屏状态管理实践

概述

在使用GSYVideoPlayer进行自定义播放器开发时，开发者经常会遇到需要在横竖屏切换时保持UI状态的需求。本文将以一个实际案例为基础，详细介绍如何在继承StandardGSYVideoPlayer的自定义播放器中实现横屏状态下的UI控制。

问题背景

在开发一个直播类应用时，开发者创建了一个继承自StandardGSYVideoPlayer的自定义播放器MatchVideoPlayer。该播放器添加了一个ImageView控件，需要根据接口返回的布尔值在横屏状态下显示或隐藏这个控件。然而，直接调用broadcasting方法修改控件状态时，发现横屏状态下UI没有响应预期变化。

核心问题分析

这个问题本质上涉及两个关键点：

1. 播放器实例管理：GSYVideoPlayer在横竖屏切换时会创建新的播放器实例
2. 状态传递机制：自定义状态需要在实例间正确传递

解决方案

1. 理解播放器实例生命周期

当播放器进入全屏模式时，GSYVideoPlayer会通过startWindowFullscreen方法创建一个新的全屏播放器实例。这意味着：

• 横屏状态下的播放器是一个全新的实例
• 原播放器的UI状态不会自动传递到新实例

2. 实现cloneParams方法

StandardGSYVideoPlayer提供了cloneParams方法，专门用于在创建新实例时复制必要参数。我们需要重写这个方法：

@Override
public void cloneParams(StandardGSYVideoPlayer from, StandardGSYVideoPlayer to) {
    super.cloneParams(from, to);
    if (to instanceof MatchVideoPlayer && from instanceof MatchVideoPlayer) {
        MatchVideoPlayer mTo = (MatchVideoPlayer) to;
        MatchVideoPlayer mFrom = (MatchVideoPlayer) from;
        // 传递自定义状态
        mTo.isBroadcasting = mFrom.isBroadcasting;
        mTo.isFullscreen = mFrom.isFullscreen;
    }
}

3. 正确处理全屏状态

在broadcasting方法中，我们需要考虑当前播放器实例的状态：

fun broadcasting(show: Boolean, enter: Boolean) {
    isBroadcasting = show
    isFullscreen = enter
    
    // 获取当前实际有效的播放器实例
    val currentPlayer = getCurrentPlayer() as? MatchVideoPlayer
    
    currentPlayer?.let {
        if (it.isBroadcasting) {
            it.lltNoLiveNew?.visibility = GONE
        } else {
            it.lltNoLiveNew?.visibility = VISIBLE
        }
    }
}

4. 完整实现方案

结合上述要点，完整的解决方案如下：

1. 在自定义播放器中定义需要保持的状态变量
2. 重写cloneParams方法确保状态传递
3. 通过getCurrentPlayer获取当前有效实例
4. 在UI更新时操作正确的实例

最佳实践建议

1. 状态集中管理：将所有需要在横竖屏间保持的状态集中定义
2. 实例检查：在修改UI前始终检查当前实例有效性
3. 生命周期考虑：注意横竖屏切换时的实例创建和销毁
4. 状态同步：确保cloneParams中复制所有必要状态

总结

通过正确理解GSYVideoPlayer的实例管理机制，并合理使用cloneParams和getCurrentPlayer方法，开发者可以轻松实现自定义播放器在横竖屏切换时的状态保持。这种方法不仅适用于简单的布尔状态，也可以扩展到更复杂的自定义UI状态管理场景。

在实际开发中，建议开发者仔细阅读GSYVideoPlayer的源码，特别是StandardGSYVideoPlayer类中关于全屏管理的实现，这将有助于更好地理解和扩展播放器功能。