wedox/m3u8downloader

m3u8视频文件下载器(生成支持本地播放的m3u8文件）

M3U8Downloader

m3u8视频文件下载器（生成支持供本地播放的m3u8文件）

How to use?

Step 0.Add it in your root build.gradle at the end of repositories:

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

Step 1. Add the dependency

dependencies {
	        implementation 'com.github.WeDox:M3U8Downloader:2.0.4'
	}

Step 2.to use

//需要网络权限，该框架存储的现有实现不需要申请存储权限，自定义文件存储的自行添加申请
<uses-permission android:name="android.permission.INTERNET" />

    private void startDownloadM3U8() {
        DDownloadQueue downloadQueue = new JDDownloadQueue();
        downloadQueue.setMovie_id(10);//电影或电视剧ID
        downloadQueue.setMovie_download_url("https://bitdash-a.akamaihd.net/content/sintel/hls/playlist.m3u8");//下载地址
        downloadQueue.setSingleRate(false);//movie_download_url是否是单码率下载地址 true-单码率 false-多码率
        downloadQueue.setMovie_title("测试视频");//电影名或电视剧名
        downloadQueue.setMovie_num_index(0);//集数id
        downloadQueue.setMovie_num_title("完整版");//集数名
        downloadQueue.setState(JDDownloadQueueState.STATE_DOWNLOAD_QUEUE);//这个比较重要

        String PATH_MOVIE = JDM3U8FileCacheUtils.createRootDownloadPath(MainActivity.this) + File.separator + "download" + File.separator + "movie" + File.separator;
        //
        JDM3U8Downloader jdm3U8Downloader = new JDM3U8Downloader.Builder()
                .setSaveDir(PATH_MOVIE)
                .setDownloadQueue(downloadQueue)
                .setFileDownloaderFactory(JDM3U8FileOriginalDownloaderFactory.create())
                .setDownloaderListener(new JDM3U8DownloaderContract.JDM3U8DownloadListener() {

                    @Override
                    public void downloadState(JDDownloadQueue downloadQueue, int downloadState, String msg) {
                        String logMsg = downloadQueue + "\n下载状态码" + downloadState + "\n【解释】==" + JDDownloadQueueState.getSateStr(downloadState) + "\n携带的消息：" + msg;
                        if (downloadState != JDDownloadQueueState.STATE_DOWNLOAD_FINISH) {
                            //showText(logMsg);
                        }
                        JDM3U8LogHelper.printLog(logMsg);
                    }

                    @Override
                    public void downloadProgress(JDDownloadQueue downloadQueue, long sofar, long total) {
                        String logMsg = downloadQueue + "\n进度" + sofar + "\n总共" + total;
                        //showText(logMsg);
                        JDM3U8LogHelper.printLog(logMsg);
                    }

                    @Override
                    public void downloadSuccess(JDDownloadQueue downloadQueue) {
                        JDM3U8LogHelper.printLog("下载成功事件：" + downloadQueue.getMovie_title());
                    }

                    @Override
                    public void downloadError(JDDownloadQueue downloadQueue, String errMsg) {
                        JDM3U8LogHelper.printLog(errMsg);
                    }

                    @Override
                    public void downloadPause(JDDownloadQueue downloadQueue) {
                        JDM3U8LogHelper.printLog("暂停下载" + downloadQueue.getMovie_title());
                    }
                })
                .build();
        jdm3U8Downloader.startDownload();
    }

Step 3. Custom your somethings

(1) Custom your file downloader(自定义文件下载器)

参考工程中的okhttp_file_downloader目录下的Okhttp文件下载器

(2) Custom your model converter(自定义Bean转换器:从多码率m3u8文件中取出单码率文件网址、从单码率m3u8文件取出ts文件网址）

 JDM3U8Downloader jdm3U8Downloader = new JDM3U8Downloader.Builder()
 .setModelConverter(JDM3U8ModelConverter modelConverter)
 ....
 .build();

具体实现请参考默认的JDM3U8ModelConverterImp.java实现类

(3)：Custom your FileLocalStorageManager(自定义本地文件存储管理器）

 JDM3U8Downloader jdm3U8Downloader = new JDM3U8Downloader.Builder()
 .setFileLocalStorageManager(JDM3U8FileLocalStorageManager fileLocalStorageManager)
 ....
 .build();

具体实现请参考默认的JDM3U8FileLocalStorageManagerImp.java实现类

下载流程，可归纳为以下六个步骤：

0、网络请求获取到m3u8多码率的文件内容
1、处理转换【m3u8多码率的文件内容】得到单码率的下载地址(JDM3U8SingleRateUrlBean)
2、网络请求获取到m3u8单码率的文件内容
3、处理转换【m3u8单码率的文件内容】得到ts列表的下载地址
4、下载各个ts文件
5、保存一份供本地播放的单码率m3u8文件

（注意）从多码率文件中取出第一个指定码率的m3u8下载地址

http://yi.jingdianzuida.com/20190905/yM4FKbnk/index.m3u8

#EXTM3U
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=1000000,RESOLUTION=1080x608
/ppvod/30BF460930E1ABAB6E46E4AF20BF4AF4.m3u8

JDM3U8BaseDownloader中默认取多码率文件内容中的第三行 （自己可重写public JDM3U8SingleRateUrlBean getM3U8SingleRateUrlBean(String m3u8MultiRateFileDownloadUrl, List dataList)方法）

JDM3U8Downloader中默认取多码率文件内容中的第一行（不以#开头，并且以.m3u8开头的行数） 可以通过以下代码，自定义JDM3U8ModelConverter，实现covertToM3U8SingleRateUrlBean方式即可

 JDM3U8Downloader jdm3U8Downloader = new JDM3U8Downloader.Builder()
 .setModelConverter(JDM3U8ModelConverter modelConverter)
 ....
 .build();

多码率中第三行内容（即单码率的m3u8的路径）
多码率中该行内容（即单码率的m3u8的路径）
如果是以/开头的话，使用多码率的下载地址url主机加该内容；（即http://yi.jingdianzuida.com拼接上/ppvod/30BF460930E1ABAB6E46E4AF20BF4AF4.m3u8） 所以该http://yi.jingdianzuida.com/ppvod/30BF460930E1ABAB6E46E4AF20BF4AF4.m3u8

如果不是以/开头的话，截取多码率的url到最后一个/杠，再加多码率中第三行内容

从指定码率文件取出每个ts文件下载地址也是同样的规则：
// 在单码率m3u8文件ts列表的ts文件下载地址
// 如果是以/开头的话，使用单码率的下载地址url主机加该下载地址
// 如果不是以/开头的话，截取单码率的url到最后一个/杠,再加该下载地址

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:9
#EXT-X-MEDIA-SEQUENCE:0
#EXTINF:4.17,
/20190905/yM4FKbnk/1000kb/hls/RYHJh4414000.ts

（注意）由于我这里的存储方式是：

将这些ts文件存放在单码率文件同一级别目录下
比如视频的id为1，第2集，那ts文件存储位置就为MOVIE_DIR/1/2/RYHJh4414000.ts,
m3u8文件存储位置为MOVIE_DIR/1/2/2.m3u8,
此时如果把所有ts文件下载成功直接使用MOVIE_DIR/1/2/2.m3u8这个路径去播放，是不可播放的，
因为在2.m3u8文件的内容中ts文件的路径为/20190905/yM4FKbnk/1000kb/hls/RYHJh4414000.ts。
而本地的ts文件是跟2.m3u8为同目录的，所以索引不到文件，故不可播放

我现在在代码中实现的解决方式：copy一份2.m3u8命名为2_local.m3u8，然后将/20190905/yM4FKbnk/1000kb/hls/前缀替换为空字符，只剩RYHJh4414000.ts
这样就能索引到ts文件，使用2_local.m3u8这个路径去播放就能达到正常播放的效果。

m3u8downloader's Issues

建议做一个完整的下载功能列表

方便直接集成到项目么

这个库可以实现边下边播的功能吗

OkHttpFileDownloaderFactory

OkHttpFileDownloaderFactory是个什么类呀