GSYVideoPlayer视频播放器三种基础使用方式详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00538/article/details/148362504

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

GSYVideoPlayer 视频播放器（IJKplayer、ExoPlayer、MediaPlayer），HTTPS，支持弹幕，外挂字幕，支持滤镜、水印、gif截图，片头广告、中间广告，多个同时播放，支持基本的拖动，声音、亮度调节，支持边播边缓存，支持视频自带rotation的旋转（90,270之类），重力旋转与手动旋转的同步支持，支持列表播放，列表全屏动画，视频加载速度，列表小窗口支持拖动，动画效果，调整比例，多分辨率切换，支持切换播放器，进度条小窗口预览，列表切换详情页面无缝播放，rtsp、concat、mpeg。项目地址: https://gitcode.com/gh_mirrors/gs/GSYVideoPlayer

前言

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

基础配置要求

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

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

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

一、直接播放模式

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

实现步骤

在布局文件中添加StandardGSYVideoPlayer控件
在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提供了两种实现模式。

模式一：直接嵌入播放器

实现要点

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

关键配置

// 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

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

实现要点

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

关键代码

// 创建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

实现步骤

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

关键方法

@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);