ApsaraVideo Live:iOS で RTS ストリームフェッチングを実装

プレーヤーの作成

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 パラメーターに `traceid` を渡す場合：`traceid` の値はユーザーまたはユーザーデバイスの一意の識別子である必要があります (ビジネスの `userid` や、International Mobile Equipment Identity (IMEI) または identifier for advertisers (IDFA) などのデバイス ID など)。`traceid` を渡すと、イベントトラッキングログレポート機能が有効になります。その後、再生品質モニタリング、シングルポイントトラッキング、およびビデオ再生統計機能を使用できます。

   • setTraceID パラメーターを DisableAnalytics に設定する場合：イベントトラッキングログレポート機能が無効になります。再生品質モニタリング、シングルポイントトラッキング、およびビデオ再生統計機能は利用できません。

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

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

   AVPUrlSource *urlSource = [[AVPUrlSource alloc] 
   urlWithString:"artc://<ストリーミング URL>"]; 
   [mAliPlayer setUrlSource:urlSource];

   説明

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

3. 再生パラメーターを設定します。

   再生パラメーターを構成して、RTS のパフォーマンスを向上させます。

   説明

   ApsaraVideo Player SDK V6.3.0 以降は、最適な低レイテンシーのための自動構成をサポートしています。再生 URL が `artc://` で始まり、かつ AVPConfig の MaxDelayTime、HighBufferDuration、または StartBufferDuration の値を手動で変更していない場合、SDK は再生中にこれらのパラメーターに自動的に 1000、10、10 を使用します。

   コントロールをカスタマイズするには、次の例をご参照ください:

   // 1. 構成を取得して変更します。
   AVPConfig *config = mAliPlayer.getConfig;
   
   if ([playUrl hasPrefix:@"artc://"]) {
       // 最大ストリーム遅延は 1000 ms です。
       [config setMaxDelayTime:1000];
       // 再生開始時のバッファー時間。
       [config setStartBufferDuration:10];
       // カクつきから回復するためのバッファー時間。
       [config setHighBufferDuration:10];
   } else {
       // config にはデフォルトまたはカスタムの構成を使用します。
   }
   
   // 2. 構成を適用します。
   [mAliPlayer setConfig:config];

4. 再生を開始します。

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

再生のコントロール

ApsaraVideo Player SDK for iOS は、主要な再生コントロール操作をサポートしています。

 [mAliPlayer start];

[mAliPlayer stop];

// 同期的な破棄。stop API は内部で自動的に呼び出されます。
[mAliPlayer destroy];
// 非同期的な破棄。stop API は内部で自動的に呼び出されます。
[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` コールバックがトリガーされます。404、403、またはストリーマーの切断などの例外では、スペックダウンはトリガーされません。

   • 自動 RTS スペックダウンは、同じドメイン名を使用して RTS から FLV にスペックダウンします。RTS と FLV のドメイン名が異なる場合は、カスタム RTS スペックダウンソリューションを構成して、ターゲットの FLV ドメイン名を指定する必要があります。

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

      RTS URL からストリームを再生するとき、カスタム RTS スペックダウンが構成されておらず、RTS ストリームフェッチングが失敗した場合、プレーヤーは自動的に対応するデフォルトの FLV URL にスペックダウンして再生します。次のコードに例を示します：

      // 1: 有効。0: 無効。この機能はデフォルトで有効です。
      [AliPlayerGlobalSettings setOption:ALLOW_PRE_RENDER valueInt:1];

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

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

      // スペックダウンソース downgradeUrl を設定します。
      AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:downgradeUrl];
      // オプション。config の他の項目を構成します。
      AVPConfig *config = [mAliPlayer getConfig];
      // スペックダウン URL を設定します。
      [mAliPlayer enableDowngrade:urlSource config:config];

3. TraceID の取得

   各 RTS 再生セッションには、トラブルシューティングに使用できる `traceId` があります。`traceId` はプレーヤーイベントコールバックから取得できます。

   // プレーヤーの 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;
       }
   }