进阶功能

播放

短视频列表播放

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

播放带透明度视频

功能简介

阿里云播放器SDK支持渲染Alpha通道，实现播放透明礼物的动态效果。在直播间等场景中，播放透明礼物动效且不会遮挡直播间内容，明显提升用户观看和互动体验。

使用限制

一体化SDK6.8.0及以后版本或播放器SDK6.9.0及以后版本支持透明渲染能力。

功能优势

使用带有透明度信息的MP4视频作为礼物特效可以提供更好的动效质量，较小的文件体积，更高的兼容性和更高的开发效率。这使得礼物特效能够更好地展示给用户，提升用户体验。

1. 更好的动效质量：MP4视频可以保留原始的动效质量，包括细节和颜色等，相比于其他格式，如 APN 或IXD，MP4可以更准确地还原设计师创作的动效效果。

2. 较小的文件体积：MP4视频文件相比于其他格式，如APNG或IXD，可以更有效地压缩文件体积，提升加载速度并降低网络带宽消耗。

3. 更高的兼容性：MP4视频是一种通用的视频格式，在各种设备和浏览器中都得到广泛支持，支持在主流设备上播放和观看礼物特效。

4. 更高的开发效率：使用MP4视频作为礼物特效的技术方案相对简单，不需要开发人员去研究和实现复杂的解析和渲染逻辑，开发人员可以专注于其他功能的实现，提高开发效率。

/**
 @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];

/**
 @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) {
        //切换到软解
    }
}

H265自适应播放

// 应用层维护一个Map，存储所有原URL-备URL的键值对，切换时根据原URL在Map中查询备URL
NSString* getBackupUrlCallback(AVPBizScene scene, AVPCodecType codecType, NSString* oriurl){
    NSMutableDictionary *globalMap = [AliPlayerViewController getGlobalBackupUrlMap];
    NSString *backupUrl = globalMap[oriurl];
    return backupUrl; 
}

[AliPlayerGlobalSettings setAdaptiveDecoderGetBackupURLCallback:getBackupUrlCallback];

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

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 *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, weak) AVPictureInPictureController *pipController;
      // 监听播放器当前播放进度，currentPosition设置为监听视频当前播放位置回调中的position参数值
      @property(nonatomic, assign) int64_t currentPosition;

      说明

      pipController需要用weak或者assign修饰，在用assign修饰的时候，需要注意变量置空的时机。

   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;
        }

        说明

        在画中画启动前，会触发该回调，需要确保此时该回调的返回值为false，否则会无法唤起画中画。

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

        /**
         @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];
        }

应用内画中画

使用画中画功能时，默认情况下为应用外画中画。如需实现应用内画中画功能，您可以首先通过以下接口判断是否已启动画中画功能：

/**
 @brief 画中画是否启动
 @param pictureInPictureController 画中画控制器
 @param isEnable 画中画是否启动
 */
/****
 @brief pictureInPicture is enable or not
 @param pictureInPictureController picture in picture controller
 @param isEnable is enable or not
 */
- (void)pictureInPictureControllerIsPictureInPictureEnable:(nullable AVPictureInPictureController *)pictureInPictureController isEnable:(BOOL)isEnable;

已启动画中画功能时，关闭画中画的自动启动，改为手动控制功能的开启，示例代码如下：

- (void) pictureInPictureControllerIsPictureInPictureEnable:(nullable AVPictureInPictureController *) pictureInPictureController isEnable:(BOOL) isEnable
{
    if (isEnable && pictureInPictureController) {
        _pipController = pictureInPictureController;
        // close pip auto start
        if (@available(iOS 15.0, *)) {
            _pipController.canStartPictureInPictureAutomaticallyFromInline = false;
        }
    } else {
        _pipController = NULL;
    }
}

- (void) switchPip:(bool) enable {
    if (_pipController == nil) {
        return;
    }
    if (enable) {
        // start pip
        [_pipController startPictureInPicture];
    } else {
        // close pip
        [_pipController stopPictureInPicture];
    }
}

设置RTS降级地址

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

打开RTS降级开关

// 1表示开启，0表示关闭。默认开启
[AliPlayerGlobalSettings setOption:ALLOW_PRE_RENDER valueInt:1];

// 设置AVPOutputAudioChannel枚举值切换声道
// AVP_AUDIO_CHANNEL_NONE  不指定声道，保持输入源声道播放，默认值
// AVP_AUDIO_CHANNEL_LEFT 切换到左声道播放
// AVP_AUDIO_CHANNEL_RIGHT 切换到右声道播放
self.aliplayer.outputAudioChannel = AVP_AUDIO_CHANNEL_NONE;

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

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

/**
 @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];

性能

预渲染

[player setOption:ALLOW_PRE_RENDER valueInt:1];

本地缓存

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

开启本地缓存

/**
 * 开启本地缓存，开启之后，就会缓存到本地文件中。
 * @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的本地缓存

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

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

[AliPlayerGlobalSettings enableLocalCache:true];

大缓存

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

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

1. 开启全局本地缓存。

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

2. 开启URL的本地缓存。

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

3. 开启大缓存。

   [AliPlayerGlobalSettings enableBufferToLocalCache:true];

预加载

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

[AliPlayerGlobalSettings enableNetworkBalance:false];

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

2. 获取AliMediaLoader实例。

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

   [AliMediaLoader shareInstance];

3. 配置AliMediaLoader。

   说明

   若player的prepare时刻与mediaLoader.load的调用时刻一致，由于都需要遍历本地文件，则可能导致出现ANR的问题。建议设置为当player在onPrepared回调中时，才开始加载。

   //配置回调，并开始加载。
   // url：为视频文件地址。 duration：加载的时长大小，单位：毫秒。
   [[AliMediaLoader shareInstance] load:obj.url duration:1000];
   // 设置回调代理
   [[AliMediaLoader shareInstance] setAliMediaLoaderStatusDelegate:self];
   
   @protocol AliMediaLoaderStatusDelegate <NSObject>
   @optional
   
   /**
   @brief 错误回调V2
   @param url 加载url
   @param errorModel 播放器错误描述，参考AliVcPlayerErrorModel
   */
   - (void)onErrorV2:(NSString *)url errorModel:(AVPErrorModel *)errorModel;
   
   /**
    @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\"}"];

typedef enum AVPMultiBitratesMode : NSUInteger {
    /**
     * 默认配置，播放和预加载默认码率
     */
    /****
     * default mode, play and preload default bitrate of a stream
     */
    AVPMultiBitratesMode_Default = 0,
    /**
     * 首帧优先配置，起播视频默认播放已完成预加载的码率
     */
    /****
     * First frame cost (FC) priority, decrease first frame cost. only play bitrate of the hls stream which has been preloaded.
     */
    AVPMultiBitratesMode_FCPrio = 1,
    /**
     * 兼顾首帧和播放平滑，切换前后（moveToNext）的视频码率一致，且兼顾首帧性能
     */
    /****
     * First frame and play smooth, play the same bitrate before and after moveToNext
     */
    AVPMultiBitratesMode_FC_AND_SMOOTH = 2,
    /**
     * 播放平滑优先配置，起播视频默认播放前一个视频的码率
     */
    /****
     * Play Smooth priority, play the same bitrate before and after moveToNext.
     */
    AVPMultiBitratesMode_SmoothPrio = 3,
} AVPMultiBitratesMode;

//选择多码率加载模式
[self.listPlayer->SetMultiBitratesMode(preLoadMode)];

//（可选）选择起播码率
[self.listPlayer setDefaultBandWidth:defaultBandWidth];

//（可选）在preparedone回调中，选择abr模式
-(void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
    switch (eventType) {
        case AVPEventPrepareDone: {
            [self.listPlayer selectTrack:-1];
        }
            break;
        case AVPEventFirstRenderedStart: {
        }
            break;
        default:
            break;
    }
}

获取下载速度

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

网络特性

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

[AliPlayerGlobalSettings setUseHttp2: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播放器常见问题