ApsaraVideo Live:RTS トレースID の取得

背景情報

ユーザーの IP アドレスや再生時間などの詳細情報を使用して再生の問題をトラブルシューティングするのは、非効率的な場合があります。この方法では、関連するエントリーを見つけるために膨大な量のログを検索する必要があり、同じユーザーが短期間に複数の再生セッションを持っている場合はさらに困難になります。リアルタイムストリーミング (RTS) は、再生試行ごとに TraceID を提供します。このグローバル一意識別子により、Alibaba Cloud は問題に関連する特定のセッションを迅速に特定できます。この TraceID をお客様自身のクライアントログと関連付けることを強く推奨します。

RTS トレースID は、以下の方法で取得できます。

• デモプレーヤーからの TraceID の取得

• 本番環境での TraceID の取得

デモプレーヤーからの TraceID の取得

モバイルクライアント (Android/iOS) のデモ

モバイルデモでストリームを再生する手順については、「デモチュートリアル」をご参照ください。プレーヤーがストリームに接続した後、プレーヤー画面の [トラブルシューティング] をクリックします。ポップアップウィンドウに表示される [RequestId] が TraceID です。

ポップアップウィンドウには [RequestId] とストリーミングの [URL] が表示されます。下部にある [コピー] をクリックしてこの情報をコピーし、トラブルシューティングのためにサポートチケットで送信できます。

Web クライアント (H5) のデモ

Web デモでストリームを再生する手順については、「デモチュートリアル」をご参照ください。プレーヤーがストリームに接続した後、RTS Web プレーヤーページの [トラブルシューティング] をクリックすると、ポップアップウィンドウに TraceID が表示されます。

ポップアップウィンドウには [URL] と [TraceID] のフィールドが含まれています。右下隅の [コピー] ボタンをクリックしてこの情報をコピーし、トラブルシューティングのためにサポートチケットで送信できます。

本番環境での TraceID の取得

本番環境とは、Alibaba Cloud のデモではなく、SDK が統合されたお客様自身のアプリケーションを指します。

モバイルクライアント (Android/iOS) の本番環境

ApsaraVideo Player SDK のイベントコールバックを使用して TraceID を取得します。

• Android

  // プレーヤーからの onInfo コールバックをリッスンし、DemuxerTraceID メッセージを解析します。
  mRtsAliPlayer.setOnInfoListener(infoBean -> {
      if (infoBean.getCode() == InfoCode.DemuxerTraceID) {
          String traceId = infoBean.getExtraMsg();
  });

• iOS

  // プレーヤーからの onPlayerEvent コールバックをリッスンし、DemuxerTraceID メッセージを解析します。
  - (void)onPlayerEvent:(AliPlayer*)player eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
      switch (eventWithString) {
          case EVENT_PLAYER_DEMUXER_TRACE_ID:
              {
                  NSString *traceId = description;
              }
                  break;
              default:
                  break;
      }
  }

Web クライアント (H5) の本番環境

• シグナリングリクエストのレスポンスから TraceID を取得する

  Web クライアントのシグナリングリクエストは HTTP POST リクエストです。ブラウザの開発者ツールの ネットワークのタイプ タブを使用して TraceID を見つけることができます。たとえば、ストリーミング URL が artc://player.alicdn.com/a/b_RTS の場合、対応するシグナリングリクエストは http(s)://player.alicdn.com/a/b_RTS です。

  1. RTS プレーヤー for Web にアクセスします。

  2. RTS プレーヤー for Web のページで、RTS が有効化されたストリームのストリーミング URL を入力します。例：artc://player.alicdn.com/a/b_RTS。

  3. [ストリーミング開始] をクリックして RTS ストリームを再生します。

  4. F12 キーを押してブラウザの開発者ツールを開き、[ネットワーク] タブを選択します。

  5. シグナリングリクエスト http(s)://player.alicdn.com/a/b_RTS を検索し、リクエストとレスポンス で TraceID を見つけます。

• ApsaraVideo Player SDK for Web

  ApsaraVideo Player SDK for Web では、rtsTraceId イベントをサブスクライブすることで RTS トレースID を取得できます。以下はコード例です。

  // このイベントは、RTS ストリームがプルされたときにトリガーされます。イベントデータには、traceId (ストリームのトレースID) と source (ストリーミング URL) が含まれます。
  player.on('rtsTraceId', function(event) {
      console.log('EVENT rtsTraceId', event.paramData);
  })