阿里云移动端播放器高级功能---视频下载

基本介绍

优酷、爱奇艺、腾讯等主流的视频类App都有视频离线下载的功能,主要目的是在wifi下将视频离线在本地,然后在无网或者4G的情况下去观看离线视频。那么阿里云播放器也提供了视频下载的功能。这个功能主要针对的是点播视频,也就是vid播放的视频的下载。

主要问题

  1. m3u8如何下载?我们知道m3u8是一个索引文件,真正的视频文件是各个ts的分片,那么如何下载成一个完成的视频呢?
  2. 如何对视频下载进行多线程控制?在一些app中,多个视频同时下载被认为是高级VIP才有的功能。
  3. 如何实现断点续传?当在下载过程中突然中断了,那么下次再启动的时候要能够实现续传。
  4. 下载过程中sts等信息过期怎么处理?
  5. 加密的视频下载到本地如何保障安全性呢?

实现原理

下载过程

阿里云播放器支持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*)format
                             quality:(AliyunVodPlayerVideoQuality)quality;

/*
  功能:开始下载后收到回调,更新最新的MtsData。主要场景是开始多个下载时,等待下载的任务自动开始下载后,MtsData有可能已经过期了,需通过此回调更新
 参数:返回当前数据
 返回:使用代理方法,设置AliyunMtsData来更新数据。
 备注:如通过请求数据来获取mtsData,请使用同步方法。此代理方法在其他线程里,不会存在卡线程问题。
 */
- (AliyunMtsData*)onGetAliyunMtsData:(NSString *)videoID
                              format:(NSString*)format
                             quality:(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举例。
1. 通过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);

  1. prepare成功后,添加某一项到AliyunDownloadManager中,并开始下载:
  @Override
  void onPrepared(List<AliyunDownloadMediaInfo> infos) {
        //准备结束
        downloadManager.addDownloadMedia(infos.get(0));
        downloadManager.startDownloadMedia(info);
    }
  1. 接受下载回调,更新界面:
 @Override
        public void onPrepared(List<AliyunDownloadMediaInfo> infos) {
          //准备完成
        }

        @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);

具体使用示例,可参考官网demo

上一篇:阿里云移动端播放器高级功能---UI播放器


下一篇:迭代器模式