GSYVideoPlayer视频播放器三种基础使用方式详解

前言

GSYVideoPlayer是一款功能强大的Android视频播放器组件，支持多种视频格式和播放模式。本文将详细介绍该播放器的三种基础使用方式，帮助开发者快速集成到项目中。

基础配置要求

在使用GSYVideoPlayer前，请确保在AndroidManifest.xml中为使用播放器的Activity配置以下属性：

<activity
    android:name=".YourActivity"
    android:configChanges="keyboard|keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize|uiMode"
    android:screenOrientation="portrait" />

这些配置可以防止Activity在屏幕旋转等情况下重建，保证视频播放的连续性。

一、直接播放模式

直接播放是最简单的使用方式，适合单个视频播放场景。

实现步骤

1. 在布局文件中添加StandardGSYVideoPlayer控件
2. 在Activity中初始化并配置播放器

关键代码示例

StandardGSYVideoPlayer player = findViewById(R.id.video_player);
player.setUp(videoUrl, true, "视频标题");

// 可选配置
player.getTitleTextView().setVisibility(View.VISIBLE);
player.getBackButton().setVisibility(View.VISIBLE);
player.setAutoFullWithSize(true); // 根据视频尺寸自动选择全屏方向

生命周期管理

@Override
protected void onPause() {
    super.onPause();
    player.onVideoPause();
}

@Override
protected void onResume() {
    super.onResume();
    player.onVideoResume();
}

@Override
protected void onDestroy() {
    super.onDestroy();
    player.release();
}

二、列表播放模式

列表播放是常见的视频展示方式，GSYVideoPlayer提供了两种实现模式。

模式一：直接嵌入播放器

实现要点

1. 在列表项布局中嵌入StandardGSYVideoPlayer
2. 在Adapter中配置每个播放器实例
3. 处理列表滚动时的播放器回收

关键配置

// Adapter中配置播放器
holder.gsyVideoPlayer.setUpLazy(url, true, null, null, "视频标题");
holder.gsyVideoPlayer.setPlayTag(TAG);  // 设置唯一标识
holder.gsyVideoPlayer.setPlayPosition(position);  // 设置位置标识
holder.gsyVideoPlayer.setAutoFullWithSize(true);  // 自动全屏

滚动监听处理

videoList.setOnScrollListener(new AbsListView.OnScrollListener() {
    @Override
    public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount) {
        // 当播放项滑出可视区域时释放播放器
        if (播放项不可见) {
            GSYVideoManager.releaseAllVideos();
            adapter.notifyDataSetChanged();
        }
    }
});

模式二：使用GSYVideoHelper

这种方式更适合需要小窗播放的场景。

实现要点

1. 列表项中只放置播放按钮和容器
2. 使用GSYVideoHelper管理播放器实例
3. 实现小窗播放和恢复逻辑

关键代码

// 创建Helper
smallVideoHelper = new GSYVideoHelper(this);
smallVideoHelper.setGsyVideoOptionBuilder(
    new GSYVideoHelper.GSYVideoHelperBuilder()
        .setHideStatusBar(true)
        .setNeedLockFull(true)
        .setCacheWithPlay(true)
);

// Adapter中绑定播放器
smallVideoHelper.addVideoPlayer(position, holder.imageView, TAG, 
    holder.videoContainer, holder.playerBtn);

三、详情页播放模式

详情页播放通常需要更复杂的交互，GSYVideoPlayer提供了两种实现方式。

模式一：继承GSYBaseActivityDetail

实现步骤

1. 继承GSYBaseActivityDetail
2. 实现必要方法
3. 配置播放器选项

关键方法

@Override
public StandardGSYVideoPlayer getGSYVideoPlayer() {
    return detailPlayer;
}

@Override
public GSYVideoOptionBuilder getGSYVideoOptionBuilder() {
    return new GSYVideoOptionBuilder()
        .setThumbImageView(coverImage)
        .setUrl(url)
        .setCacheWithPlay(true)
        .setVideoTitle("视频标题");
}

模式二：自定义实现

这种方式更灵活，适合需要高度定制的场景。

关键实现

// 初始化方向工具
orientationUtils = new OrientationUtils(this, detailPlayer);

// 配置播放器
new GSYVideoOptionBuilder()
    .setThumbImageView(imageView)
    .setUrl(url)
    .setVideoAllCallBack(new GSYSampleCallBack() {
        @Override
        public void onPrepared(String url, Object... objects) {
            // 准备完成后启用方向旋转
            orientationUtils.setEnable(true);
        }
    })
    .build(detailPlayer);

// 全屏按钮点击事件
detailPlayer.getFullscreenButton().setOnClickListener(v -> {
    orientationUtils.resolveByClick();
    detailPlayer.startWindowFullscreen(this, true, true);
});

高级配置选项

切换播放内核

// 切换为ExoPlayer内核
PlayerFactory.setPlayManager(Exo2PlayerManager.class);

// 切换为系统播放器内核
PlayerFactory.setPlayManager(SystemPlayerManager.class);

视频比例设置

// 16:9比例
GSYVideoType.setShowType(GSYVideoType.SCREEN_TYPE_16_9);

// 全屏裁剪
GSYVideoType.setShowType(GSYVideoType.SCREEN_TYPE_FULL);

渲染方式选择

// 使用TextureView(默认)
GSYVideoType.setRenderType(GSYVideoType.TEXTURE);

// 使用SurfaceView
GSYVideoType.setRenderType(GSYVideoType.SUFRACE);

// 使用GLSurfaceView(支持滤镜)
GSYVideoType.setRenderType(GSYVideoType.GLSURFACE);

结语

本文详细介绍了GSYVideoPlayer的三种基础使用方式，开发者可以根据实际需求选择合适的实现方案。该播放器组件功能强大且高度可定制，能够满足大多数视频播放场景的需求。对于更高级的自定义需求，可以参考项目的详细架构文档进行深度定制。