进阶功能

播放

短视频列表播放

针对典型的短视频列表播放场景，iOS播放器SDK提供了完善的列表播放功能，结合预加载等机制大幅改善短视频的起播速度。长视频场景不建议使用该功能。

/**
 @brief Alpha渲染模式，支持alpha在右侧、左侧、上侧、下侧，默认值无
 @see AVPAlphaRenderMode
 */
/****
 @brief Set a rendering mode. Support alpha at right, left, top and bottom. Default value is none.
 @see AVPAlphaRenderMode
 */
@property(nonatomic) AVPAlphaRenderMode alphaRenderMode;

//--------------View用法-------------
//对于View 需要设置clearColor
@property (weak, nonatomic) IBOutlet UIView *mediaPlayerView;
[self.aliplayerview setBackgroundColor:UIColor.clearColor];

//-----------AliPlayer用法-----------
//设置alpha模式
[self.aliplayer setAlphaRenderMode:AVP_RENDERMODE_ALPHA_AT_LEFT];
//设置alpha模式对应的素材
AVPUrlSource *source = [[AVPUrlSource alloc] urlWithString:@"https://alivc-player.oss-cn-shanghai.aliyuncs.com/video/%E4%B8%9A%E5%8A%A1%E9%9C%80%E6%B1%82%E6%A0%B7%E6%9C%AC/alpha%E9%80%9A%E9%81%93/alpha_left.mp4"];
[self.aliplayer setUrlSource:source];

//可选：单实例播放完成后如果有衔接问题，可以清屏
#pragma mark -- AVPDelegate
- (void)onPlayerEvent:(AliPlayer *)player eventType:(AVPEventType)eventType {
    switch (eventType) {
        case AVPEventCompletion:
        {
            [player clearScreen];
        }
            break;
        //...
    }
}

[self.aliplayer setAutoPlay: YES];
[self.aliplayer prepare];

Metal渲染

/**
 @brief 视频渲染类型，0 表示默认渲染器；1 表示混合渲染器。默认值0
 */
/****
 @brief video renderType, 0 means default render; 1 means mixed render.
 */
@property(nonatomic, assign) int videoRenderType;

AVPConfig *config = [self.player getConfig];
//使用metal渲染方式
config.videoRenderType = 1;
[self.player setConfig:config];
[self.player prepare];

外挂字幕

iOS播放器SDK支持添加和切换外挂字幕，现已支持SRT、SSA、ASS、VTT这4种格式的字幕。示例如下：

1. 创建显示字幕的View。

   根据不同的字幕格式创建不同的View。

   // 初始化自定义subTitleLabel
   UILabel *subTitleLabel = [[UILabel alloc] initWithFrame:frame];
   // 将字幕添加至自定义的superView，superView是用户自定义的界面存在的父视图
   [superView addSubview:subTitleLabel];

2. 设置字幕相关监听。

   展开查看代码

   //外挂字幕被添加
   - (void)onSubtitleExtAdded:(AliPlayer*)player trackIndex:(int)trackIndex URL:(NSString *)URL {}
   //字幕头信息回调
   - (void)onSubtitleHeader:(AliPlayer *)player trackIndex:(int)trackIndex Header:(NSString *)header{}
   //字幕显示回调
   - (void)onSubtitleShow:(AliPlayer*)player trackIndex:(int)trackIndex subtitleID:(long)subtitleID subtitle:(NSString *)subtitle {
    subTitleLabel.text =subtitle;
    subTitleLabel.tag =subtitleID;
   }
   //字幕隐藏回调
   - (void)onSubtitleHide:(AliPlayer*)player trackIndex:(int)trackIndex subtitleID:(long)subtitleID{
    [subTitleLabel removeFromSuperview];
   }

3. 添加字幕。

   [self.player addExtSubtitle:URL];

4. 切换字幕。

   [self.player selectExtSubtitle:trackIndexenable:YES];

纯音频播放

AVPConfig *config = [self.player getConfig];
config.disableVideo = YES;
[self.player setConfig:config];

软硬解切换

//开启硬解，默认开启
self.player.enableHardwareDecoder = YES;

-(void)onPlayerEvent:(AliPlayer*)player eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
 if (eventWithString == EVENT_SWITCH_TO_SOFTWARE_DECODER) {
 //切换到软解
 }
}

网络自适应切换视频清晰度

AVPMediaInfo *info = [self.player getMediaInfo];
NSArray<AVPTrackInfo*>* tracks = info.tracks;

//多码率切换
[self.player selectTrack:track.trackIndex];
//多码率切换并自适应
[self.player selectTrack:SELECT_AVPTRACK_TYPE_VIDEO_AUTO];

- (void)onTrackChanged:(AliPlayer*)player info:(AVPTrackInfo*)info {
 if (info.trackType == AVPTRACK_TYPE_VIDEO) {
 // video changed
 }
 // etc
}

截图

//截图回调
- (void)onCaptureScreen:(AliPlayer *)player image:(UIImage *)image {
 // 处理截图
}
//截取当前播放的画面
aliyunVodPlayer.snapshot();

试看

iOS播放器SDK通过配合点播服务配置，可以实现试看功能，支持VidSts和VidAuth（视频点播推荐使用此方式）两种播放方式。如何配置和使用试看功能，请参见试看视频。

AVPVidStsSource *source = [[AVPVidStsSource alloc] init];
....
VidPlayerConfigGenerator* vp = [[VidPlayerConfigGenerator alloc] init];
[vp setPreviewTime:20];//20秒试看
source.playConfig = [vp generatePlayerConfig];//设置给播放源
...

设置Referer

//先获取配置
AVPConfig *config = [self.player getConfig];
//设置referer
config.referer = referer;
....//其他设置
//设置配置给播放器
[self.player setConfig:config];

设置UserAgent

//先获取配置
AVPConfig *config = [self.player getConfig];
//设置userAgent
config.userAgent = userAgent;
....//其他设置
//设置配置给播放器
[self.player setConfig:config];

配置网络重试时间和次数

//先获取配置
AVPConfig *config = [self.player getConfig];
//设置网络超时时间，单位ms
config.networkTimeout = 5000;
//设置超时重试次数。每次重试间隔为networkTimeout。networkRetryCount=0则表示不重试，重试策略app决定，默认值为2
config.networkRetryCount = 2;
....//其他设置
//设置配置给播放器
[self.player setConfig:config];

配置缓存和延迟控制

//先获取配置
AVPConfig *config = [self.player getConfig];
//最大延迟。注意：直播有效。当延时比较大时，播放器SDK内部会追帧等，保证播放器的延时在这个范围内。
config.maxDelayTime = 5000;
// 最大缓冲区时长。单位ms。播放器每次最多加载这么长时间的缓冲数据。
config.maxBufferDuration = 50000;
//高缓冲时长。单位ms。当网络不好导致加载数据时，如果加载的缓冲时长到达这个值，结束加载状态。
config.highBufferDuration = 3000;
// 起播缓冲区时长。单位ms。这个时间设置越短，起播越快。也可能会导致播放之后很快就会进入加载状态。
config.startBufferDuration = 500;
//其他设置
//设置配置给播放器
[self.player setConfig:config];

设置HTTP Header

通过AVPConfig方法，可以给播放器中的请求加上HTTP的header参数。示例如下：

//先获取配置
AVPConfig *config = [self.player getConfig];
//定义header
NSMutableArray *httpHeaders = [[NSMutableArray alloc] init];
//比如使用httpdns时，需要设置Host。
[httpHeaders addObject:@"Host:example.com"];
//设置header
config.httpHeaders = httpHeaders;
....//其他设置
//设置配置给播放器
[self.player setConfig:config];

画中画

开启画中画

- (void)onPlayerEvent:(AliPlayer *)player eventType:(AVPEventType)eventType {
 switch (eventType) {
 case AVPEventPrepareDone:
 {
 [self.player setPictureInPictureEnable:YES];
 }
 break;
 default:
 break;
 }
}

设置画中画代理

下述仅提供部分常用的画中画视窗和播放器视窗进行交互操作的代码示例，包含显示画中画的暂停、播放、快进、快退按钮以及重新播放的逻辑，具体代理方法请参考播放器SDK Demo中SDK文件夹中AliyunPlayer.framework的AliPlayerPictureInPictureDelegate.h头文件的内容。

1. 增加画中画代理回调监听。

   [self.player setPictureinPictureDelegate:self];

2. 实现代理配置。

   1. 增加全局变量，用于控制播放器的状态变更。

      展开查看代码

      // 监听画中画当前是否是暂停状态
      @property (nonatomic, assign) BOOL isPipPaused;
      // 监听播放器当前的播放状态，通过监听播放事件状态变更newStatus回调设置
      @property (nonatomic, assign) AVPStatus currentPlayerStatus;
      // 设置画中画控制器，在画中画即将启动的回调方法中设置，并需要在页面准备销毁时主动将其设置为nil，建议设置
      @property (nonatomic, strong) AVPictureInPictureController *pipController;
      // 监听播放器当前播放进度，currentPosition设置为监听视频当前播放位置回调中的position参数值
      @property(nonatomic, assign) int64_t currentPosition;

   2. 监听播放事件状态变更回调接口时，主动调用下述方法更新画中画控制器相关状态。

      展开查看代码

      - (void)onPlayerStatusChanged:(AliPlayer*)player oldStatus:(AVPStatus)oldStatus newStatus:(AVPStatus)newStatus {
       self.currentPlayerStatus = newStatus;
      
       if (_pipController) {
       [self.pipController invalidatePlaybackState];
       }
      }

   3. 监听播放事件回调接口时，主动调用下述方法更新画中画控制器相关状态。

      展开查看代码

      - (void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
       if (eventType == AVPEventCompletion) {
       if (_pipController) {
       self.isPipPaused = YES; // 播放结束后，将画中画状态变更为暂停
       [self.pipController invalidatePlaybackState];
       }
       } else if (eventType == AVPEventSeekEnd) {
       // 跳转完成
       if (_pipController) {
       [self.pipController invalidatePlaybackState];
       }
       }
      }

   4. 设置监听。

      • 监听画中画即将启动回调

        展开查看代码

        /**
         @brief 画中画即将启动
         @param pictureInPictureController 画中画控制器
         */
        - (void)pictureInPictureControllerWillStartPictureInPicture:(AVPictureInPictureController *)pictureInPictureController {
         if (!_pipController) {
         self.pipController = pictureInPictureController;
         }
         self.isPipPaused = !(self.currentPlayerStatus == AVPStatusStarted);
         [pictureInPictureController invalidatePlaybackState];
        }

      • 监听画中画准备停止回调

        展开查看代码

        /**
         @brief 画中画准备停止
         @param pictureInPictureController 画中画控制器
         */
        - (void)pictureInPictureControllerWillStopPictureInPicture:(AVPictureInPictureController *)pictureInPictureController {
         self.isPipPaused = NO;
         [pictureInPictureController invalidatePlaybackState];
        }

      • 监听画中画停止前告诉代理恢复用户回调

        展开查看代码

        /**
         @brief 在画中画停止前告诉代理恢复用户接口
         @param pictureInPictureController 画中画控制器
         @param completionHandler 调用并传值YES以允许系统结束恢复播放器用户接口
         */
        - (void)pictureInPictureController:(AVPictureInPictureController *)pictureInPictureController restoreUserInterfaceForPictureInPictureStopWithCompletionHandler:(void (^)(BOOL restored))completionHandler {
         if (_pipController) {
         _pipController = nil;
         }
         completionHandler(YES);
        }

      • 监听设置画中画当前可播放视频的时间范围回调

        展开查看代码

        /**
         @brief 通知画中画控制器当前可播放的时间范围
         @param pictureInPictureController 画中画控制器
         @return 当前可播放的时间范围
         */
         - (CMTimeRange)pictureInPictureControllerTimeRangeForPlayback:(nonnull AVPictureInPictureController *)pictureInPictureController layerTime:(CMTime)layerTime{
         Float64 current64 = CMTimeGetSeconds(layerTime);
        
         Float64 start;
         Float64 end;
        
         if (currentPosition <= self.player.duration) {
         double curPostion = self.currentPosition / 1000.0;
         double duration = self.player.duration / 1000.0;
         double interval = duration - curPostion;
         start = current64 - curPostion;
         end = current64 + interval;
         CMTime t1 = CMTimeMakeWithSeconds(start, layerTime.timescale);
         CMTime t2 = CMTimeMakeWithSeconds(end, layerTime.timescale);
         return CMTimeRangeFromTimeToTime(t1, t2);
         } else {
         return CMTimeRangeMake(kCMTimeNegativeInfinity, kCMTimePositiveInfinity);
         }
        }

      • 监听设置画中画是否为暂停或播放状态回调

        展开查看代码

        /**
         @brief 将暂停或播放状态反映到UI上
         @param pictureInPictureController 画中画控制器
         @return 暂停或播放
         */
        - (BOOL)pictureInPictureControllerIsPlaybackPaused:(nonnull AVPictureInPictureController *)pictureInPictureController{
         return self.isPipPaused;
        }

      • 监听画中画点击快进或快退按钮回调，同步播放器状态

        展开查看代码

        /**
         @brief 点击快进或快退按钮
         @param pictureInPictureController 画中画控制器
         @param skipInterval 快进或快退的事件间隔
         @param completionHandler 一定要调用的闭包，表示跳转操作完成
         */
         - (void)pictureInPictureController:(nonnull AVPictureInPictureController *)pictureInPictureController skipByInterval:(CMTime)skipInterval completionHandler:(nonnull void (^)(void))completionHandler {
         int64_t skipTime = skipInterval.value / skipInterval.timescale;
         int64_t skipPosition = self.currentPosition + skipTime * 1000;
         if (skipPosition < 0) {
         skipPosition = 0;
         } else if (skipPosition > self.player.duration) {
         skipPosition = self.player.duration;
         }
         [self.player seekToTime:skipPosition seekMode:AVP_SEEKMODE_INACCURATE];
         [pictureInPictureController invalidatePlaybackState];
        }

      • 监听画中画点击暂停或播放按钮回调，需要执行的操作

        展开查看代码

        /**
         @brief 点击画中画暂停按钮
         @param pictureInPictureController 画中画控制器
         @param playing 是否正在播放
         */
        - (void)pictureInPictureController:(nonnull AVPictureInPictureController *)pictureInPictureController setPlaying:(BOOL)playing {
         if (!playing){
         [self.player pause];
         self.isPipPaused = YES;
         } else {
         // 建议：如果画中画播放完成，需要重新播放，可额外执行下面if语句的代码
         if (self.currentPlayerStatus == AVPStatusCompletion) {
         [self.player seekToTime:0 seekMode:AVP_SEEKMODE_ACCURATE];
         }
        
         [self.player start];
         self.isPipPaused = NO;
         }
         [pictureInPictureController invalidatePlaybackState];
        }

RTS降级播放

//设置降级源downgradeUrl
AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:downgradeUrl];
//可选，配置config其他项
AVPConfig *config = [self.player getConfig];
//设置降级URL
[self.player enableDowngrade:urlSource config:config];

/**
 @brief 设置视频的背景色
 @param color  the color
 */
/****
 @brief Set video background color
 @param color  the color
 */
-(void) setVideoBackgroundColor:(UIColor *)color;

//参数为8位16进制数据，8位数据两两为一组，按照顺序分别表示R(red) G(green) B(blue) A(alpha 透明度)
//例如0x00ff00ff，表示绿色
[aliPlayer setVideoBackgroundColor:0x00ff00ff]

/**
 @brief 使用vid+playauth方式播放。可参考：https://help.aliyun.com/document_detail/57294.html
 @param source AVPVidAuthSource的输入类型
 @see AVPVidAuthSource
 */
- (void)setAuthSource:(AVPVidAuthSource*)source;

VidPlayerConfigGenerator* gen = [[VidPlayerConfigGenerator alloc]init];
//增加playDomain字段，可以添加的字段参考
//https://help.aliyun.com/zh/vod/developer-reference/api-vod-2017-03-21-getplayinfo?spm=a2c4g.11186623.0.0.2bec2e44eqeDgx#api-detail-35
[gen addVidPlayerConfigByStringValue:@"playDomain" value: @"com.xxx.xxx"];
[source setPlayConfig:[gen generatePlayerConfig]];
[self.player setAuthSource:source]:

//值为1表示进行后台解码，值为0表示不进行后台解码，默认值为0
[self.player setOption:ALLOW_DECODE_BACKGROUND valueInt:1];

性能

本地缓存

iOS播放器SDK提供了本地缓存的功能，能够让用户重复播放视频时，提高起播速度、提高seek速度、减少卡顿，也能达到节省流量的目的。

开启本地缓存

本地缓存功能默认关闭，如需使用，需要手动开启。通过AliPlayerGlobalSettings中的enableLocalCache控制。示例如下：

/**
 * 开启本地缓存，开启之后，就会缓存到本地文件中。
 * @param enable：本地缓存功能开关。true：开启，false：关闭，默认关闭。
 * @param maxBufferMemoryKB：5.4.7.1及以后版本已废弃，暂无作用。
 * @param localCacheDir：必须设置，本地缓存的文件目录，为绝对路径。
 */
[AliPlayerGlobalSettings enableLocalCache:true maxBufferMemoryKB:1024 localCacheDir:@""];

/**
 @brief 本地缓存文件自动清理相关的设置。
 @param expireMin：5.4.7.1及以后版本已废弃，暂无作用。
 @param maxCapacityMB：最大缓存容量。单位：兆，默认值20GB，在清理时，如果缓存总容量超过此大小，则会以cacheItem为粒度，按缓存的最后时间排序，一个一个的删除最旧的缓存文件，直到小于等于最大缓存容量。
 @param freeStorageMB：磁盘最小空余容量。单位：兆，默认值0，在清理时，同最大缓存容量，如果当前磁盘容量小于该值，也会按规则一个一个的删除缓存文件，直到freeStorage大于等于该值或者所有缓存都被清理掉。
 */
[AliPlayerGlobalSettings setCacheFileClearConfig:0 maxCapacityMB:0 freeStorageMB:0];

/**
 * 获取加载url的hash值回调，用来做url唯一的id，必须要保证每个url都不一样。
 */

// 需要自己实现这个函数并把函数指针交给setCacheUrlHashCallback
static NSString *CaheUrlHashHandle(NSString *url) {
 return @"xxx";
}

[AliPlayerGlobalSettings setCacheUrlHashCallback:&CaheUrlHashHandle];

开启或关闭单个URL的本地缓存

如果想要针对单个URL关闭本地缓存功能，可以在player config中设置。示例如下：

//先获取配置
AVPConfig *config = [self.player getConfig];
//是否针对播放的URL开启本地缓存，默认值为true。当AliPlayerGlobalSettings处的本地缓开启时，且同时开启此处的本地缓存，即设置为true，该URL的本地缓存才会生效；若此处设置为false，则关闭该URL的本地缓存。
config.enableLocalCache = false;
....//其他设置

//设置配置给播放器
[self.player setConfig:config];

大缓存

通过设置数据的最大缓冲区时长可以在播放视频时通过缓存视频数据到内存中，从而提高播放性能和观看体验。当最大缓冲区时长设置过大时，会造成缓冲区对内存的消耗。通过启用大缓存，可以将视频数据缓存到文件中，从而降低内存的占用，进一步提高播放器性能。

当mMaxBufferDuration设置超过50000 ms时，通过开启本地缓存触发大缓存功能自动启用。操作流程如下：

1. 开启全局本地缓存。

   本地缓存功能默认关闭，如需使用，需要手动开启。通过AliPlayerGlobalSettings中的enableLocalCache控制。代码示例请参见本地缓存中的开启本地缓存。

2. 开启URL的本地缓存。

   代码示例请参见本地缓存中的开启或关闭单个URL的本地缓存。

预加载

iOS播放器SDK提供预加载功能，是对本地缓存功能的升级，通过设置视频缓存的内存占用大小，更能提升视频的起播速度。

[AliPlayerGlobalSettings enableNetworkBalance:false];

1. 开启本地缓存功能，详细操作请参见本地缓存。

2. 获取AliMediaLoader实例。

   AliMediaLoader实例为单例，即无论获取多少次，创建的都是同一个实例。

   [AliMediaLoader shareInstance];

3. 配置AliMediaLoader。

   展开查看代码

   //配置回调，并开始加载。
   // url：为视频文件地址。 duration：加载的时长大小，单位：毫秒。
   [[AliMediaLoader shareInstance] load:obj.url duration:1000];
   // 设置回调代理
   [[AliMediaLoader shareInstance] setAliMediaLoaderStatusDelegate:self];
   
   @protocol AliMediaLoaderStatusDelegate <NSObject>
   @optional
   
   /**
    @brief 错误回调
    @param url 加载url
    @param code 错误码
    @param msg 错误描述
    */
   - (void)onError:(NSString *)url code:(int64_t)code msg:(NSString *)msg;
   
   /**
    @brief 完成回调
    @param url 加载url
    */
   - (void)onCompleted:(NSString *)url;
   
   /**
    @brief 取消回调
    @param url 加载url
    */
   - (void)onCanceled:(NSString *)url;
   
   @end

4. 可选：删除加载文件。

   可按需删除加载文件，以节省空间。iOS播放器SDK不提供删除接口，需要在App删除加载目录下的文件。

动态预加载

动态预加载策略，支持集成方既可以控制当前正在播放视频的缓存，又可以控制预加载的个数和缓存，满足业务方对播放体验与成本开销之间取得平衡的诉求。

// 开启推荐配置和动态预加载
[self.listPlayer setScene:AVP_SHORT_VIDEO];

// 配置基准预加载时长
// 设置预加载时长为1000ms
AVPPreloadConfig *config = [[AVPPreloadConfig alloc] init];
config.preloadDuration = 1000;
[self.listPlayer updatePreloadConfig:config];

// 配置预加载的数量，支持双向
// 1为向前预加载的数量，3为向后预加载的数量
[self.listPlayer setPreloadCount:1 nextCount:3];

// 配置动态预加载的递减的offset
[self.listPlayer enableStrategy:AVP_STRATEGY_DYNAMIC_PRELOAD enable:true];
[self.listPlayer setStrategyParam:AVP_STRATEGY_DYNAMIC_PRELOAD strategyParam:@"{\"algorithm\": \"sub\",\"offset\": \"200\"}"];

获取下载速度

- (void)onCurrentDownloadSpeed:(AliPlayer *)player speed:(int64_t)speed{
 intspeed_=speed;
}

网络特性

//打开增强型httpdns
[AliPlayerGlobalSettings enableEnhancedHttpDns:YES];
//可选，增加httpdns预解析域名
[[AliDomainProcessor shareInstance] addPreResolveDomain:@"player.***alicdn.com"];

HTTP/2

[AliPlayerGlobalSettingssetUseHttp2:true];

// domain格式为host[:port]，port可选，多个域名之间用分号（;）隔开
// 全局设置
// 全量接口每次设置后使用当前的字符串为准（多-新增，少-删除），字符串空为停止预建连
[AliPlayerGlobalSettings setOption:SET_PRE_CONNECT_DOMAIN value: @"domain1;domain2"];

视频下载

iOS播放器SDK提供了点播服务视频的下载功能，允许用户通过阿里云播放器将视频缓存至本地观看。同时，提供了普通下载和安全下载两种下载方式。

• 普通下载：下载后的视频数据未经过阿里云加密，用户可以用第三方播放器播放。

• 安全下载：下载后的视频数据经过阿里云加密。第三方播放器无法播放。仅支持使用阿里云的播放器进行播放。

使用说明

• 仅VidSts和VidAuth方式支持视频下载功能。

• 使用播放器的视频下载功能，需要在点播控制台开启并配置下载模式，详细操作请参见离线下载。

• 视频下载支持断点续传。

操作步骤

1. 可选：配置安全下载的加密校验文件。仅安全下载需要配置，普通下载无需配置。

   说明

   请确保配置的加密校验文件与App信息一致，否则会导致视频下载失败。

   如果设置为安全下载方式，则需要将在点播控制台生成的密钥文件配置到播放器SDK中，用于视频下载和播放的解密验证，密钥文件的生成请参见开启安全下载。

   建议在Application中配置一次即可，示例如下：

   NSString *encrptyFilePath = [[NSBundle mainBundle] pathForResource:@"encryptedApp" ofType:@"dat"];
   [AliPrivateService initKey:encrptyFilePath];

2. 创建并设置下载器。

   示例如下：

   AliMediaDownloader *downloader = [[AliMediaDownloader alloc] init];
   [downloader setSaveDirectory:self.downLoadPath];
   [downloader setDelegate:self];

3. 设置监听事件。

   下载器提供了多个事件监听。示例如下：

   -(void)onPrepared:(AliMediaDownloader *)downloader mediaInfo:(AVPMediaInfo *)info {
       //准备下载项成功
   }
   -(void)onError:(AliMediaDownloader *)downloader errorModel:(AVPErrorModel *)errorModel {
       //下载出错
   }
   -(void)onDownloadingProgress:(AliMediaDownloader *)downloader percentage:(int)percent {
       //下载进度百分比
   }
   -(void)onProcessingProgress:(AliMediaDownloader *)downloader percentage:(int)percent {
       //处理进度百分比
   }
   -(void)onCompletion:(AliMediaDownloader *)downloader {
       //下载成功
   }

4. 准备下载源。

   通过prepare方法准备下载源，支持VidSts和VidAuth两种方式。示例如下：

   • VidSts

     //创建VidSts
     AVPVidStsSource* stsSource = [[AVPVidStsSource alloc] init];
     stsSource.region = @"接入地域"; // 点播服务的接入地域，默认为cn-shanghai。
     stsSource.vid = @"Vid信息"; // 视频ID（VideoId）。
     stsSource.securityToken = @"<yourSecurityToken>"; // STS安全令牌，需要调用STS服务的AssumeRole接口生成。
     stsSource.accessKeySecret = @"<yourAccessKeySecret>"; // STS临时AK对的访问密钥，需要调用STS服务的AssumeRole接口生成。
     stsSource.accessKeyId = @"<yourAccessKeyId>"; // STS临时AK对的访问密钥ID，需要调用STS服务的AssumeRole接口生成。
     //准备下载源
     [downloader prepareWithVid:stsSource];

   • VidAuth

     //创建VidAuth
     AVPVidAuthSource *authSource = [[AVPVidAuthSource alloc] init];
     authSource.vid = @"Vid信息"; // 视频ID（VideoId）。
     authSource.playAuth = @"<yourPlayAuth>"; // 播放凭证，需要调用点播服务的GetVideoPlayAuth接口生成。
     authSource.region = @"接入地域"; // 5.5.5.0及之后版本播放器SDK，本参数已弃用，无需设置region，播放器会自动解析region；5.5.5.0之前版本播放器SDK，本参数必选，点播服务的接入地域，默认为cn-shanghai。
     //准备下载源
     [downloader prepareWithVid:authSource];

5. 准备成功后，选择下载项。

   准备成功后，会回调onPrepared方法。返回的TrackInfo中会包含各视频流的清晰度等信息，请选择一个Track进行下载，示例如下：

   -(void)onPrepared:(AliMediaDownloader *)downloader mediaInfo:(AVPMediaInfo *)info {
       NSArray<AVPTrackInfo*>* tracks = info.tracks;
       //比如：下载第一个TrackInfo
       [downloader selectTrack:[tracks objectAtIndex:0].trackIndex];
   }

6. 更新下载源并开始下载。

   为了防止VidSts和VidAuth过期，建议更新下载源的信息后开始下载。示例如下：

   //更新下载源
   [downloader updateWithVid:vidSource]
   //开始下载
   [downloader start];

7. 下载成功或失败后，释放下载器。

   下载成功后，调用destroy释放下载器。

   [self.downloader destroy];
   self.downloader = nil;

视频加密播放

点播视频支持HLS标准加密、阿里云私有加密和DRM加密，直播视频仅支持DRM加密。加密播放请参见如何播放加密视频。

Native RTS播放

iOS播放器SDK集成Native RTS SDK实现Native端低延时直播功能，详情请参见阿里云播放器SDK集成Native RTS SDK实现说明（iOS端）。

异常处理

使用阿里云播放器播放视频发生异常时，可借助单点探查功能快速定位问题，详细内容，请参见单点追查。

相关文档

• API说明

• 错误码

• iOS端