ApsaraVideo VOD：進階功能

播放

短視頻列表播放

針對典型的短視頻列表播放情境，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（ApsaraVideo for VOD推薦使用此方式）兩種播放方式。如何配置和使用試看功能，請參見試看視頻。

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://www.alibabacloud.com/help/zh/vod/user-guide/use-playback-credentials-to-play-videos
 @param source AVPVidAuthSource的輸入類型
 @see AVPVidAuthSource
 */
- (void)setAuthSource:(AVPVidAuthSource*)source;

VidPlayerConfigGenerator* gen = [[VidPlayerConfigGenerator alloc]init];
//增加playDomain欄位，可以添加的欄位參考
//https://www.alibabacloud.com/help/zh/vod/developer-reference/api-vod-2017-03-21-getplayinfo
[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播放器常見問題