进阶功能

专业能力确认

在应用启动时，或调用任意播放器接口前，设置监听器：

void premiumVeryfyCallback(AVPPremiumBizType biztype, bool isValid, NSString* errorMsg) {
    NSLog(@"onPremiumLicenseVerifyCallback: %d, isValid: %d, errorMsg: %@", biztype, isValid, errorMsg);
}

[AliPrivateService setOnPremiumLicenseVerifyCallback:premiumVeryfyCallback];

其中，AVPPremiumBizType为专业能力枚举类型，使用相关功能时播放器会校验并通过该回调返回结果。若isValid为false，errorMsg将包含具体原因。

播放

/**
 @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.player 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.player setUrlSource:source];

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

[self.player setAutoPlay: YES];
[self.player 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];

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
}

AVPConfig *config = [self.player getConfig];
config.maxAllowedAbrVideoPixelNumber = 921600;//设置abr清晰度上限对应的像素数量为921600（长 * 宽 = 1280 * 720），使得abr允许切换的清晰度对应的像素数量 <= 该值
[self.player setConfig:config];

截图

//截图回调
- (void)onCaptureScreen:(AliPlayer *)player image:(UIImage *)image {
    // 处理截图
}
//截取当前播放的画面
[self.player 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. 设置画中画代理。

   /**
   * @brief 设置画中画代理
   */
   -(void) setPictureinPictureDelegate:(id<AliPlayerPictureInPictureDelegate>)delegate;
   
   
   // 设置画中画代理
   [self.player setPictureinPictureDelegate:self];

2. 添加变量，实现代理接口。

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

      #import "YourUIViewController.h"
      #import <AliyunPlayer/AliyunPlayer.h>
      
      @interface YourUIViewController () <AVPDelegate, AliPlayerPictureInPictureDelegate>
      // 播放器实例
      @property (nonatomic, strong) AliPlayer *player;
      // 播放器视图容器
      @property (nonatomic, strong) UIView *playerView;
      // 监听画中画当前是否是暂停状态
      @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;
      
      @end

      说明

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

// 设置AVPOutputAudioChannel枚举值切换声道
// AVP_AUDIO_CHANNEL_NONE  不指定声道，保持输入源声道播放，默认值
// AVP_AUDIO_CHANNEL_LEFT 切换到左声道播放
// AVP_AUDIO_CHANNEL_RIGHT 切换到右声道播放
self.player.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，表示绿色
[self.player 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];

// x.x.x与播放器SDK版本号保持一致
pod 'AliPlayerSDK_iOS_VVC_CODEC_PLUGIN', 'x.x.x'

// x.x.x与所用一体化SDK版本号保持一致
pod 'AliVCSDK_Standard/AliPlayerSDK_iOS_VVC_CODEC', 'x.x.x'

[AliPlayerGlobalSettings enableCodecPlugin:@"vvc" valid:true];

/**
 @brief 设置 VidAuth 源过期通知的回调。

 当播放器检测到当前 VidAuth 源已过期时触发回调。VidAuth 源过期包含PlayAuth过期与播放地址过期。
 您可以在回调中刷新 VidAuth 源，并通过 `callback` 提交新的 VidAuth 源对象，确保视频播放稳定流畅。

 @param callback VidAuth 源过期时触发的回调块。
 您可以通过该回调返回有效的 `VidAuth` 对象以更新播放器。
 */
/****
 @brief Set the callback for VidAuth source expiration notification.

 This method is triggered when the player detects that the current VidAuth source has expired.
 You can refresh the VidAuth source within the callback and use the `callback` to return the updated VidAuth source,
 ensuring uninterrupted and smooth video playback.

 @param callback The callback block triggered when the VidAuth source expires.
 Use this callback to provide a valid `VidAuth` object to update the player.
 */
-(void)setOnVidAuthExpiredCallback:(void (^)(id expiredSource, id<AVPSourceRefreshCallback> callback))callback;

/**
 @protocol AVPSourceRefreshCallback
 @brief 播放源刷新回调协议，开发者需实现以处理播放源的刷新结果。

 此回调用于在播放器请求刷新播放源时通知开发。
 播放器会调用协议中的方法以向开发者提供刷新结果，包括成功或失败。

 @note 此协议适用于 URL 源、VidAuth 源等需要刷新逻辑的场景。
 */
 /****
 @brief A protocol for handling playback source refresh results, which developers need to implement.

 This protocol notifies developers when the player requests playback source refresh, such as when a resource
 has expired or needs updating. The methods in this protocol are called to provide the refresh results to the developer,
 including success or failure.

 @note This protocol applies to URL source, VidAuth source, and similar scenarios requiring refresh logic.
 */
@protocol AVPSourceRefreshCallback <NSObject>

/**
 @brief 当刷新操作成功时由播放器调用
 @param newSource 包含更新信息的新播放源对象。
 
 此方法表示刷新操作已成功完成。开发者需要将更新后的 `newSource` 返回给播放器，
 以使播放器能够加载新的资源。
 */
 /****
 @brief Called by the player when the refresh operation succeeds.
 
 @param newSource The new playback source object containing the updated information.

 This method indicates that the refresh operation has been successfully completed. Developers need to pass
 the updated `newSource` back to the player so that it can load the latest resource.
 */
- (void)onSuccess:(id)newSource;

/**
 @brief 当刷新操作失败时由播放器调用
 @param errorMsg 描述失败原因的错误信息。
 
 此方法表示刷新操作失败。开发者可通过 `errorMsg` 捕获失败信息并进行后续处理。
 */
 /****
 @brief Called by the player when the refresh operation fails.
 
 @param errorMsg A string describing the reason for the failure.

 This method indicates that the refresh operation has failed. Developers can use `errorMsg` to capture failure
 details and handle subsequent processing accordingly.
 */
- (void)onError:(NSString *)errorMsg;

@end

[self.player setOnVidAuthExpiredCallback:^(id expiredSource, id<AVPSourceRefreshCallback> callback) {
    // 获取 AVPVidAuthSource
    if ([expiredSource isKindOfClass:[AVPVidAuthSource class]]) {

        // ------------------- 用户实现部分开始 -------------------
        // 调用您自己实现的、从App服务器获取新PlayAuth的函数。
        // clinetGetPlayAuthFunction 是一个示例函数名，您需要替换为您自己的实现。
        [self clinetGetPlayAuthFunction:vid success:^(NSString* newPlayAuth){
            // 1. 成功获取到新凭证的回调
            [vidAuth setPlayAuth:newPlayAuth];
            // 2. 将更新后的对象通过SDK的回调传回给播放器
            [callback onSuccess:vidAuth];
        } failure:^(NSString* errorMsg) {
            // 获取新凭证失败的回调。
            // errorMsg 详细的错误信息。
            [callback onError:errorMsg];
        }];
        // ------------------- 用户实现部分结束 -------------------
    }
}];

/**
 @brief 设置 URL 源过期通知的回调。

 当播放器检测到当前的 URL 源已失效时触发回调。
 您可以在回调中通过刷新 URL 源并调用 `callback` 返回新的 URL 源，确保视频播放不中断。

 @note 关于 URL 鉴权机制的配置，请参考阿里云官方文档：
 https://help.aliyun.com/zh/vod/user-guide/configure-url-signing?spm=a2c4g.11186623.0.0.560c4140fGh8MW
 
 @param callback URL 源过期时触发的回调块。
 您可以通过该回调返回有效的 `URLSource` 对象以更新播放器。
 */
 /****
 @brief Set the callback for URL source expiration notification.

 This method is triggered when the player detects that the current URL source has expired.
 You can refresh the URL source within the callback and use the `callback` to return the updated URL source,
 ensuring uninterrupted video playback.

 @param callback The callback block triggered when the URL source expires.
 Use this callback to provide a valid `URLSource` object to update the player.
 */
-(void)setOnURLSourceExpiredCallback:(void (^)(id expiredSource, id<AVPSourceRefreshCallback> callback))callback;

/**
 @protocol AVPSourceRefreshCallback
 @brief 播放源刷新回调协议，开发者需实现以处理播放源的刷新结果。

 此回调用于在播放器请求刷新播放源时通知开发。
 播放器会调用协议中的方法以向开发者提供刷新结果，包括成功或失败。

 @note 此协议适用于 URL 源、VidAuth 源等需要刷新逻辑的场景。
 */
 /****
 @brief A protocol for handling playback source refresh results, which developers need to implement.

 This protocol notifies developers when the player requests playback source refresh, such as when a resource
 has expired or needs updating. The methods in this protocol are called to provide the refresh results to the developer,
 including success or failure.

 @note This protocol applies to URL source, VidAuth source, and similar scenarios requiring refresh logic.
 */
@protocol AVPSourceRefreshCallback <NSObject>

/**
 @brief 当刷新操作成功时由播放器调用
 @param newSource 包含更新信息的新播放源对象。
 
 此方法表示刷新操作已成功完成。开发者需要将更新后的 `newSource` 返回给播放器，
 以使播放器能够加载新的资源。
 */
 /****
 @brief Called by the player when the refresh operation succeeds.
 
 @param newSource The new playback source object containing the updated information.

 This method indicates that the refresh operation has been successfully completed. Developers need to pass
 the updated `newSource` back to the player so that it can load the latest resource.
 */
- (void)onSuccess:(id)newSource;

/**
 @brief 当刷新操作失败时由播放器调用
 @param errorMsg 描述失败原因的错误信息。
 
 此方法表示刷新操作失败。开发者可通过 `errorMsg` 捕获失败信息并进行后续处理。
 */
 /****
 @brief Called by the player when the refresh operation fails.
 
 @param errorMsg A string describing the reason for the failure.

 This method indicates that the refresh operation has failed. Developers can use `errorMsg` to capture failure
 details and handle subsequent processing accordingly.
 */
- (void)onError:(NSString *)errorMsg;

@end

[self.player setOnURLSourceExpiredCallback:^(id expiredSource, id<AVPSourceRefreshCallback> callback) {
    // 获取 AVPUrlSource
    if ([expiredSource isKindOfClass:[AVPUrlSource class]]) {
        AVPUrlSource *expiredUrlSource = (AVPUrlSource *)expiredSource;
        NSString *expiredUrl = [expiredUrlSource.playerUrl absoluteString];

        // 判断是否包含 auth_key
        if (![expiredUrl containsString:@"auth_key="]) {
            return;
        }

        // 1. 从过期 URL 中提取原始 URL
        NSRange authKeyQuestionRange = [expiredUrl rangeOfString:@"?auth_key="];
        NSRange authKeyAmpersandRange = [expiredUrl rangeOfString:@"&auth_key="];

        NSInteger authKeyIndex = NSNotFound;
        if (authKeyQuestionRange.location != NSNotFound) {
            authKeyIndex = authKeyQuestionRange.location;
        } else if (authKeyAmpersandRange.location != NSNotFound) {
            authKeyIndex = authKeyAmpersandRange.location;
        }

        NSString *originalUrl = nil;
        if (authKeyIndex != NSNotFound) {
            originalUrl = [expiredUrl substringToIndex:authKeyIndex];
        } else {
            // 如果没有找到 auth_key，认为整个 URL 就是原始 URL
            originalUrl = expiredUrl;
        }

        // 2. 准备新的鉴权参数凭证：authKey 和 过期时间
        // 如果类成员 authKey 有效，则取 authKey
        NSString *key = (self.authKey.length > 0) ? self.authKey : @"";
        if (!NOT_EMPTY(key)) {
            [callback onError:@"REFRESH_ERROR:key fail"];
            return;
        }       
        
        // 如果类成员 validTime 有效，则取 validTime, 无效取默认值
        NSTimeInterval validTime = (self.validTime > 0) ? self.validTime : 3600; // 默认 3600 秒
        NSTimeInterval newExpireTime = [[NSDate date] timeIntervalSince1970] + validTime;

         // 3. 使用 CdnAuthUtil 生成新的鉴权 URL（方式 A）
        NSString *newAuthUrl = [CdnAuthUtil aAuthWithUri:originalUrl key:key exp:newExpireTime];
        AVPUrlSource *resultSource = [[AVPUrlSource alloc] urlWithString:newAuthUrl];

        // 4. 回调处理
        if (newAuthUrl) {
            [callback onSuccess:resultSource];
        } else {
            [callback onError:@"REFRESH_ERROR:refresh fail"];
        }
    }
}];

#import "CdnAuthUtil.h"
#import <CommonCrypto/CommonDigest.h>

@implementation CdnAuthUtil

#pragma mark - Auth Method A
+ (NSString *)aAuthWithUri:(NSString *)uri key:(NSString *)key exp:(NSTimeInterval)exp {
    NSDictionary *components = [self matchUri:uri];
    if (!components) return nil;

    NSString *scheme = components[@"scheme"];
    NSString *host = components[@"host"];
    NSString *path = components[@"path"];
    NSString *args = components[@"args"];

    NSString *rand = @"0";
    NSString *uid = @"0";

    NSString *sstring = [NSString stringWithFormat:@"%@-%lld-%@-%@-%@", path, (long long)exp, rand, uid, key];
    NSString *hashvalue = [self md5sum:sstring];
    NSString *authKey = [NSString stringWithFormat:@"%lld-%@-%@-%@", (long long)exp, rand, uid, hashvalue];

    if (args.length > 0) {
        return [NSString stringWithFormat:@"%@%@%@%@&auth_key=%@", scheme, host, path, args, authKey];
    } else {
        return [NSString stringWithFormat:@"%@%@%@%@?auth_key=%@", scheme, host, path, args, authKey];
    }
}

#pragma mark - Private Helper: MD5
+ (NSString *)md5sum:(NSString *)src {
    const char *cStr = [src UTF8String];
    unsigned char result[CC_MD5_DIGEST_LENGTH];
    CC_MD5(cStr, (unsigned int)strlen(cStr), result);

    NSMutableString *hexString = [NSMutableString string];
    for (int i = 0; i < CC_MD5_DIGEST_LENGTH; i++) {
        [hexString appendFormat:@"%02x", result[i]];
    }
    return hexString.copy;
}

#pragma mark - Private Helper: Regex Match
+ (NSDictionary *)matchUri:(NSString *)uri {
    NSError *error = nil;
    NSRegularExpression *regex = [NSRegularExpression regularExpressionWithPattern:@"^(https?://)?([^/?]+)(/[^?]*)?(\\?.*)?$"
                                  options:0
                                  error:&error];
    if (error) {
        NSLog(@"Regex error: %@", error.localizedDescription);
        return nil;
    }

    NSTextCheckingResult *match = [regex firstMatchInString:uri
                                   options:0
                                   range:NSMakeRange(0, uri.length)];
    if (!match) return nil;

    __block NSString *scheme = nil, *host = nil, *path = nil, *args = nil;

    void (^setStringFromRange)(NSInteger, NSString**) = ^(NSInteger idx, NSString **outStr) {
        NSRange range = [match rangeAtIndex:idx];
        if (range.location != NSNotFound && range.length > 0) {
            *outStr = [uri substringWithRange:range];
        } else {
            *outStr = nil;
        }
    };

    setStringFromRange(1, &scheme);
    setStringFromRange(2, &host);
    setStringFromRange(3, &path);
    setStringFromRange(4, &args);

    // 默认值处理
    if (!scheme) scheme = @"http://";
    if (!path) path = @"/";

    return @{
        @"scheme": scheme,
        @"host": host,
        @"path": path,
        @"args": args ?: @""
        };
}
@end

性能

设置播放场景

设置播放场景会根据场景自动配置最佳参数（包括buffer设置、功能开关等），同时兼容通过setConfig接口自定义的参数设置（以自定义设置为准）。

接口示例

/**
 @brief 设置播放器场景
 @param scene 播放器场景
 @see AVPScene
 */
/****
 @brief Set player scene.
 @param scene Player scene.
 @see AVPScene
 */
-(void) setPlayerScene:(AVPScene)scene;

播放场景

typedef enum _AVPScene {
    /**
     * 场景：无
     */
    /****
     * scene none
     */
    SceneNone,
    /**
     * 长视频场景：适用于30min以上
     */
    /****
     * long scene: apply to more than 30min
     */
    SceneLong,
    /**
     * 中视频场景：适用于5min-30min
     */
    /****
     * middle scene: apply to 5min-30min
     */
    SceneMedium,
    /**
     * 短视频场景：适用于0s-5min
     */
    /****
     * short scene: apply to 0s-5min
     */
    SceneShort,
    /**
     * 直播场景
     */
    /****
     * live scene
     */
    SceneLive,
    /**
     * 超低延迟直播场景
     */
    /****
     * RTS live scene
     */
    SceneRTSLive
} AVPScene;

用法说明

// 设置短视频场景
[self.player setPlayerScene:SceneShort];

// 设置中视频场景
[self.player setPlayerScene:SceneMedium]; 

// 设置长视频场景
[self.player setPlayerScene:SceneLong];  

// 设置直播场景
[self.player setPlayerScene:SceneLive];   

预渲染

[self.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];

预加载

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

[AliPlayerGlobalSettings enableNetworkBalance:false];

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

2. 设置数据源。

   VidAuth（推荐）

   AVPVidAuthSource* vidAuthSource = [[AVPVidAuthSource alloc] init];
   [vidAuthSource setVid:@"Vid信息"]; // 必选参数，视频ID（VideoId）。
   [vidAuthSource setPlayAuth:@"<yourPlayAuth>"]; // 必选参数，播放凭证，需要调用点播服务的GetVideoPlayAuth接口生成。
   [vidAuthSource setRegion:@"接入地域"]; // 5.5.5.0及之后版本播放器SDK，本参数已弃用，无需设置region，播放器会自动解析region；5.5.5.0之前版本播放器SDK，本参数必选，点播服务的接入地域，默认为cn-shanghai。
   [vidAuthSource setQuality:@"选择的清晰度"]; //"AUTO"代表自适应码率

   VidSts

   AVPVidStsSource* vidStsSource = [[AVPVidStsSource alloc] init];
   [vidStsSource setVid: @"Vid信息"]; // 必选参数，视频ID（VideoId）。
   [vidStsSource setRegion:@"接入地域"]; // 必选参数，点播服务的接入地域，默认为cn-shanghai。
   [vidStsSource setSecurityToken: @"<yourSecurityToken>"]; // 必选参数，STS安全令牌，需要调用STS服务的AssumeRole接口生成
   [vidStsSource setAccessKeySecret: @"<yourAccessKeySecret>"]; // 必选参数，STS临时AK对的访问密钥，需要调用STS服务的AssumeRole接口生成。
   [vidStsSource setAccessKeyId: @"<yourAccessKeyId>"]; // 必选参数，STS临时AK对的访问密钥ID，需要调用STS服务的AssumeRole接口生成。
   [vidStsSource setQuality:@"选择的清晰度"]; //"AUTO"代表自适应码率

   UrlSource

   NSString* url = @"播放地址"; // 必选参数，播放地址，可以是第三方点播地址，或阿里云视频点播服务中的播放地址。
   AVPUrlSource* urlSource = [[AVPUrlSource alloc]urlWithString:url];

3. 设置任务参数。

   说明

   仅适用于多码率视频，setDefaultBandWidth、setDefaultResolution、setDefaultQuality三者任选其一即可。

   AVPPreloadConfig *config = [[AVPPreloadConfig alloc]init];
   // 多码率流下设置预加载码率
   [config setDefaultBandWidth:400000];
   // 多码率流下设置预加载分辨率
   [config setDefaultResolution:640 * 480];
   // 多码率流下设置预加载质量
   [config setDefaultQuality:@"FD"];
   // 设置预加载时长
   [config setDuration:1000];

4. 添加任务监听器。

   展开查看代码

   @interface YourViewController () <OnPreloadListener>
   
   @property(nonatomic,strong) AliMediaLoaderV2* vodMedialoader; //预加载器
   @property(nonatomic,strong) AVPVidAuthSource* vidSource; // vidAuth 数据源
   @property(nonatomic,strong) AVPUrlSource* urlSource; // url 数据源
   @property(nonatomic,strong) AVPVidStsSource* vidStsSource; // vidSts 数据源
   
   @end
   
   @implementation YourViewController
   
   - (void)onCompleted:(NSString *)taskId urlOrVid:(NSString *)urlOrVid {
       NSLog(@"当前任务(%@)已完成:%@", taskId,urlOrVid);
   }
   
   - (void)onError:(NSString *)taskId urlOrVid:(NSString *)urlOrVid errorModel:(AVPErrorModel *)errorModel {
       NSLog(@"发生异常:%@", urlOrVid);
   }
   
   - (void)onCanceled:(NSString *)taskId urlOrVid:(NSString *)urlOrVid {
       NSLog(@"任务取消:%@", urlOrVid);
   }
   
   @end

5. 构建任务并添加到MediaLoaderV2实例，开始预加载。

   说明

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

   VidAuth（推荐）

   //构建预加载任务
   AVPPreloadTask* mPreloadTask = [[AVPPreloadTask alloc]initWithVidAuthSource:vidAuthSource preloadConfig:config];
   //获取MediaLoaderV2实例
   AliMediaLoaderV2* vodMedialoader = [AliMediaLoaderV2 shareInstance];
   //添加任务并开始预加载
   NSString* taskId = [vodMedialoader addTask:mPreloadTask listener:self];

   VidSts

   //构建预加载任务
   AVPPreloadTask* mPreloadTask = [[AVPPreloadTask alloc]initWithVidStsSource:vidStsSource preloadConfig:config];
   //获取MediaLoaderV2实例
   AliMediaLoaderV2* vodMedialoader = [[AliMediaLoaderV2 alloc]init];
   //添加任务并开始预加载
   NSString* taskId = [vodMedialoader addTask:mPreloadTask listener:self];

   UrlSource

   //构建预加载任务
   AVPPreloadTask* mPreloadTask = [[AVPPreloadTask alloc]initWithUrlSource:urlSource preloadConfig:config];
   //获取MediaLoaderV2实例
   AliMediaLoaderV2* vodMedialoader = [[AliMediaLoaderV2 alloc]init];
   //添加任务并开始预加载
   NSString* taskId = [vodMedialoader addTask:mPreloadTask listener:self];

6. 可选：管理任务。

   [vodMedialoader cancelTask:taskId];//取消指定任务ID预加载任务
   [vodMedialoader pauseTask:taskId];//暂停指定任务ID预加载任务
   [vodMedialoader resumeTask:taskId];//恢复指定任务ID预加载任务

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

   可按需删除加载文件，以节省空间。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接口生成。
     
     //若您在VOD控制台开启了HLS标准加密参数透传，且默认的参数名为MtsHlsUriToken，那么需要设置config，并将其传入vid中，参考下述
     //若您未在VOD控制台开启了HLS标准加密参数透传，那么则不需要集成下述代码
     VidPlayerConfigGenerator* vp = [[VidPlayerConfigGenerator alloc] init];
     [vp setHlsUriToken:yourMtsHlsUriToken];
     stsSource.playConfig = [vp generatePlayerConfig];
     //准备下载源
     [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。
     //若您在VOD控制台开启了HLS标准加密参数透传，且默认的参数 名为MtsHlsUriToken，那么需要设置config，并将其传入vid中，参考下述
     //若您未在VOD控制台开启了HLS标准加密参数透传，那么则不需要集成下述代码
     VidPlayerConfigGenerator* vp = [[VidPlayerConfigGenerator alloc] init];
     [vp setHlsUriToken:yourMtsHlsUriToken];
     authSource.playConfig = [vp generatePlayerConfig];
     //准备下载源
     [downloader prepareWithVid:authSource];

   说明

   若您在VOD控制台开启HLS标准加密参数透传，默认的参数名为MtsHIsUriToken，详情见HLS标准加密参数透传，那么请按照上述代码，将MtsHIsUriToken值设入点播源中。

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端低延时直播功能，详情请参见iOS端实现RTS拉流。

异常处理

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

相关文档

• API说明

• 移动端错误码

• iOS播放器常见问题