ApsaraVideo VOD：進階功能

專業能力確認

在應用啟動時，或調用任意播放器介面前，設定監聽器：

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（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. 設定畫中畫代理。

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

// 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://www.alibabacloud.com/help/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 = @"播放地址"; // 必選參數，播放地址，可以是第三方點播地址，或阿里雲ApsaraVideo for VOD服務中的播放地址。
   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執行個體，開始預先載入。

   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播放器常見問題