GSYVideoPlayer 常见问题解决方案大全

钱溪双Bridget

于 2025-06-01 09:15:06 发布

阅读量248

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00591/article/details/148362500

GSYVideoPlayer 常见问题解决方案大全

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

前言

GSYVideoPlayer 是一款基于 IjkPlayer 封装的 Android 视频播放器组件，功能强大但使用过程中可能会遇到各种问题。本文整理了开发者在使用 GSYVideoPlayer 时常见的 28 类问题及其解决方案，帮助开发者快速定位和解决问题。

基础配置问题

1. 项目依赖失败

问题描述：项目导入不成功或依赖下载缓慢。

解决方案：

确保项目根目录的 build.gradle 文件顶部有 apply from: 'dependencies.gradle' 语句
由于 so 文件较大，建议在网络条件良好时下载依赖
检查 gradle 版本是否兼容

2. ClassNotFoundException 和混淆问题

问题描述：运行时出现类找不到异常或混淆后功能异常。

解决方案：

确保 MultiDex 配置正确（如需）
添加以下混淆规则：

-keep class tv.danmaku.ijk.** { *; }
-dontwarn tv.danmaku.ijk.**
-keep class com.shuyu.gsyvideoplayer.** { *; }
-dontwarn com.shuyu.gsyvideoplayer.**

3. SO 库相关问题

问题描述：找不到对应的 so 文件或链接 so 错误。

解决方案：

配置 ndk abiFilters：

android {
    defaultConfig {
        ndk {
            abiFilters 'armeabi', 'armeabi-v7a', 'x86'
        }
    }
}

确保 jniLibs 路径配置正确：

sourceSets {
    main {
        jniLibs.srcDirs = ['libs']
    }
}

使用 Analyze Apk 工具检查 so 文件是否被打包

播放功能问题

4. 视频格式支持问题

问题描述：某些格式（如 3gp、mepg）无法播放。

解决方案：

普通模式不支持 3gp 或 mepg 格式
对于 mepg 格式，可使用 ex-so 依赖
测试视频是否可播放，建议使用系统录制或其他专业录制工具

5. M3U8/HLS 格式问题

问题描述：M3U8/HLS 格式视频播放异常。

解决方案：

缓存不支持 M3U8/HLS 格式
播放时需要设置 cacheWithPlay 为 false：

setUp(String url, boolean cacheWithPlay, ...)

6. 视频拖动回弹问题

问题描述：拖动进度条后视频会弹回原位置。

解决方案：这是 IjkPlayer 的 FFMPEG 对关键帧的处理问题，可尝试以下设置：

VideoOptionModel videoOptionModel = new VideoOptionModel(
    IjkMediaPlayer.OPT_CATEGORY_PLAYER, 
    "enable-accurate-seek", 
    1
);
List<VideoOptionModel> list = new ArrayList<>();
list.add(videoOptionModel);
GSYVideoManager.instance().setOptionModelList(list);

7. 视频旋转问题

问题描述：视频旋转后重新开始播放。

解决方案：在 AndroidManifest.xml 中配置 Activity：

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

网络与缓存问题

8. 弱网络加载问题

问题描述：网络环境差时加载缓慢。

解决方案：

关闭缓存播放：cacheWithPlay 设为 false
调整缓冲区大小：

VideoOptionModel videoOptionModel = new VideoOptionModel(
    IjkMediaPlayer.OPT_CATEGORY_PLAYER, 
    "max-buffer-size", 
    0
);

9. Cookie 设置

解决方案：在 setUp 时设置带有 Map<String, String> mapHeadData 参数的方法：

setUp(String url, boolean cacheWithPlay, Map<String, String> mapHeadData, ...)

10. URL 切换 400/404 错误

问题描述：HTTP 与 HTTPS 域名共用时出现错误。

解决方案：

VideoOptionModel videoOptionModel = new VideoOptionModel(
    IjkMediaPlayer.OPT_CATEGORY_FORMAT, 
    "dns_cache_clear", 
    1
);
List<VideoOptionModel> list = new ArrayList<>();
list.add(videoOptionModel);
VideoOptionModel videoOptionModel2 = new VideoOptionModel(
    IjkMediaPlayer.OPT_CATEGORY_FORMAT, 
    "dns_cache_timeout", 
    -1
);
list.add(videoOptionModel2);
GSYVideoManager.instance().setOptionModelList(list);

音视频同步问题

11. 有画面没声音/有声音没画面

解决方案：

检查 so 库是否包含支持的编解码格式
尝试开启硬件加速：

<application android:hardwareAccelerated="true">

12. 音画不同步问题

解决方案：

检查是否关闭了硬解码
确认 Activity 的 config 配置正确
尝试降低帧率：

VideoOptionModel videoOptionModel = new VideoOptionModel(
    IjkMediaPlayer.OPT_CATEGORY_PLAYER, 
    "framedrop", 
    50
);

高级配置

13. RTSP 播放优化

List<VideoOptionModel> list = new ArrayList<>();
list.add(new VideoOptionModel(
    IjkMediaPlayer.OPT_CATEGORY_FORMAT, 
    "rtsp_transport", 
    "tcp"
));
list.add(new VideoOptionModel(
    IjkMediaPlayer.OPT_CATEGORY_FORMAT, 
    "rtsp_flags", 
    "prefer_tcp"
));
// 更多优化参数...
GSYVideoManager.instance().setOptionModelList(list);

14. 精准时间开始播放

VideoOptionModel videoOptionModel = new VideoOptionModel(
    IjkMediaPlayer.OPT_CATEGORY_PLAYER, 
    "seek-at-start", 
    startPosition
);

15. 重连次数设置

VideoOptionModel videoOptionModel = new VideoOptionModel(
    IjkMediaPlayer.OPT_CATEGORY_PLAYER,
    "reconnect",
    5
);

其他实用技巧

16. 全屏与非全屏同步

重写以下方法实现自定义操作：

@Override
public GSYBaseVideoPlayer startWindowFullscreen(Context context, boolean actionBar, boolean statusBar) {
    // 全屏处理逻辑
}

@Override
protected void resolveNormalVideoShow(View oldF, ViewGroup vp, GSYVideoPlayer gsyVideoPlayer) {
    // 退出全屏处理逻辑
}