视频下载 SDK 功能

• 下载整视频，如 mp4/mkv/mov/3gp 等视频
• 下载 HLS，即 M3U8 视频
• M3U8 视频下载完成，会生成一个本地的 local.m3u8 文件
• 视频下载完成，可以点击播放视频文件
• 视频下载数据库记录视频下载信息
• 增加视频下载队列
• 增加 M3U8 合并为 MP4 的功能
• 可以定制下载视频的标题和封面
• 增加视频下载的 group-name

版本更新

5.8.0

• 解决下载成功回调多次的问题
• 解决 ffmpeg 中合并出现 pts 异常的问题,测试用例是:https://vod7.wenshibaowenbei.com/20210514/g79ixT00/index.m3u8

  5.7.0

• 解决合并时的 HLS 支持 hls-allowed_extensions ALL

  5.6.0

• 裁剪 ffmpeg 库，从 10M 降至 1M
• 优化 TS 合并逻辑
• 提供 armeabi-v7a arm64-v8a x86 x86_86 四种 so 库

  5.5.0

• 增加视频下载的分组名

  5.4.0

• 可以定制视频下载的封面和标题

  5.3.0

• 优化 M3U8 合并为 MP4 的过程，解决时间戳不连续导致的合并失败的问题
• 优化视频下载成功率

  4.2.0

• 优化 TS 合并逻辑

  4.1.0

• M3U8 文件下载完成后合并为 MP4 文件
• 优化部分 HTTPS 链接下载失败的问题

  3.0.0

• 解决部分 M3U8 视频下载失败的问题
• 更新 playersdk 版本
• 优化 fileName 和 filePath 问题

在 build.gradle 中引入

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

在 demo 中直接引用

dependencies {
    implementation 'com.github.JeffMony:VideoDownloader:5.8.0'
}

如果需要使用 M3U8 合并为 MP4 的功能，还需要额外引入(因为这个包有点大，如果需要就引入吧)

dependencies {
    implementation 'com.github.JeffMony:JeffFFmpegDemo:1.6.0'
}

如果想使用的合并库小一点.也可以使用较小的库,可以裁减很大的包

dependencies {
    implementation 'com.github.JeffMony:JeffM3U8Lib:1.2.0'
}

视频下载 SDK 接入

1.应用启动的时候注册 download config

File file = VideoDownloadUtils.getVideoCacheDir(this);
if (!file.exists()) {
    file.mkdir();
}
VideoDownloadConfig config = new VideoDownloadManager.Build(this)
    .setCacheRoot(file)
    .setUrlRedirect(true)
    .setTimeOut(DownloadConstants.READ_TIMEOUT, DownloadConstants.CONN_TIMEOUT)
    .setConcurrentCount(DownloadConstants.CONCURRENT)
    .setIgnoreCertErrors(true)
    .setShouldM3U8Merged(true)
    .buildConfig();
VideoDownloadManager.getInstance().initConfig(config);

2.注册 download listener 回调，这个回调只要注册一次就行了，是全局回调

VideoDownloadManager.getInstance().setGlobalDownloadListener(mListener);

private DownloadListener mListener = new DownloadListener() {

    @Override
    public void onDownloadDefault(VideoTaskItem item) {}

    @Override
    public void onDownloadPending(VideoTaskItem item) {}

    @Override
    public void onDownloadPrepare(VideoTaskItem item) {}

    @Override
    public void onDownloadStart(VideoTaskItem item) {}

    @Override
    public void onDownloadProgress(VideoTaskItem item) {}

    @Override
    public void onDownloadSpeed(VideoTaskItem item) {}

    @Override
    public void onDownloadPause(VideoTaskItem item) {}

    @Override
    public void onDownloadError(VideoTaskItem item) {}

    @Override
    public void onDownloadSuccess(VideoTaskItem item) {}
};

VideoTaskItem 中信息介绍

public class VideoTaskItem implements Cloneable {

    private String mUrl;                 //下载视频的 url
    private long mDownloadCreateTime;    //下载创建的时间
    private int mTaskState;              //当前任务的状态
    private String mMimeType;            // 视频 url 的 mime type
    private String mFinalUrl;            //30x 跳转之后的 url
    private int mErrorCode;              //当前任务下载错误码
    private int mVideoType;              //当前文件类型
    private M3U8 mM3U8;                  //M3U8 结构,如果非 M3U8,则为 null
    private int mTotalTs;                //当前 M3U8 的总分片
    private int mCurTs;                  //当前 M3U8 已缓存的分片
    private float mSpeed;                //当前下载速度, getSpeedString 函数可以将速度格式化
    private float mPercent;              //当前下载百分比, 0 ~ 100,是浮点数
    private long mDownloadSize;          //已下载大小, getDownloadSizeString 函数可以将大小格式化
    private long mTotalSize;             //文件总大小, M3U8 文件无法准确获知
    private String mFileHash;            //文件名的 md5
    private String mSaveDir;             //保存视频文件的文件目录名
    private boolean mIsCompleted;        //是否下载完成
    private boolean mIsInDatabase;       //是否存到数据库中
    private long mLastUpdateTime;        //上一次更新数据库的时间
    private String mFileName;            //文件名
    private String mFilePath;            //文件完整路径(包括文件名)
    private boolean mPaused;

}

VideoTaskState 下载状态信息介绍

public class VideoTaskState {
    public static final int DEFAULT = 0;//默认状态
    public static final int PENDING = -1;//下载排队
    public static final int PREPARE = 1;//下载准备中
    public static final int START = 2;  //开始下载
    public static final int DOWNLOADING = 3;//下载中
    public static final int PROXYREADY = 4; //视频可以边下边播
    public static final int SUCCESS = 5;//下载完成
    public static final int ERROR = 6;//下载出错
    public static final int PAUSE = 7;//下载暂停
    public static final int ENOSPC = 8;//空间不足
}

3.获取当前的下载任务

VideoDownloadManager.getInstance().fetchDownloadItems(IDownloadInfosCallback callback)

public interface IDownloadInfosCallback {
    void onDownloadInfos(List<VideoTaskItem> items);
}

接口返回的 List就是当前正在下载的任务

4.启动下载

VideoDownloadManager.getInstance().startDownload(item);

5.暂停下载

VideoDownloadManager.getInstance().pauseDownloadTask(item.getUrl());

6.恢复下载

VideoDownloadManager.getInstance().pauseDownloadTask(item.getUrl());

7.删除下载任务

VideoDownloadManager.getInstance().deleteVideoTask(String videoUrl, boolean shouldDeleteSourceFile)

8.全部暂停

VideoDownloadManager.getInstance().pauseDownloadTask(List<String> urlList)

9.M3U8 合并接口

        VideoProcessManager.getInstance().mergeTs(inputFilePath, outputFilePath, new IM3U8MergeListener() {
            @Override
            public void onMergedFinished() {
                LogUtils.i(TAG, "onMergedFinished");
                Toast.makeText(VideoMergeActivity.this, "合并成功", Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onMergeFailed(Exception e) {
                LogUtils.i(TAG, "onMergeFailed, e=" + e.getMessage());
                Toast.makeText(VideoMergeActivity.this, "合并失败", Toast.LENGTH_SHORT).show();
            }
        });

功能示意

欢迎关注我的公众号 JeffMony，我会持续为你带来音视频---算法---Android---python 方面的知识分享