ApsaraVideo VOD:高度な機能

プロフェッショナル機能の検証

アプリケーションの起動時、またはプレーヤーの API 操作を呼び出す前にリスナーを設定できます。

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 アルファレンダリングモード。右、左、上、下のアルファをサポートします。デフォルト値は none です。
 @see AVPAlphaRenderMode
 */
@property(nonatomic) AVPAlphaRenderMode alphaRenderMode;

//--------------ビューの使用法-------------
// View の場合、clearColor を設定する必要があります。
@property (weak, nonatomic) IBOutlet UIView *mediaPlayerView;
[self.aliplayerview setBackgroundColor:UIColor.clearColor];

//-----------AliPlayer の使用法-----------
// アルファモードを設定します。
[self.player setAlphaRenderMode:AVP_RENDERMODE_ALPHA_AT_LEFT];
// アルファモードに対応する素材を設定します。
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。
 */
@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) {
        // ソフトウェアデコードに切り替えられました。
    }
}

H.265 アダプティブ再生

// アプリケーション層は、元の URL とバックアップ URL のすべてのキーと値のペアを格納するマップを維持します。切り替え時に、元の URL に基づいてマップ内のバックアップ 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];

プレビュー

ApsaraVideo Player SDK for iOS は、ApsaraVideo VOD の設定と連携して、プレビュー機能を実現できます。VidSts と VidAuth (ApsaraVideo 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];

User-Agent の設定

// まず、構成を取得します。
AVPConfig *config = [self.player getConfig];
// User-Agent を設定します。
config.userAgent = userAgent;
....// その他の設定。
// プレーヤーの構成を設定します。
[self.player setConfig:config];

ネットワークリトライ時間と回数の設定

// まず、構成を取得します。
AVPConfig *config = [self.player getConfig];
// ネットワークタイムアウトをミリ秒単位で設定します。
config.networkTimeout = 5000;
// タイムアウト時のリトライ回数を設定します。各リトライの間隔は networkTimeout です。networkRetryCount=0 はリトライなしを意味し、リトライポリシーはアプリによって決定されます。デフォルト値は 2 です。
config.networkRetryCount = 2;
....// その他の設定。
// プレーヤーの構成を設定します。
[self.player setConfig:config];

キャッシュと遅延制御の設定

// まず、構成を取得します。
AVPConfig *config = [self.player getConfig];
// 最大遅延。注意：これはライブストリーミングに有効です。遅延が高い場合、プレーヤー SDK はフレーム同期を実行して、遅延がこの範囲内にあることを保証します。
config.maxDelayTime = 5000;
// 最大バッファ期間 (ミリ秒)。プレーヤーは、毎回最大でこの期間のバッファデータを読み込みます。
config.maxBufferDuration = 50000;
// 高バッファ期間 (ミリ秒)。ネットワーク状態が悪い場合にデータが読み込まれているとき、読み込まれたバッファ期間がこの値に達すると、読み込み状態が終了します。
config.highBufferDuration = 3000;
// 開始バッファ期間 (ミリ秒)。この時間を短く設定するほど、初回フレームの読み込みが速くなります。また、再生開始直後にプレーヤーが読み込み状態になる可能性もあります。
config.startBufferDuration = 500;
// その他の設定。
// プレーヤーの構成を設定します。
[self.player setConfig:config];

HTTP ヘッダーの設定

// まず、構成を取得します。
AVPConfig *config = [self.player getConfig];
// ヘッダーを定義します。
NSMutableArray *httpHeaders = [[NSMutableArray alloc] init];
// たとえば、HTTPDNS を使用する場合、Host を設定する必要があります。
[httpHeaders addObject:@"Host:example.com"];
// ヘッダーを設定します。
config.httpHeaders = httpHeaders;
....// その他の設定。
// プレーヤーの構成を設定します。
[self.player setConfig:config];

ピクチャーインピクチャー (PiP)

PiP の有効化

- (void)onPlayerEvent:(AliPlayer *)player eventType:(AVPEventType)eventType {
    switch (eventType) {
        case AVPEventPrepareDone:
        {
            [self.player setPictureInPictureEnable:YES];
        }
            break;
        default:
            break;
    }
}

PiP デリゲートの設定

次のセクションでは、ピクチャーインピクチャー (PiP) ウィンドウとプレーヤーウィンドウ間のインタラクションに関する一般的なコード例の一部のみを記載します。これらの例には、PiP ウィンドウでの一時停止、再生、早送り、早戻しボタンのロジック、および再再生のロジックが含まれます。デリゲートメソッドの詳細については、Player SDK Demo の SDK フォルダにある AliyunPlayer.framework の AliPlayerPictureInPictureDelegate.h ヘッダーファイルの内容をご参照ください。

1. PiP デリゲートを設定します。

   /**
   * @brief PiP デリゲートを設定します。
   */
   -(void) setPictureinPictureDelegate:(id<AliPlayerPictureInPictureDelegate>)delegate;
   
   
   // PiP デリゲートを設定します。
   [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;
      // PiP が現在一時停止しているかどうかをリッスンします。
      @property (nonatomic, assign) BOOL isPipPaused;
      // プレーヤーの現在の再生ステータスをリッスンし、再生イベントステータス変更リスナーの newStatus コールバックを通じて設定します。
      @property (nonatomic, assign) AVPStatus currentPlayerStatus;
      // PiP コントローラーを設定します。PiP が開始される前に呼び出されるコールバックメソッドで設定します。ページが破棄されるときにアクティブに nil に設定する必要があります。これを設定することを推奨します。
      @property (nonatomic, weak) AVPictureInPictureController *pipController;
      // プレーヤーの現在の再生進行状況をリッスンします。currentPosition を現在のビデオ再生位置のコールバックの position パラメーターの値に設定します。
      @property (nonatomic, assign) int64_t currentPosition;
      
      @end

      説明

      pipController は weak または assign で修飾する必要があります。assign を使用する場合は、変数が null に設定されるタイミングに注意してください。

   2. 再生イベントステータス変更コールバックインターフェイスをリッスンする場合、PiP コントローラーの関連ステータスを更新するために、次のメソッドをアクティブに呼び出す必要があります。

      - (void)onPlayerStatusChanged:(AliPlayer*)player oldStatus:(AVPStatus)oldStatus newStatus:(AVPStatus)newStatus {
          self.currentPlayerStatus = newStatus;
      
        if (_pipController) {
           [self.pipController invalidatePlaybackState];
         }
      }

   3. 再生イベントコールバックインターフェイスをリッスンする場合、PiP コントローラーの関連ステータスを更新するために、次のメソッドをアクティブに呼び出す必要があります。

      - (void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
          if (eventType == AVPEventCompletion) {
            if (_pipController) {
             self.isPipPaused = YES; // 再生が終了したら、PiP ステータスを一時停止に変更します。
             [self.pipController invalidatePlaybackState];
          }
        } else if (eventType == AVPEventSeekEnd) {
          // シークが完了しました。
            if (_pipController) {
             [self.pipController invalidatePlaybackState];
          }
        }
      }

   4. リスナーを設定します。

      • PiP が開始される前に呼び出されるコールバックをリッスンします。

        /**
         @brief PiP がまもなく開始されます。
         @param pictureInPictureController PiP コントローラー。
         */
        - (void)pictureInPictureControllerWillStartPictureInPicture:(AVPictureInPictureController *)pictureInPictureController {
            if (!_pipController) {
             self.pipController = pictureInPictureController;
          }
            self.isPipPaused = !(self.currentPlayerStatus == AVPStatusStarted);
          [pictureInPictureController invalidatePlaybackState];
        }

      • PiP が停止する前に呼び出されるコールバックをリッスンします。

        /**
         @brief PiP がまもなく停止します。
         @param pictureInPictureController PiP コントローラー。
         */
        - (void)pictureInPictureControllerWillStopPictureInPicture:(AVPictureInPictureController *)pictureInPictureController {
            self.isPipPaused = NO;
          [pictureInPictureController invalidatePlaybackState];
        }

      • PiP が停止する前にユーザーインターフェイスを復元するために呼び出されるコールバックをリッスンします。

        /**
         @brief PiP が停止する前にユーザーインターフェイスを復元するようにデリゲートに指示します。
         @param pictureInPictureController PiP コントローラー。
         @param completionHandler YES を渡して呼び出し、システムがプレーヤーのユーザーインターフェイスの復元を完了できるようにします。
         */
        - (void)pictureInPictureController:(AVPictureInPictureController *)pictureInPictureController restoreUserInterfaceForPictureInPictureStopWithCompletionHandler:(void (^)(BOOL restored))completionHandler {
            if (_pipController) {
              _pipController = nil;
          }
          completionHandler(YES);
        }

      • PiP モードで再生可能な時間範囲を設定するコールバックをリッスンします。

        /**
         @brief 現在の再生可能な時間範囲を PiP コントローラーに通知します。
         @param pictureInPictureController PiP コントローラー。
         @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);
            }
        }

      • PiP モードでビデオが一時停止しているかどうかを示すコールバックをリッスンします。

        /**
         @brief UI に一時停止または再生中の状態を反映します。
         @param pictureInPictureController PiP コントローラー。
         @return 一時停止または再生中。
         */
        - (BOOL)pictureInPictureControllerIsPlaybackPaused:(nonnull AVPictureInPictureController *)pictureInPictureController{
            return self.isPipPaused;
        }

        説明

        このコールバックは PiP が開始される前にトリガーされます。この時点でこのコールバックの戻り値が false であることを確認してください。そうしないと、PiP をアクティブにできません。

      • ユーザーが PiP モードで早送りまたは巻き戻しボタンをタップしたときに呼び出されるコールバックをリッスンし、プレーヤーのステータスを同期します。

        /**
         @brief ユーザーが早送りまたは巻き戻しボタンをタップします。
         @param pictureInPictureController PiP コントローラー。
         @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];
        }

      • ユーザーが PiP モードで一時停止または再生ボタンをタップしたときに呼び出されるコールバックをリッスンします。

        /**
         @brief ユーザーが PiP モードで一時停止ボタンをタップします。
         @param pictureInPictureController PiP コントローラー。
         @param playing ビデオが再生中かどうか。
         */
        - (void)pictureInPictureController:(nonnull AVPictureInPictureController *)pictureInPictureController setPlaying:(BOOL)playing {
            if (!playing){
              [self.player pause];
              self.isPipPaused = YES;
            } else {
              // 推奨：PiP 再生が完了し、リプレイが必要な場合は、次の if ステートメントのコードをさらに実行できます。
              if (self.currentPlayerStatus == AVPStatusCompletion) {
                 [self.player seekToTime:0 seekMode:AVP_SEEKMODE_ACCURATE];
              }
        
              [self.player start];
              self.isPipPaused = NO;
          }
          [pictureInPictureController invalidatePlaybackState];
        }

アプリ内ピクチャーインピクチャー

PiP 機能を使用する場合、デフォルトではアプリ外 PiP です。アプリ内 PiP を実装するには、まず次の API 操作を使用して PiP 機能が有効になっているかどうかを判断できます。

/**
 @brief PiP が有効になっているかどうかを示します。
 @param pictureInPictureController PiP コントローラー。
 @param isEnable PiP が有効になっているかどうか。
 */
- (void)pictureInPictureControllerIsPictureInPictureEnable:(nullable AVPictureInPictureController *)pictureInPictureController isEnable:(BOOL)isEnable;

PiP 機能が有効になっている場合、PiP の自動開始を無効にし、機能のアクティベーションを手動で制御できます。次のコードに例を示します。

- (void) pictureInPictureControllerIsPictureInPictureEnable:(nullable AVPictureInPictureController *) pictureInPictureController isEnable:(BOOL) isEnable
{
    if (isEnable && pictureInPictureController) {
        _pipController = pictureInPictureController;
        // pip の自動開始を閉じます
        if (@available(iOS 15.0, *)) {
            _pipController.canStartPictureInPictureAutomaticallyFromInline = false;
        }
    } else {
        _pipController = NULL;
    }
}

- (void) switchPip:(bool) enable {
    if (_pipController == nil) {
        return;
    }
    if (enable) {
        // pip を開始します
        [_pipController startPictureInPicture];
    } else {
        // 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  色
 */
-(void) setVideoBackgroundColor:(UIColor *)color;

// パラメーターは 8 ビットの 16 進数データです。8 ビットのデータは 2 つのグループに分割され、A (アルファ透明度)、R (赤)、G (緑)、B (青) を順番に表します。
// たとえば、0x0000ff00 は緑を表します。
[self.player setVideoBackgroundColor:0x0000ff00]

/**
 @brief VID + PlayAuth を使用して再生します。詳細については、https://www.alibabacloud.com/help/en/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/en/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 は ApsaraVideo Player SDK のバージョン番号と一致している必要があります。
pod 'AliPlayerSDK_iOS_VVC_CODEC_PLUGIN', 'x.x.x'

// x.x.x は、使用している All-in-One SDK のバージョン番号と一致している必要があります。
pod 'AliVCSDK_Standard/AliPlayerSDK_iOS_VVC_CODEC', 'x.x.x'

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

/**
 @brief VidAuth ソースの有効期限切れ通知のコールバックを設定します。

 このメソッドは、プレーヤーが現在の VidAuth ソースが期限切れであることを検出したときにトリガーされます。
 コールバック内で VidAuth ソースを更新し、`callback` を使用して更新された VidAuth ソースを返すことで、
 中断のないスムーズなビデオ再生を保証できます。

 @param callback VidAuth ソースが期限切れになったときにトリガーされるコールバックブロック。
 このコールバックを使用して、有効な `VidAuth` オブジェクトを提供し、プレーヤーを更新します。
 */
-(void)setOnVidAuthExpiredCallback:(void (^)(id expiredSource, id<AVPSourceRefreshCallback> callback))callback;

/**
 @protocol AVPSourceRefreshCallback
 @brief 再生ソースの更新結果を処理するためのプロトコルで、開発者が実装する必要があります。

 このプロトコルは、リソースが期限切れになったり更新が必要になったりした場合など、プレーヤーが再生ソースの更新を要求したときに開発者に通知します。
 このプロトコルのメソッドは、成功または失敗を含む更新結果を開発者に提供するために呼び出されます。

 @note このプロトコルは、URL ソース、VidAuth ソース、および更新ロジックを必要とする同様のシナリオに適用されます。
 */
@protocol AVPSourceRefreshCallback <NSObject>

/**
 @brief 更新操作が成功したときにプレーヤーによって呼び出されます。
 
 @param newSource 更新された情報を含む新しい再生ソースオブジェクト。

 このメソッドは、更新操作が正常に完了したことを示します。開発者は、
 更新された `newSource` をプレーヤーに返し、最新のリソースを読み込めるようにする必要があります。
 */
- (void)onSuccess:(id)newSource;

/**
 @brief 更新操作が失敗したときにプレーヤーによって呼び出されます。
 
 @param errorMsg 失敗の理由を説明する文字列。

 このメソッドは、更新操作が失敗したことを示します。開発者は `errorMsg` を使用して失敗の
 詳細をキャプチャし、それに応じて後続の処理を処理できます。
 */
- (void)onError:(NSString *)errorMsg;

@end

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

        // ------------------- ユーザー実装の開始 -------------------
        // アプリサーバーから新しい 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 署名メカニズムの設定については、Alibaba Cloud の公式ドキュメントをご参照ください：
 https://www.alibabacloud.com/help/zh/vod/user-guide/configure-url-signing?spm=a2c4g.11186623.0.0.560c4140fGh8MW
 
 @param callback URL ソースが期限切れになったときにトリガーされるコールバックブロック。
 このコールバックを使用して、有効な `URLSource` オブジェクトを提供し、プレーヤーを更新します。
 */
-(void)setOnURLSourceExpiredCallback:(void (^)(id expiredSource, id<AVPSourceRefreshCallback> callback))callback;

/**
 @protocol AVPSourceRefreshCallback
 @brief 再生ソースの更新結果を処理するためのプロトコルで、開発者が実装する必要があります。

 このプロトコルは、リソースが期限切れになったり更新が必要になったりした場合など、プレーヤーが再生ソースの更新を要求したときに開発者に通知します。
 このプロトコルのメソッドは、成功または失敗を含む更新結果を開発者に提供するために呼び出されます。

 @note このプロトコルは、URL ソース、VidAuth ソース、および更新ロジックを必要とする同様のシナリオに適用されます。
 */
@protocol AVPSourceRefreshCallback <NSObject>

/**
 @brief 更新操作が成功したときにプレーヤーによって呼び出されます。
 
 @param newSource 更新された情報を含む新しい再生ソースオブジェクト。

 このメソッドは、更新操作が正常に完了したことを示します。開発者は、
 更新された `newSource` をプレーヤーに返し、最新のリソースを読み込めるようにする必要があります。
 */
- (void)onSuccess:(id)newSource;

/**
 @brief 更新操作が失敗したときにプレーヤーによって呼び出されます。
 
 @param errorMsg 失敗の理由を説明する文字列。

 このメソッドは、更新操作が失敗したことを示します。開発者は `errorMsg` を使用して失敗の
 詳細をキャプチャし、それに応じて後続の処理を処理できます。
 */
- (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);

    // Handle default values
    if (!scheme) scheme = @"http://";
    if (!path) path = @"/";

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

パフォーマンス

再生シナリオの設定

再生シナリオを設定すると、バッファ設定や機能の切り替えなど、シナリオに基づいて最適なパラメーターが自動的に設定されます。この設定は、setConfig インターフェイスを使用して設定されたカスタムパラメーター設定とも互換性があります。カスタム設定が優先されます。

API の例

/**
 @brief プレーヤーシーンを設定します。
 @param scene プレーヤーシーン。
 @see AVPScene
 */
-(void) setPlayerScene:(AVPScene)scene;

再生シナリオ

typedef enum _AVPScene {
    /**
     * シーン：なし
     */
    SceneNone,
    /**
     * 長編動画シーン：30 分以上の動画に適用
     */
    SceneLong,
    /**
     * 中編動画シーン：5 分から 30 分の動画に適用
     */
    SceneMedium,
    /**
     * 短編動画シーン：0 秒から 5 分の動画に適用
     */
    SceneShort,
    /**
     * ライブストリーミングシーン
     */
    SceneLive,
    /**
     * RTS ライブシーン
     */
    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];

ローカルキャッシュ

ApsaraVideo Player SDK for iOS は、ローカルキャッシュ機能を提供します。この機能は、ユーザーがビデオを繰り返し再生する際の初回フレームの読み込み速度、シーク速度を向上させ、カクつきを減らします。また、トラフィックの節約にも役立ちます。

ローカルキャッシュの有効化

/**
 * ローカルキャッシュを有効にします。有効にすると、ビデオはローカルファイルにキャッシュされます。
 * @param enable: ローカルキャッシュ機能のスイッチ。true: 有効、false: 無効。デフォルトは false です。
 * @param maxBufferMemoryKB: V5.4.7.1 以降非推奨、効果なし。
 * @param localCacheDir: 設定必須。ローカルキャッシュファイルのディレクトリ、絶対パスである必要があります。
 */
[AliPlayerGlobalSettings enableLocalCache:true maxBufferMemoryKB:1024 localCacheDir:@""];

/**
 @brief ローカルキャッシュファイルの自動クリア設定。
 @param expireMin: V5.4.7.1 以降非推奨、効果なし。
 @param maxCapacityMB: 最大キャッシュ容量 (メガバイト)。デフォルトは 20 GB です。クリーンアップ中、合計キャッシュ容量がこのサイズを超えると、キャッシュアイテムの最終アクセス時間でソートされた最も古いキャッシュファイルが、合計容量が最大容量以下になるまで 1 つずつ削除されます。
 @param freeStorageMB: 最小空きディスク領域 (メガバイト)。デフォルトは 0 です。クリーンアップ中、最大キャッシュ容量と同様に、現在のディスク領域がこの値より小さい場合、空きストレージがこの値以上になるか、すべてのキャッシュがクリアされるまで、ルールに従ってキャッシュファイルも 1 つずつ削除されます。
 */
[AliPlayerGlobalSettings setCacheFileClearConfig:0 maxCapacityMB:0 freeStorageMB:0];

/**
 * 読み込まれた URL のハッシュ値を取得するためのコールバック。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];

プリロード

ApsaraVideo Player SDK for iOS は、ローカルキャッシュ機能をアップグレードしたプリロード機能を提供します。ビデオキャッシュが占有するメモリサイズを設定することで、ビデオの初回フレームの読み込み速度をさらに向上させることができます。

[AliPlayerGlobalSettings enableNetworkBalance:false];

1. ローカルキャッシュ機能を有効にします。詳細については、「ローカルキャッシュ」をご参照ください。

2. データソースを設定します。

   VidAuth (推奨)

   AVPVidAuthSource* vidAuthSource = [[AVPVidAuthSource alloc] init];
   [vidAuthSource setVid:@"Vid 情報"]; // 必須。ビデオ ID。
   [vidAuthSource setPlayAuth:@"<yourPlayAuth>"]; // 必須。再生認証情報。ApsaraVideo VOD の GetVideoPlayAuth API 操作を呼び出して生成する必要があります。
   [vidAuthSource setRegion:@"アクセスリージョン"]; // プレーヤー SDK V5.5.5.0 以降、このパラメーターは非推奨です。リージョンを設定する必要はありません。プレーヤーが自動的に解析します。V5.5.5.0 より前のプレーヤー SDK の場合、このパラメーターは必須です。ApsaraVideo VOD のアクセスリージョン、デフォルトは cn-shanghai です。
   [vidAuthSource setQuality:@"選択された解像度"]; // "AUTO" はアダプティブビットレートを表します。

   VidSts

   AVPVidStsSource* vidStsSource = [[AVPVidStsSource alloc] init];
   [vidStsSource setVid: @"Vid 情報"]; // 必須。ビデオ ID。
   [vidStsSource setRegion:@"アクセスリージョン"]; // 必須。ApsaraVideo VOD のアクセスリージョン、デフォルトは cn-shanghai です。
   [vidStsSource setSecurityToken: @"<yourSecurityToken>"]; // 必須。STS トークン。STS の AssumeRole API 操作を呼び出して生成する必要があります。
   [vidStsSource setAccessKeySecret: @"<yourAccessKeySecret>"]; // 必須。一時的な STS AccessKey ペアの AccessKey Secret。STS の AssumeRole API 操作を呼び出して生成する必要があります。
   [vidStsSource setAccessKeyId: @"<yourAccessKeyId>"]; // 必須。一時的な STS AccessKey ペアの AccessKey ID。STS の AssumeRole API 操作を呼び出して生成する必要があります。
   [vidStsSource setQuality:@"選択された解像度"]; // "AUTO" はアダプティブビットレートを表します。

   UrlSource

   NSString* url = @"再生 URL"; // 必須。再生 URL。サードパーティの VOD URL または ApsaraVideo VOD の再生 URL にすることができます。
   AVPUrlSource* urlSource = [[AVPUrlSource alloc]urlWithString:url];

3. タスクパラメーターを設定します。

   説明

   これはマルチビットレートビデオにのみ適用されます。setDefaultBandWidth、setDefaultResolution、または setDefaultQuality のいずれか 1 つのみを設定できます。

   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. (オプション) 読み込まれたファイルの削除

   必要に応じて読み込まれたファイルを削除して、スペースを節約できます。ApsaraVideo Player SDK for iOS は削除インターフェイスを提供していません。アプリの読み込みディレクトリ内のファイルを削除する必要があります。

動的プリロード

動的プリロードポリシーにより、インテグレーターは現在再生中のビデオのキャッシュと、プリロードされたビデオの数とキャッシュの両方を制御でき、ビジネスニーズに合わせて再生体験とコストオーバーヘッドのバランスを取ることができます。

// 推奨構成と動的プリロードを有効にします。
[self.listPlayer setScene:AVP_SHORT_VIDEO];

// ベースラインのプリロード期間を設定します。
// プリロード期間を 1000 ms に設定します。
AVPPreloadConfig *config = [[AVPPreloadConfig alloc] init];
config.preloadDuration = 1000;
[self.listPlayer updatePreloadConfig:config];

// プリロード数を設定し、両方向をサポートします。
// 1 は後方へのプリロード数、3 は前方へのプリロード数です。
[self.listPlayer setPreloadCount:1 nextCount:3];

// 動的プリロードの減少オフセットを設定します。
[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 {
    /**
     * デフォルトモード、ストリームのデフォルトビットレートを再生およびプリロードします。
     */
    AVPMultiBitratesMode_Default = 0,
    /**
     * 初回フレームコスト (FC) 優先、初回フレームコストを削減します。プリロードされた hls ストリームのビットレートのみを再生します。
     */
    AVPMultiBitratesMode_FCPrio = 1,
    /**
     * 初回フレームと再生のスムーズさのバランス、moveToNext の前後で同じビットレートを再生します。
     */
    AVPMultiBitratesMode_FC_AND_SMOOTH = 2,
    /**
     * 再生スムーズ優先、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];

// ドメイン形式は host[:port] で、port はオプションです。複数のドメイン名はセミコロン (;) で区切られます。
// グローバル設定
// 完全なインターフェイスは、設定されるたびに現在の文字列を使用します (多い場合は追加、少ない場合は削除)。空の文字列は事前接続を停止します。
[AliPlayerGlobalSettings setOption:SET_PRE_CONNECT_DOMAIN value: @"domain1;domain2"];

動画のダウンロード

ApsaraVideo Player SDK for iOS は、ApsaraVideo VOD 向けの動画ダウンロード機能を提供します。この機能により、ユーザーはビデオをローカルにキャッシュして ApsaraVideo Player で視聴できます。SDK は、標準ダウンロードとセキュアダウンロードの 2 つのダウンロード方法を提供します。

• 標準ダウンロード：ダウンロードされたビデオデータは Alibaba Cloud によって暗号化されません。ユーザーはサードパーティのプレーヤーで再生できます。

• セキュアダウンロード：ダウンロードされたビデオデータは Alibaba Cloud によって暗号化されます。サードパーティのプレーヤーではデータを再生できません。データは ApsaraVideo Player を使用してのみ再生できます。

注意事項

• 動画ダウンロード機能は、VidSts および VidAuth メソッドでのみサポートされています。

• プレーヤーの動画ダウンロード機能を使用するには、ApsaraVideo VOD コンソールでダウンロードモードを有効にして設定する必要があります。詳細については、「オフラインダウンロード」をご参照ください。

• 動画ダウンロードは、再開可能なダウンロードをサポートしています。

手順

1. (オプション) セキュアダウンロード用の暗号化検証ファイルを設定します。これはセキュアダウンロードにのみ必要で、標準ダウンロードには必要ありません。

   説明

   設定された暗号化検証ファイルがアプリ情報と一致していることを確認してください。そうしないと、動画のダウンロードに失敗します。

   ダウンロード方法をセキュアダウンロードに設定した場合、ApsaraVideo VOD コンソールで生成されたキーファイルをプレーヤー 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 = @"アクセスリージョン"; // ApsaraVideo VOD のアクセスリージョン。デフォルトは cn-shanghai です。
     stsSource.vid = @"Vid 情報"; // ビデオ ID。
     stsSource.securityToken = @"<yourSecurityToken>"; // STS トークン。STS の AssumeRole API 操作を呼び出して生成する必要があります。
     stsSource.accessKeySecret = @"<yourAccessKeySecret>"; // 一時的な STS AccessKey ペアの AccessKey Secret。STS の AssumeRole API 操作を呼び出して生成する必要があります。
     stsSource.accessKeyId = @"<yourAccessKeyId>"; // 一時的な STS AccessKey ペアの AccessKey ID。STS の AssumeRole API 操作を呼び出して生成する必要があります。
     
     // 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。
     authSource.playAuth = @"<yourPlayAuth>"; // 再生認証情報。ApsaraVideo VOD の GetVideoPlayAuth API 操作を呼び出して生成する必要があります。
     authSource.region = @"アクセスリージョン"; // プレーヤー SDK V5.5.5.0 以降、このパラメーターは非推奨です。リージョンを設定する必要はありません。プレーヤーが自動的に解析します。V5.5.5.0 より前のプレーヤー SDK の場合、このパラメーターは必須です。ApsaraVideo VOD のアクセスリージョン、デフォルトは 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 の値を VOD ソースに設定してください。

5. 準備が成功した後、ダウンロード項目を選択します。

   準備が成功すると、onPrepared メソッドがコールバックされます。返された TrackInfo には、各ビデオストリームの解像度などの情報が含まれています。ダウンロードするトラックを選択できます。次のコードに例を示します。

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

暗号化動画の再生

ApsaraVideo VOD は、HLS 暗号化、Alibaba Cloud 独自暗号化、および DRM 暗号化をサポートしています。ライブストリーミングビデオは DRM 暗号化のみをサポートしています。暗号化再生の詳細については、「暗号化動画の再生」をご参照ください。

ネイティブ RTS 再生

ApsaraVideo Player SDK for iOS は、ネイティブ RTS SDK を統合して、ネイティブの低遅延ライブストリーミング機能を実現します。詳細については、「iOS での RTS ストリームフェッチングの実装」をご参照ください。

関連ドキュメント

• API リファレンス

• モバイルクライアントのエラーコード

• ApsaraVideo Player for iOS のよくある質問