ApsaraVideo Live:RTS を使用した iOS 向けストリームフェッチングの実装

プレーヤーの作成

1. プレーヤーを作成します。

   AliPlayer インスタンスを作成します。

   // プレーヤーインスタンスを作成
   AliPlayer mAliPlayer = [[AliPlayer alloc] init];
   
   // 再生コンテンツの表示用ビュー コンテナーを作成し、プレーヤーのレンダリングビューを設定
   UIView *playerView = [[UIView alloc] initWithFrame:self.view.bounds];
   [self.view addSubview:playerView];
   mAliPlayer.playerView = playerView;
   
   [mAliPlayer setTraceID:traceId];

   説明

   プレーヤーは、再生品質モニタリング（全体的な再生品質に関するデータの表示）、単一点トレーシング（特定のユーザーまたはデバイスを特定し、その再生動作を分析して再生異常を迅速に特定）、および 動画再生統計 の機能を提供します。これらの機能はすべて、イベントトラッキングログ報告機能に依存しています。

   プレーヤー作成後に利用可能な機能は、setTraceID パラメーターの設定方法によって異なります。

   • setTraceID パラメーターを省略した場合（デフォルト）、イベントトラッキングログ報告機能が有効になります。再生品質モニタリングおよび動画再生統計機能は利用可能ですが、単一点トレーシング機能は利用できません。

   • setTraceID パラメーターにトレース ID を指定した場合：トレース ID の値は、ユーザーまたはユーザー端末を一意に識別するもの（たとえば、ビジネス上のユーザー ID や IMEI、IDFA などのデバイス ID）とする必要があります。トレース ID を指定すると、イベントトラッキングログ報告機能が有効になり、再生品質モニタリング、単一点トレーシング、動画再生統計の各機能を利用できます。

   • setTraceID パラメーターを DisableAnalytics に設定した場合：イベントトラッキングログ報告機能が無効になります。その後、再生品質モニタリング、単一点トレーシング、動画再生統計のいずれの機能も利用できなくなります。

2. 再生ソースを設定します。

   プレーヤーは VidSts、VidAuth、VidMps、UrlSource の 4 種類の再生ソースをサポートしています。このうち UrlSource は直接 URL による再生を可能にし、RTS サービスを利用するには URL を artc:// プロトコルに設定する必要があります。

   AVPUrlSource *urlSource = [[AVPUrlSource alloc] 
   urlWithString:@"artc://<streaming URL>"]; 
   [mAliPlayer setUrlSource:urlSource];

   説明

   再生ソースの設定について詳しくは、「基本機能」をご参照ください。

3. 再生パラメーターを構成します。

   再生パラメーターを構成して、RTS 効果を向上させます。

   説明

   バージョン 6.3.0 以降、プレーヤー SDK は自動最適低遅延構成をサポートしています。再生 URL が artc:// で始まり、かつ AVPConfig で MaxDelayTime、HighBufferDuration、StartBufferDuration の値を手動で変更していない場合、SDK は実際の再生時にそれぞれ 1000、10、10 の値を自動的に使用します。

   これらのパラメーターをカスタマイズする場合は、以下の例を参考にしてください。

   //1. 構成を取得して変更
   AVPConfig *config = mAliPlayer.getConfig;
   
   if ([playUrl hasPrefix:@"artc://"]) {
       // 最大遅延時間。単位：ミリ秒。この例では 1000（1 秒）に設定します。
       [config setMaxDelayTime:1000];
       // 再生開始時のバッファー期間。
       [config setStartBufferDuration:10];
       // バッファリング不足回復時のバッファー期間。
       [config setHighBufferDuration:10];
   } else {
       // デフォルト構成を使用するか、カスタム値を指定できます。
   }
   
   //2. 構成を適用
   [mAliPlayer setConfig:config];

4. 再生を開始します。

   // 再生の準備
   [mAliPlayer prepare];
   // prepare 後、start 操作を同期的に呼び出すことができます。onPrepared コールバックが完了すると、再生が自動的に開始されます。
   [mAliPlayer start];

再生の制御

ApsaraVideo Player SDK は、再生の開始や特定の時刻へのシークなど、一般的な再生制御をサポートしています。

 [mAliPlayer start];

[mAliPlayer stop];

// 同期的にプレーヤーを破棄。システムが自動的に stop メソッドを呼び出します。
[mAliPlayer destroy];
// 非同期的にプレーヤーを破棄。システムが自動的に stop メソッドを呼び出します。
[mAliPlayer destroyAsync];

補助機能の使用

1. ログ切り替え

   // ログを有効化
   [mAliPlayer setEnableLog:YES];
   [mAliPlayer setLogCallbackInfo:LOG_LEVEL_TRACE callbackBlock:nil];
   
   // ログを無効化
   [mAliPlayer setEnableLog:NO];
   [mAliPlayer setLogCallbackInfo:LOG_LEVEL_NONE callbackBlock:nil];

2. ライブストリーミング フォールバック

   説明

   • 再生失敗時のスペックダウンは、タイムアウトシナリオにのみ適用されます。タイムアウトが発生し、以下のいずれかのスペックダウンオプションが設定されている場合、プレーヤーは自動的にスペックダウンします。それ以外の場合は、onError コールバックがトリガーされます。HTTP 404、403 エラー、またはストリーマーの切断などのエラーは、スペックダウンをトリガーしません。

   • 自動 RTS スペックダウン は、同じドメインを使用して RTS から FLV へとスペックダウンします。RTS と FLV のドメインが異なる場合は、カスタム RTS スペックダウン を設定して、対象となる FLV ドメインを指定してください。

   1. 自動 RTS スペックダウン（デフォルトで有効）

      RTS ストリーミング URL の再生中にカスタムスペックダウンが設定されていない場合、RTS ストリームフェッチングが失敗すると、プレーヤーは RTS URL に関連付けられたデフォルトの FLV URL へ自動的にスペックダウンします。例：

      // 1 で有効、0 で無効。デフォルト値は有効（1）です。
      [AliPlayerGlobalSettings setOption:ALLOW_PRE_RENDER valueInt:1];

   2. カスタム RTS スペックダウン

      RTS ストリーミング URL の再生中に、HLS または FLV URL などのスペックダウン先 URL を指定します。RTS ストリームフェッチングが失敗した場合、プレーヤーは指定された URL から自動的に再生を開始します。

      // スペックダウン先の URL を指定
      AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:downgradeUrl];
      // （任意）その他の設定を構成
      AVPConfig *config = [mAliPlayer getConfig];
      // スペックダウン後のストリーミング URL を指定
      [mAliPlayer enableDowngrade:urlSource config:config];

3. トレース ID の取得

   各低遅延再生ではトレース ID が生成され、トラブルシューティングに使用できます。トレース ID はプレーヤーのイベントコールバックから取得します。

   // onPlayerEvent コールバックをリッスンし、DemuxerTraceID メッセージを解析
   - (void)onPlayerEvent:(AliPlayer*)mAliPlayer eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
       switch (eventWithString) {
           case EVENT_PLAYER_DEMUXER_TRACE_ID:
               {
                   NSString *traceId = description;
               }
                   break;
               default:
                   break;
       }
   }