播放

列表播放

針對典型的列表播放場景，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];

/**
 @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 {
    // 處理截圖
}
//截取當前播放的畫面
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];
    }
}

// 1表示開啟，0表示關閉。默認開啟
[AliPlayerGlobalSettings setOption:ALLOW_PRE_RENDER valueInt:1];

//設置降級源downgradeUrl
AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:downgradeUrl];
//可選，配置config其他項
AVPConfig *config = [self.player getConfig];
//設置降級URL
[self.player enableDowngrade:urlSource config:config];

// 設置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方式播放。可參考：http://bestwisewords.com/document_detail/57294.html
 @param source AVPVidAuthSource的輸入類型
 @see AVPVidAuthSource
 */
- (void)setAuthSource:(AVPVidAuthSource*)source;

VidPlayerConfigGenerator* gen = [[VidPlayerConfigGenerator alloc]init];
//增加playDomain字段，可以添加的字段參考
//http://bestwisewords.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播放器常見問題