ApsaraVideo Live:RTS TraceID の取得

背景情報

ユーザーの IP アドレスや再生時間などの情報を使用して再生の問題をトラブルシューティングすることは非効率的です。この方法では、大量のログを検索する必要があり、単一の IP アドレスで同じ期間に複数の再生セッションがある場合、その難易度は高まります。リアルタイムストリーミング (RTS) は TraceID ソリューションを提供します。RTS TraceID は、各再生セッションのグローバル一意の識別子です。この識別子は、Alibaba Cloud が問題を迅速に特定するのに役立ちます。RTS TraceID をご利用のクライアントログと関連付けることを強く推奨します。

RTS TraceID は、以下の方法で取得できます。

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

• 本番環境での RTS TraceID の取得

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

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

モバイルクライアントデモを使用したストリームの再生の詳細については、「デモの実行」をご参照ください。再生リクエストが確立された後、RTS モバイルプレーヤーページで [トラブルシューティング] をクリックします。表示されるダイアログボックスで、[RequestId] の値が TraceID です。

Web クライアント (H5)

Web クライアントデモを使用したストリームの再生の詳細については、「デモの実行」をご参照ください。再生リクエストが確立された後、RTS Web プレーヤーページで [トラブルシューティング] をクリックすると、表示されるダイアログボックスで TraceID を確認できます。

本番環境での取得

本番環境とは、SDK をご利用のアプリケーションに統合しており、Alibaba Cloud のデモを使用していない環境を指します。

モバイルクライアント (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 の取得

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

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

  2. RTS Web プレーヤーページで、リアルタイムストリーミングが有効になっているストリーミング URL (例: artc://player.alicdn.com/a/b_RTS) を入力します。

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

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

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

• Web 用 ApsaraVideo Player SDK

  Web 用 ApsaraVideo Player SDK を使用すると、rtsTraceId イベントを購読することで RTS TraceID を取得できます。サンプルコード:

  // このイベントは、RTS ストリームが正常にプルされたときにトリガーされます。コールバック関数では、traceId パラメーターはストリームの TraceID であり、source パラメーターは現在の RTS ストリームのストリーミング URL です。
  player.on('rtsTraceId', function(event) {
      console.log('EVENT rtsTraceId', event.paramData);
  })