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

//--------------ビューの使用-------------
// プレーヤーのビューには、透明な背景色を設定します。
@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 動画レンダリングタイプ。0 はデフォルトレンダリング、1 は混合レンダリングを意味します。
 */
@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 のマップを管理します。
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) {
        // レンディションが変更されました。
    }
    // その他
}

AVPConfig *config = [self.player getConfig];
config.maxAllowedAbrVideoPixelNumber = 921600;// ABR の最大許容ピクセル数を 1280×720 に設定します。プレーヤーは、この値以下のピクセル数を持つ解像度のみに切り替えます。
[self.player setConfig:config];

スナップショットの取得

// スナップショットコールバック。
- (void)onCaptureScreen:(AliPlayer *)player image:(UIImage *)image {
    // スナップショットを処理します。
}
// 現在のフレームのスナップショットを取得します。
[self.player snapShot];

プレビュー

ApsaraVideo VOD の構成と組み合わせることで、プレビュー機能を実装できます。これは VidSts および VidAuth（推奨）再生の両方でサポートされています。構成手順については、「動画のプレビュー」をご参照ください。

AVPVidStsSource *source = [[AVPVidStsSource alloc] init];
....
VidPlayerConfigGenerator* vp = [[VidPlayerConfigGenerator alloc] init];
[vp setPreviewTime:20];// 20 秒間のプレビュー
source.playConfig = [vp generatePlayerConfig];// 再生ソースに設定
...

Referer の設定

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

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 パラメーターの値です。値が 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 デモ」、特に AliyunPlayer.framework フォルダ内の AliPlayerPictureInPictureDelegate.h ヘッダーファイルをご参照ください。

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

   /**
   * @brief PiP デリゲートを設定します。
   */
   -(void) setPictureinPictureDelegate:(id<AliPlayerPictureInPictureDelegate>)delegate;
   
   
   // PiP デリゲートを設定します。
   [self.player setPictureinPictureDelegate:self];

2. 変数を追加し、デリゲートインターフェイスを実装します。

   1. プレーヤーおよび PiP の状態を管理するグローバル変数を追加します。

      #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;
      // プレーヤーの現在の再生進捗を監視する。現在の動画再生位置のコールバックの position パラメーターの値を currentPosition に設定します。
      @property (nonatomic, assign) int64_t currentPosition;
      
      @end

      説明

      pipController には weak または assign 修飾子を使用する必要があります。assign 修飾子を使用する場合、正しい変数を null に設定することを確認してください。

   2. onPlayerStatusChanged イベントを監視する際に、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 ピクチャーインピクチャーが開始しようとしています。
         @param pictureInPictureController ピクチャーインピクチャー コントローラー。
         */
        - (void)pictureInPictureControllerWillStartPictureInPicture:(AVPictureInPictureController *)pictureInPictureController {
            if (!_pipController) {
             self.pipController = pictureInPictureController;
          }
            self.isPipPaused = !(self.currentPlayerStatus == AVPStatusStarted);
          [pictureInPictureController invalidatePlaybackState];
        }

      • PiP が停止しようとしているコールバックを監視します。

        /**
         @brief ピクチャーインピクチャーが停止しようとしています。
         @param pictureInPictureController ピクチャーインピクチャー コントローラー。
         */
        - (void)pictureInPictureControllerWillStopPictureInPicture:(AVPictureInPictureController *)pictureInPictureController {
            self.isPipPaused = NO;
          [pictureInPictureController invalidatePlaybackState];
        }

      • PiP が停止する前にユーザーインターフェースを復元するようデリゲートに指示するコールバックを監視します。

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

      • PiP の現在の再生可能な時間範囲を設定するコールバックを監視します。

        /**
         @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);
            }
        }

      • PiP（ピクチャーインピクチャー）が一時停止中か再生中かを監視するコールバックです。

        /**
         @brief 一時停止または再生状態をユーザーインターフェースに反映します。
         @param pictureInPictureController ピクチャーインピクチャー コントローラー。
         @return 一時停止または再生中。
         */
        - (BOOL)pictureInPictureControllerIsPlaybackPaused:(nonnull AVPictureInPictureController *)pictureInPictureController{
            return self.isPipPaused;
        }

        説明

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

      • ユーザーが早送りまたは早戻しをクリックした際に、再生進捗をプレーヤーに同期させるコールバックを監視します。

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

      • PiP 内の一時停止または再生ボタンがクリックされた際に、必要な操作を実行するコールバックを監視します。

        /**
         @brief PiP 内の一時停止ボタンがクリックされました。
         @param pictureInPictureController ピクチャーインピクチャー コントローラー。
         @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 を実装するには、手動でその有効化を制御できます。まず、PiP が開始されているかどうかを判断します。

/**
 @brief PiP が開始されているかどうか。
 @param pictureInPictureController PiP コントローラー。
 @param isEnable PiP が開始されているかどうか。
 */
/****
 @brief PiP が有効かどうか。
 @param pictureInPictureController PiP コントローラー。
 @param isEnable 有効かどうか。
 */
- (void)pictureInPictureControllerIsPictureInPictureEnable:(nullable AVPictureInPictureController *)pictureInPictureController isEnable:(BOOL)isEnable;

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 色
 */
/****
 @brief 動画の背景色を設定します。
 @param color 色
 */
-(void) setVideoBackgroundColor:(UIColor *)color;

// パラメーターは 8 桁の 16 進数値です。8 桁は A（アルファ／透過度）、R（赤）、G（緑）、B（青）の順にペアでグループ化されます。
// 例：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 は ApsaraVideo Player 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 の有効期限切れおよび再生 URL の有効期限切れが含まれます。
 このコールバック内で VidAuth ソースを更新し、`callback` を介して新しい VidAuth ソースオブジェクトを送信することで、安定的かつスムーズな動画再生を保証できます。

 @param callback VidAuth ソースの有効期限切れ時にトリガーされるコールバックブロック。
 このコールバックを使用して、プレーヤーに有効な `VidAuth` オブジェクトを返すことができます。
 */
/****
 @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 ソースなど、更新ロジックを必要とするシナリオに適用されます。
 */
 /****
 @brief プレーヤーの再生ソースの更新結果を処理するためのプロトコルで、開発者が実装する必要があります。

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

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

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

 このメソッドは、更新操作が正常に完了したことを示します。開発者は、更新された `newSource` をプレーヤーに返す必要があります。
 これにより、プレーヤーは最新のリソースを読み込むことができます。
 */
 /****
 @brief 更新操作が成功した場合にプレーヤーから呼び出されます。
 
 @param newSource 更新された情報を含む新しい再生ソースオブジェクト。

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

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

 このメソッドは、更新操作が失敗したことを示します。開発者は `errorMsg` を使用して失敗の詳細を取得し、
 後続の処理を適切に行うことができます。
 */
 /****
 @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` オブジェクトを返すことができます。
 */
 /****
 @brief URL ソースの有効期限切れ通知のコールバックを設定します。

 このメソッドは、プレーヤーが現在の URL ソースの有効期限が切れたことを検出した場合にトリガーされます。
 このコールバック内で URL ソースを更新し、`callback` を介して更新された URL ソースを返すことで、
 中断のない動画再生を保証できます。

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

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

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

 @note このプロトコルは、URL ソース、VidAuth ソースなど、更新ロジックを必要とするシナリオに適用されます。
 */
 /****
 @brief プレーヤーの再生ソースの更新結果を処理するためのプロトコルで、開発者が実装する必要があります。

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

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

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

 このメソッドは、更新操作が正常に完了したことを示します。開発者は、更新された `newSource` をプレーヤーに返す必要があります。
 これにより、プレーヤーは最新のリソースを読み込むことができます。
 */
 /****
 @brief 更新操作が成功した場合にプレーヤーから呼び出されます。
 
 @param newSource 更新された情報を含む新しい再生ソースオブジェクト。

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

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

 このメソッドは、更新操作が失敗したことを示します。開発者は `errorMsg` を使用して失敗の詳細を取得し、
 後続の処理を適切に行うことができます。
 */
 /****
 @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);

    // デフォルト値の処理
    if (!scheme) scheme = @"http://";
    if (!path) path = @"/";

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

パフォーマンス

再生シナリオの設定

再生シナリオを設定すると、バッファ設定および機能トグルを含む最適なパラメーターが自動的に構成され、setConfig インターフェイスを通じて行ったカスタム設定（カスタム設定が優先されます）は維持されます。

API の例

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

再生シナリオ

typedef enum _AVPScene {
    /**
     * シナリオ：なし
     */
    /****
     * シナリオなし
     */
    SceneNone,
    /**
     * 長尺動画シナリオ：30 分を超える動画に適用
     */
    /****
     * 長尺動画シナリオ：30 分を超える動画に適用
     */
    SceneLong,
    /**
     * 中尺動画シナリオ：5～30 分の動画に適用
     */
    /****
     * 中尺動画シナリオ：5～30 分の動画に適用
     */
    SceneMedium,
    /**
     * 短尺動画シナリオ：5 分以内の動画に適用
     */
    /****
     * 短尺動画シナリオ：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：無効。デフォルトは無効です。
 * @param maxBufferMemoryKB: V5.4.7.1 以降で非推奨。効果はありません。
 * @param localCacheDir: 必須です。ローカルキャッシュファイルのディレクトリ。絶対パスを指定する必要があります。
 */
[AliPlayerGlobalSettings enableLocalCache:true maxBufferMemoryKB:1024 localCacheDir:@""];

/**
 @brief ローカルキャッシュファイルの自動クリア設定。
 @param expireMin: V5.4.7.1 以降で非推奨。効果はありません。
 @param maxCapacityMB: 最大キャッシュ容量（MB）。デフォルトは 20 GB です。クリーンアップ時、合計キャッシュ容量がこのサイズを超える場合、キャッシュアイテムの最終キャッシュ時刻に基づいて古いキャッシュファイルが順次削除され、容量が最大キャッシュ容量以下になるまで続けられます。
 @param freeStorageMB: 最小空きディスク領域（MB）。デフォルトは 0 です。クリーンアップ時、最大キャッシュ容量と同様に、現在のディスク空き領域がこの値より小さい場合、キャッシュファイルが同様のルールで順次削除され、空き領域がこの値以上になるか、すべてのキャッシュがクリアされるまで続けられます。
 */
[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（VideoId）。
   [vidAuthSource setPlayAuth:@"<yourPlayAuth>"]; // 必須。再生認証情報。ApsaraVideo VOD の GetVideoPlayAuth 操作を呼び出して生成する必要があります。
   [vidAuthSource setRegion:@"アクセスリージョン"]; // プレーヤー SDK V5.5.5.0 以降では、このパラメーターは非推奨です。リージョンを設定する必要はありません。プレーヤーが自動的にリージョンを解析します。プレーヤー SDK V5.5.5.0 より前のバージョンでは、このパラメーターは必須です。ApsaraVideo VOD のアクセスリージョン。デフォルトは cn-shanghai です。
   [vidAuthSource setQuality:@"選択された解像度"]; //"AUTO" はアダプティブビットレートを表します。

   VidSts

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

   UrlSource

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

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

   説明

   これはマルチビットレート動画にのみ適用されます。setDefaultBandWidth、setDefaultResolution、setDefaultQuality のいずれかを選択できます。

   AVPPreloadConfig *config = [[AVPPreloadConfig alloc]init];
   // マルチビットレートストリームのプリロードビットレートを設定します。
   [config setDefaultBandWidth:400000];
   // マルチビットレートストリームのプリロード解像度を設定します。
   [config setDefaultResolution:640 * 480];
   // マルチビットレートストリームのプリロード品質を設定します。
   [config setDefaultQuality:@"FD"];
   // プリロード期間を設定します。
   [config setDuration:1000];

4. タスクリスナーを追加します。

   コードを表示するには展開

   @interface YourViewController () <OnPreloadListener>
   
   @property(nonatomic,strong) AliMediaLoaderV2* vodMedialoader; // プリローダー
   @property(nonatomic,strong) AVPVidAuthSource* vidSource; // vidAuth データソース
   @property(nonatomic,strong) AVPUrlSource* urlSource; // url データソース
   @property(nonatomic,strong) AVPVidStsSource* vidStsSource; // vidSts データソース
   
   @end
   
   @implementation YourViewController
   
   - (void)onCompleted:(NSString *)taskId urlOrVid:(NSString *)urlOrVid {
       NSLog(@"現在のタスク (%@) が完了しました:%@", taskId,urlOrVid);
   }
   
   - (void)onError:(NSString *)taskId urlOrVid:(NSString *)urlOrVid errorModel:(AVPErrorModel *)errorModel {
       NSLog(@"例外が発生しました:%@", urlOrVid);
   }
   
   - (void)onCanceled:(NSString *)taskId urlOrVid:(NSString *)urlOrVid {
       NSLog(@"タスクがキャンセルされました:%@", urlOrVid);
   }
   
   @end

5. タスクをビルドし、MediaLoaderV2 インスタンスに追加して、プリロードを開始します。

   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. 任意: 読み込まれたファイルを削除します。

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

動的プリロード

動的プリロードポリシーにより、現在の動画のキャッシュおよびプリロードされるアイテム数を制御することで、再生体験とコストのバランスを取ることができます。

// 推奨構成と動的プリロードを有効化します。
[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）前後で動画のビットレートは一貫しており、初回フレームのパフォーマンスも考慮されます。
     */
    /****
     * 初回フレームとスムーズな再生。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] です。ポートは任意です。複数のドメインはセミコロン（;）で区切ります。
// グローバル設定。
// 完全なインターフェイスが設定されるたびに、現在の文字列が使用されます（追加する場合は追加、削除する場合は削除）。空の文字列は事前接続を停止します。
[AliPlayerGlobalSettings setOption:SET_PRE_CONNECT_DOMAIN value: @"domain1;domain2"];

動画ダウンロード

ApsaraVideo Player SDK for iOS は、ApsaraVideo VOD コンテンツの動画ダウンロード機能を提供しており、標準モードとセキュアモードがあります。

• 標準ダウンロード：ダウンロードされた動画は暗号化されておらず、サードパーティのプレーヤーで再生できます。

• セキュアダウンロード：ダウンロードされた動画は暗号化されており、ApsaraVideo Player でのみ再生できます。

注意事項

• この機能は VidSts および VidAuth ソース専用です。

• ApsaraVideo VOD コンソールでダウンロードモードを有効化および構成します。詳細については、「オフラインダウンロード」をご参照ください。

• 動画のダウンロードはブレークポイントから再開できます。

操作手順

1. 任意: セキュアダウンロード用の暗号化検証ファイルを構成します。このファイルはセキュアダウンロード専用です。標準ダウンロードでは不要です。

   説明

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

   セキュアダウンロードを使用する場合、ApsaraVideo VOD コンソールで生成されたキーファイルを Player SDK に構成します。このキーファイルは、ダウンロードおよび再生用の動画の復号および検証に使用されます。キーファイルの生成方法の詳細については、「セキュアダウンロードの有効化」をご参照ください。

   この構成はアプリケーションで一度だけ行う必要があります。以下に例を示します：

   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 メソッドを呼び出してダウンロードソースを準備します。サポートされているソースタイプには VidStsSource および VidAuthSource があります。以下に例を示します：

   • VidSts

     // VidSts を作成します。
     AVPVidStsSource* stsSource = [[AVPVidStsSource alloc] init];
     stsSource.region = @"アクセスリージョン"; // ApsaraVideo VOD のアクセスリージョン。デフォルトは cn-shanghai です。
     stsSource.vid = @"Vid 情報"; // 動画 ID（VideoId）。
     stsSource.securityToken = @"<yourSecurityToken>"; // STS セキュリティトークン。STS の AssumeRole 操作を呼び出して生成する必要があります。
     stsSource.accessKeySecret = @"<yourAccessKeySecret>"; // 一時的な STS AccessKey ペアの AccessKey Secret。STS の AssumeRole 操作を呼び出して生成する必要があります。
     stsSource.accessKeyId = @"<yourAccessKeyId>"; // 一時的な STS AccessKey ペアの AccessKey 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>"; // 再生認証情報。ApsaraVideo VOD の GetVideoPlayAuth 操作を呼び出して生成する必要があります。
     authSource.region = @"アクセスリージョン"; // プレーヤー SDK V5.5.5.0 以降では、このパラメーターは非推奨です。リージョンを設定する必要はありません。プレーヤーが自動的にリージョンを解析します。プレーヤー SDK V5.5.5.0 より前のバージョンでは、このパラメーターは必須です。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];

   説明

   ApsaraVideo VOD コンソールで HLS 暗号化のパラメーターパススルーを有効化する場合、デフォルトのパラメーターは MtsHIsUriToken です。詳細については、「HLS 暗号化のパラメーターパススルー」をご参照ください。その後、前述のコードに従って MtsHIsUriToken の値を ApsaraVideo 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 暗号化をサポートしています。手順については、「暗号化された動画の再生」をご参照ください。

ネイティブ RTS 再生

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

リファレンス

• API リファレンス

• エラーコード

• iOS プレーヤーのよくある質問