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
 */
@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/business_needs_sample/alpha_channel/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 にマッピングするための辞書を維持する必要があります。
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 の最大ピクセル数を 921600 (1280 * 720) に設定します。これにより、プレーヤーはこの値以下のピクセル数の解像度にのみ切り替わるようになります。
[self.player setConfig:config];

スナップショット

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

プレビュー

ApsaraVideo Player SDK for iOS は、ApsaraVideo VOD と連携して設定した場合にプレビュー機能をサポートします。SDK は VidSts と VidAuth の両方の再生をサポートしています。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];
// 最大遅延時間 (ミリ秒)。注意：このパラメーターはライブストリーミング専用です。遅延が大きくなった場合、Player 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 の有効化

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

PiP デリゲートの設定

以下のコード例は、ピクチャーインピクチャー (PiP) ウィンドウとプレーヤーウィンドウ間の一般的なインタラクションを示します。 これらの例では、一時停止、再生、早送り、巻き戻しなどの再生コントロールの表示、および再生ロジックの実装について説明します。 デリゲートメソッドの完全なリファレンスについては、プレーヤー SDK デモの 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;
      // onPlayerStatusChanged:oldStatus:newStatus: コールバックによって更新される、プレーヤーの現在の再生ステータスを追跡します。
      @property (nonatomic, assign) AVPStatus currentPlayerStatus;
      // ピクチャーインピクチャーコントローラーへの弱い参照。これは pictureInPictureControllerWillStartPictureInPicture: コールバックで設定され、ビューコントローラーがデアロケートされる前に nil に設定する必要があります。弱い参照の使用を推奨します。
      @property (nonatomic, weak) AVPictureInPictureController *pipController;
      // 再生進行状況を追跡し、再生進行状況コールバックの 'position' パラメーターによって更新されます。
      @property (nonatomic, assign) int64_t currentPosition;
      
      @end

      説明

      pipController プロパティは、リテインサイクルを防ぐために weak または assign 属性で宣言する必要があります。assign を使用する場合は、適切なタイミングで手動でプロパティを nil に設定してください。

   2. onPlayerStatusChanged: デリゲートメソッドで、ピクチャーインピクチャーコントローラーに状態を更新するよう通知します。

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

   3. onPlayerEvent: デリゲートメソッドで、再生イベントに応じてピクチャーインピクチャーの状態を更新します。

      - (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. デリゲートメソッドを実装します。

      • ピクチャーインピクチャーが開始されようとしているときのコールバックを実装します。

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

      • ピクチャーインピクチャーが停止する前に UI を復元するためのコールバックを実装します。

        /**
         @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 再生が現在一時停止しているかどうかをデリゲートに問い合わせます。
         @param pictureInPictureController ピクチャーインピクチャーコントローラー。
         @return 再生が一時停止しているかどうかを示すブール値。
         */
        - (BOOL)pictureInPictureControllerIsPlaybackPaused:(nonnull AVPictureInPictureController *)pictureInPictureController{
            return self.isPipPaused;
        }

        説明

        このコールバックは、ピクチャーインピクチャーが開始される前に呼び出されます。PiP ウィンドウを起動するには、この時点で false を返す必要があります。true を返すと、ピクチャーインピクチャーは開始されません。

      • ピクチャーインピクチャーコントロールからの早送りおよび巻き戻しアクションを処理するコールバックを実装します。

        /**
         @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 (self.currentPlayerStatus == AVPStatusCompletion) {
                 [self.player seekToTime:0 seekMode:AVP_SEEKMODE_ACCURATE];
              }
        
              [self.player start];
              self.isPipPaused = NO;
          }
          [pictureInPictureController invalidatePlaybackState];
        }

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

ピクチャーインピクチャーはデフォルトでアプリ外です。アプリ内ピクチャーインピクチャーを実装するには、まず次のインターフェイスを呼び出してピクチャーインピクチャーがアクティブかどうかを確認します。

/**
 @brief ピクチャーインピクチャーが有効かどうかをデリゲートに伝えます。
 @param pictureInPictureController 状態を報告するピクチャーインピクチャーコントローラー。
 @param isEnable ピクチャーインピクチャーが有効な場合は `YES`、それ以外の場合は `NO`。
 */
- (void)pictureInPictureControllerIsPictureInPictureEnable:(nullable AVPictureInPictureController *)pictureInPictureController isEnable:(BOOL)isEnable;

自動起動を無効にし、ピクチャーインピクチャーの実行中に手動アクティベーションに切り替えるには、次のサンプルコードを使用します。

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

// パラメーターは ARGB 形式 (アルファ、赤、緑、青) の 8 桁の 16 進数値です。
// 例えば、0x0000ff00 は緑を表します。
[self.player setVideoBackgroundColor:0x0000ff00]

/**
 @brief ビデオ ID と再生認証情報 (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.example.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 または再生 URL の有効期限が切れると期限切れになります。
 このコールバックで VidAuth ソースをリフレッシュし、`callback` パラメーターを介して新しいオブジェクトを渡すことで、スムーズな再生を保証できます。

 @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]]) {
        AVPVidAuthSource *vidAuth = (AVPVidAuthSource *)expiredSource;

        // ------------------- ユーザー実装の開始 -------------------
        // カスタム関数を呼び出して、アプリサーバーから新しい PlayAuth を取得します。
        // clinetGetPlayAuthFunction はサンプル関数名です。実際の
        // 実装に置き換えてください。
        [self clinetGetPlayAuthFunction:vidAuth.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/en/vod/user-guide/configure-url-signing
 
 @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];

        // URL に "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 クラスメンバーが有効な場合はそれを使用します。
        NSString *key = (self.authKey.length > 0) ? self.authKey : @"";
        if (!NOT_EMPTY(key)) {
            [callback onError:@"REFRESH_ERROR:key fail"];
            return;
        }       
        
        // 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

// x.x.x はプレーヤー SDK のバージョンと一致する必要があります。
pod 'AliPlayerSDK_iOS_AUDIO_ENHANCE_FILTER', 'x.x.x'

[player setFilterValid:@"audioEnhance" valid:YES];  // 有効化
[player setFilterValid:@"audioEnhance" valid:NO];   // 無効化

AVPFilterConfig *filterConfig = [[AVPFilterConfig alloc] init];
AVPFilter *filterItem = [[AVPFilter alloc] initWithTarget:@"audioEnhance"];
AVPFilterOptions *opts = [[AVPFilterOptions alloc] init];
// サラウンドサウンド
[opts setOptions:@"enable_surround" value:@YES];
[opts setOptions:@"surround_effect_type" value:@"3DSurround"]; // サラウンドサウンドを初めて有効にするときにタイプを設定する必要があります。
// ダイアログエンハンスメント
[opts setOptions:@"enable_dialoguenhance" value:@YES];
[opts setOptions:@"dialoguenhance_voice" value:@(1.0)]; // 範囲：1.0 から 10.0。ダイアログエンハンスメントを初めて有効にするときに音声レベルを設定する必要があります。
// 音量ノーマライゼーション
[opts setOptions:@"enable_normalizer" value:@YES];

[filterItem setOptions:opts];
[filterConfig addFilter:filterItem];
[player setFilterConfig:filterConfig];

AVPFilterOptions *opts = [[AVPFilterOptions alloc] init];
[opts setOptions:@"enable_surround" value:@YES];
[opts setOptions:@"surround_effect_type" value:@"3DSurround"]; // タイプは、サラウンドサウンドを初めて有効にするときにのみ設定できます。フィルターはすでに初期化されているため、後続の呼び出しでは無視されます。
[player updateFilterConfig:@"audioEnhance" options:opts];

パフォーマンス

プレーヤーシーンの設定

プレーヤーシーンを設定すると、バッファ設定や機能の切り替えなど、そのシナリオに最適なパラメーターが自動的に適用されます。setConfig メソッドで設定したカスタムパラメーターは、シーンのデフォルトをオーバーライドします。

API の例

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

プレーヤーシーン

typedef enum _AVPScene {
    /**
     * 特定のシーンは設定されていません。
     */
    SceneNone,
    /**
     * 長編ビデオシーン。30 分以上のビデオに適しています。
     */
    SceneLong,
    /**
     * 中編ビデオシーン。5 分から 30 分のビデオに適しています。
     */
    SceneMedium,
    /**
     * 短編ビデオシーン。最大 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];

ローカルキャッシュ

Alibaba Cloud 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 最大キャッシュサイズ (MB)。デフォルト値：20 GB。クリーンアップ中に、合計キャッシュサイズがこの制限を超えた場合、合計サイズが制限内に収まるまで、最も古いキャッシュ項目が 1 つずつ削除されます。
 @param freeStorageMB 最小空きディスク領域 (MB)。デフォルト値：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。
// この URL のローカルキャッシュを有効にするには、この設定と AliPlayerGlobalSettings のグローバル設定の両方を有効にする必要があります。
// これを false に設定すると、この URL のローカルキャッシュは無効になります。
config.enableLocalCache = false;
....// その他の設定

// 構成をプレーヤーに適用します。
[self.player setConfig:config];

[AliPlayerGlobalSettings enableLocalCache:true];

プリロード

Alibaba Cloud Player SDK for iOS は、ローカルキャッシュの拡張機能であるプリロード機能を提供します。プリロードは、再生開始前にビデオの一部をキャッシュにダウンロードすることで、起動速度を向上させます。

[AliPlayerGlobalSettings enableNetworkBalance:false];

1. 「ローカルキャッシュ」で説明されているように、ローカルキャッシュ機能を有効にします。

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

   VidAuth (推奨)

   AVPVidAuthSource* vidAuthSource = [[AVPVidAuthSource alloc] init];
   [vidAuthSource setVid:@"your_video_id"]; // 必須。ビデオ ID。
   [vidAuthSource setPlayAuth:@"<yourPlayAuth>"]; // 必須。再生認証情報。ApsaraVideo for VOD の GetVideoPlayAuth オペレーションを呼び出して認証情報を生成する必要があります。
   [vidAuthSource setRegion:@"your_region"]; // このパラメーターは SDK v5.5.5.0 以降では非推奨です。プレーヤーはリージョンを自動的に解析します。以前のバージョンでは、このパラメーターは必須で、デフォルトは cn-shanghai です。
   [vidAuthSource setQuality:@"AUTO"]; // "AUTO" はアダプティブビットレートストリーミングを有効にします。

   VidSts

   AVPVidStsSource* vidStsSource = [[AVPVidStsSource alloc] init];
   [vidStsSource setVid: @"<your_video_id>"]; // 必須。ビデオ ID。
   [vidStsSource setRegion:@"<your_region>"]; // 必須。ApsaraVideo VOD が有効化されているリージョン。デフォルト値：cn-shanghai。
   [vidStsSource setSecurityToken: @"<yourSecurityToken>"]; // 必須。STS セキュリティトークン。STS の AssumeRole API オペレーションを呼び出してトークンを取得する必要があります。
   [vidStsSource setAccessKeySecret: @"<yourAccessKeySecret>"]; // 必須。一時的な STS AccessKey ペアの AccessKey Secret。STS の AssumeRole API オペレーションを呼び出して AccessKey Secret を取得する必要があります。
   [vidStsSource setAccessKeyId: @"<yourAccessKeyId>"]; // 必須。一時的な STS AccessKey ペアの AccessKey ID。STS の AssumeRole API オペレーションを呼び出して AccessKey ID を取得する必要があります。
   [vidStsSource setQuality:@"<your_video_quality>"]; // "AUTO" はアダプティブビットレートストリーミングを指定します。</your_video_quality></your_region></your_video_id>

   UrlSource

   NSString* url = @"your_playback_url"; // 必須。再生 URL。サードパーティの VOD URL または ApsaraVideo for 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; // UrlSource データソース。
   @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. 任意：ロードされたファイルの削除

   スペースを節約するために、キャッシュされたファイルを削除できます。Alibaba Cloud Player SDK for iOS は削除インターフェイスを提供していないため、アプリ内でキャッシュディレクトリから手動でファイルを削除する必要があります。

動的プリロード

動的プリロード戦略により、現在のビデオのキャッシュとプリロードするビデオの数を制御できます。これにより、再生体験とコストのバランスを取ることができます。

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

// ベースのプリロード時間を設定します。
// プリロード時間を 1,000 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,
    /**
     * 初回フレーム表示時間を優先します。プレーヤーは、プリロードが完了したビットレートから再生を開始します。
     */
    AVPMultiBitratesMode_FCPrio = 1,
    /**
     * 初回フレーム表示時間とスムーズな再生のバランスを取ります。プレーヤーは、`moveToNext` 呼び出しの前後で同じビットレートを再生しようとします。
     */
    AVPMultiBitratesMode_FC_AND_SMOOTH = 2,
    /**
     * スムーズな再生を優先します。プレーヤーは、前のビデオと同じビットレートで次のビデオを開始しようとします。
     */
    AVPMultiBitratesMode_SmoothPrio = 3,
} AVPMultiBitratesMode;

// マルチビットレート読み込みモードを選択します。
[self.listPlayer->SetMultiBitratesMode(preLoadMode)];

// 任意：起動ビットレートを選択します。
[self.listPlayer setDefaultBandWidth:defaultBandWidth];

// 任意：AVPEventPrepareDone の onPlayerEvent コールバックで、アダプティブビットレート (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 コンテンツをダウンロードしてオフライン再生できます。SDK は、標準ダウンロードとセキュアダウンロードの 2 つのダウンロードモードを提供します。

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

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

使用方法

• ビデオダウンロード機能は、VidSts および VidAuth ソースでのみ利用可能です。

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

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

操作手順

1. 任意：セキュアダウンロード用のキーファイルを設定します。この手順はセキュアダウンロードの場合にのみ必要です。

   説明

   設定されたキーファイルの情報がアプリの情報と一致していることを確認してください。そうでない場合、ビデオのダウンロードは失敗します。

   セキュアダウンロードモードを使用する場合、ApsaraVideo VOD コンソールで生成したキーファイルを ApsaraVideo 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 メソッドを呼び出してダウンロードソースを準備します。VidSts および VidAuth ソースがサポートされています。次のコードに例を示します。

   • VidSts

     // VidSts ソースを作成します。
     AVPVidStsSource* stsSource = [[AVPVidStsSource alloc] init];
     stsSource.region = @"your_region"; // ご利用の ApsaraVideo VOD サービスリージョン。デフォルト値：cn-shanghai。
     stsSource.vid = @"your_video_id"; // ビデオ ID。
     stsSource.securityToken = @"<yourSecurityToken>"; // STS セキュリティトークン。このトークンを取得するには、STS AssumeRole オペレーションを呼び出します。
     stsSource.accessKeySecret = @"<yourAccessKeySecret>"; // 一時的な STS 認証情報の AccessKey Secret。このシークレットを取得するには、STS AssumeRole オペレーションを呼び出します。
     stsSource.accessKeyId = @"<yourAccessKeyId>"; // 一時的な STS 認証情報の AccessKey ID。この ID を取得するには、STS AssumeRole オペレーションを呼び出します。
     
     // ApsaraVideo VOD コンソールで HLS 暗号化のパラメーターパススルーを有効にしている場合
     // かつ、デフォルトのパラメーター名が MtsHlsUriToken の場合は、config を設定して VidSts ソースに渡す必要があります。
     // この機能が有効でない場合は、次のコードをスキップできます。
     VidPlayerConfigGenerator* vp = [[VidPlayerConfigGenerator alloc] init];
     [vp setHlsUriToken:yourMtsHlsUriToken];
     stsSource.playConfig = [vp generatePlayerConfig];
     // ダウンロードソースを準備します。
     [downloader prepareWithVid:stsSource];

   • VidAuth

     // VidAuth ソースを作成します。
     AVPVidAuthSource *authSource = [[AVPVidAuthSource alloc] init];
     authSource.vid = @"your_video_id"; // ビデオ ID。
     authSource.playAuth = @"<yourPlayAuth>"; // 再生認証情報。この認証情報を取得するには、ApsaraVideo VOD GetVideoPlayAuth オペレーションを呼び出します。
     authSource.region = @"your_region"; // ApsaraVideo Player SDK V5.5.5.0 以降では非推奨です。プレーヤーがリージョンを自動的に解析するためです。
     // 以前のバージョンでは必須です。
     // ご利用の ApsaraVideo VOD サービスリージョン。デフォルト値：cn-shanghai。
     // ApsaraVideo VOD コンソールで HLS 暗号化のパラメーターパススルーを有効にしている場合
     // かつ、デフォルトのパラメーター名が MtsHlsUriToken の場合は、config を設定して VidAuth ソースに渡す必要があります。
     // この機能が有効でない場合は、次のコードをスキップできます。
     VidPlayerConfigGenerator* vp = [[VidPlayerConfigGenerator alloc] init];
     [vp setHlsUriToken:yourMtsHlsUriToken];
     authSource.playConfig = [vp generatePlayerConfig];
     // ダウンロードソースを準備します。
     [downloader prepareWithVid:authSource];

   説明

   ApsaraVideo VOD コンソールで HLS 暗号化のパラメーターパススルーを有効にし、デフォルトのパラメーター名が MtsHlsUriToken の場合は、上記のコードに示すようにダウンロードソースに MtsHlsUriToken の値を設定する必要があります。詳細については、「HLS 暗号化のパラメーターパススルー」をご参照ください。

5. ソース準備後のビデオトラックの選択

   ダウンロードソースの準備が完了すると、onPrepared メソッドが呼び出されます。コールバックの mediaInfo パラメーターには、ビデオ品質など、利用可能な各ビデオトラックに関する情報が含まれています。ダウンロードするトラックを選択します。次のコードに例を示します。

   -(void)onPrepared:(AliMediaDownloader *)downloader mediaInfo:(AVPMediaInfo *)info {
       NSArray<AVPTrackInfo*>* tracks = info.tracks;
       // 例えば、最初のトラックをダウンロードする場合：
       [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 再生

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

参考

• API リファレンス

• モバイルエラーコード

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