基本介绍
优酷、爱奇艺、腾讯等主流的视频类App都有视频离线下载的功能，主要目的是在wifi下将视频离线在本地，然后在无网或者4G的情况下去观看离线视频。那么阿里云播放器也提供了视频下载的功能。这个功能主要针对的是点播视频，也就是vid播放的视频的下载。主要问题
m3u8如何下载？我们知道m3u8是一个索引文件，真正的视频文件是各个ts的分片，那么如何下载成一个完成的视频呢？如何对视频下载进行多线程控制？在一些app中，多个视频同时下载被认为是高级VIP才有的功能。如何实现断点续传？当在下载过程中突然中断了，那么下次再启动的时候要能够实现续传。下载过程中sts等信息过期怎么处理？加密的视频下载到本地如何保障安全性呢？实现原理下载过程阿里云播放器支持mp4文件和m3u8视频文件两种格式下载。其下载过程基本一致。流程图如下：
从上述流程图中可以看到，m3u8文件的下载我们会mux成一个mp4文件，首先将各个ts文件分别下载，最后的过程中再进行mux。 多线程控制
/* 功能：设置同时下载的数量，最大4个 参数：count:同时下载的个数 */-(void)setMaxDownloadOperationCount:(int)count;通过上述的接口，可以设置并行下载的个数。当添加到队列中的数量多于这个设定的个数后，会在队列中进行等待，当之前的下载完成后会自动进行下一个视频的下载。
异常中断
经常有的情况是：不小心将app杀掉了，或者手机没电关机了等其他中断的因素。这个时候下次下载的时候要能够恢复之前的现场。我们提供了一个回调来通知app：/*
功能：未完成回调，异常中断导致下载未完成，下次启动后会接收到此回调。 回调数据：AliyunDownloadMediaInfo数组 */-(void) onUnFinished:(NSArray<AliyunDataSource>)mediaInfos;过期处理
通过vid的方式进行下载，同样支持vid+playAuth,vid+sts,vid+mps的方式进行播放，将这些信息添加到队列中，如果之前一个视频下载时间较长，那么后面排队的视频的输入信息可能会过期。针对这种情况，我们增加了过期的回调来重新输入信息：/*
功能：开始下载后收到回调，更新最新的playAuth。主要场景是开始多个下载时，等待下载的任务自动开始下载后，playAuth有可能已经过期了，需通过此回调更新 参数：返回当前数据 返回：使用代理方法，设置playauth来更新数据。 备注：如通过请求数据来获取playAuth，请使用同步方法。此代理方法在其他线程里，不会存在卡线程问题。 */-(NSString)onGetPlayAuth:(NSString)vid format:(NSString*)format quality:(AliyunVodPlayerVideoQuality)quality;/*
功能：开始下载后收到回调，更新最新的stsData。主要场景是开始多个下载时，等待下载的任务自动开始下载后，stsData有可能已经过期了，需通过此回调更新 参数：返回当前数据 返回：使用代理方法，设置AliyunStsData来更新数据。 备注：如通过请求数据来获取stsData，请使用同步方法。此代理方法在其他线程里，不会存在卡线程问题。 */- (AliyunStsData)onGetAliyunStsData:(NSString )videoID format:(NSString*)formatquality:(AliyunVodPlayerVideoQuality)quality;
/*
功能：开始下载后收到回调，更新最新的MtsData。主要场景是开始多个下载时，等待下载的任务自动开始下载后，MtsData有可能已经过期了，需通过此回调更新 参数：返回当前数据 返回：使用代理方法，设置AliyunMtsData来更新数据。 备注：如通过请求数据来获取mtsData，请使用同步方法。此代理方法在其他线程里，不会存在卡线程问题。 */- (AliyunMtsData)onGetAliyunMtsData:(NSString )videoID format:(NSString*)formatquality:(NSString *)quality;
加密下载
加密下载到本地，如何保证安全呢？有几个问题就是下载后我们需要重新加密，防止密钥泄露。同时另外一个就是要防止视频被拷贝到其他app中进行播放。比如存在下面的场景。
所以我们通过将用户密钥和用户app绑定的方式来保证安全性。那么如何来做呢？ 控制台配置
如果希望实现加密下载，需要在阿里云控制台配置下载选项为安全下载。同时，填写校验及加密相关信息。截图如下：
填写完成之后，控制台将会生成一个dat校验文件。这个校验文件需要配置到阿里云下载模块中，供校验使用。 使用dat文件
有了dat文件后，我们将文件设置到播放器中，通过如下接口：/*
功能：设置加密文件 参数：encrptyFile为加密文件路径 */-(void)setEncrptyFile:(NSString*)encrptyFile;下载功能示例
以Android为例，Android 提供了AliyunDownloadManager这个单例类实现下载功能。配置AliyunDownloadConfig
下载之前，需要配置AliyunDownloadConfig。AliyunDownloadConfig中需要配置如下几个参数：setMaxNums： 设置最大同时下载的个数。
setDownloadDir： 设置下载的文件保存的位置。setSecretImagePath： 设置校验文件的路径。 其中：setSecretImagePath只需要在加密下载的时候设置。其余两个参数均需要设置。获取视频信息并下载阿里云播放器支持 STS ，AUTH，MPS 等多种方式下载。以STS举例。- 通过sts信息，调用prepare接口，获取可以下载的视频项：
//1.设置下载监听
downloadManager = AliyunDownloadManager.getInstance(getContext()); downloadInfoListener = new MyDownloadInfoListener(this); downloadManager.addDownloadInfoListener(downloadInfoListener); //2.使用vidsts准备下载资源。 AliyunVidSts adb = new AliyunVidSts();adb.setVid(mVid); adb.setAcId(akid); adb.setAkSceret(akSecret); adb.setSecurityToken(token); downloadManager.prepareDownloadMedia(adb);
prepare成功后，添加某一项到AliyunDownloadManager中，并开始下载：
@Override void onPrepared(List<AliyunDownloadMediaInfo> infos) {//准备结束 downloadManager.addDownloadMedia(infos.get(0)); downloadManager.startDownloadMedia(info);}
接受下载回调，更新界面：
@Overridepublic void onPrepared(Listinfos) { //准备完成 } @Override public void onStart(AliyunDownloadMediaInfo info) { //下载开始 } @Override public void onProgress(AliyunDownloadMediaInfo info, int percent) { //下载进度 } @Override public void onStop(AliyunDownloadMediaInfo info) { //下载停止 } @Override public void onCompletion(AliyunDownloadMediaInfo info) { DemoDownloadActivity downloadActivity = weakActivity.get(); if (downloadActivity != null) { downloadActivity.onCompletion(info); } } @Override public void onError(AliyunDownloadMediaInfo info, int code, String msg, String reuqestId) { //下载出错 } @Override public void onWait(AliyunDownloadMediaInfo outMediaInfo) { //等待下载 }
移除下载项
AliyunDownloadManager提供了移除接口，用来从下载管理中移除下载。移除之后，下载的文件将也会被删除。downloadManager.removeDownloadMedia(info);