# VideoDownloader
**Repository Path**: jeffmony/VideoDownloader
## Basic Information
- **Project Name**: VideoDownloader
- **Description**: 专注视频下载，hls/mp4等等视频文件下载；
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 6
- **Forks**: 1
- **Created**: 2020-03-25
- **Last Updated**: 2024-10-26
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# VideoDownloader
#### 视频下载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 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 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 方面的知识分享
