すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo Live:SDK 品質モニタリング

最終更新日:Mar 07, 2026

ご利用のアプリケーションで ApsaraVideo Player SDK を使用してビデオを再生する場合、ライブストリーミング再生データサービスを利用して、アプリケーションの再生品質をモニタリングできます。このサービスは、ApsaraVideo Player SDK によってレポートされるイベントトラッキングデータに基づいて、再生成功率、初回再生速度、カクつき率などのメトリックを提供します。これらのメトリックにより、ライブストリーミング再生の品質を迅速に評価できます。このトピックでは、再生データの表示方法について説明します。

仕組み

ライブストリーミング再生データサービスは、ApsaraVideo Player SDK によってレポートされるイベントトラッキングデータに依存しています。次の図は、イベントトラッキングのロジックを示しています。

image.png

注意事項

  1. ApsaraVideo MediaBox SDK を使用しており、ライセンスが有効で、データレポートが有効になっていることを確認してください。

  2. Native player SDK バージョン 5.4.9.2 以降がサポートされています。

  3. Web player SDK バージョン 2.16.0 以降がサポートされています。

  4. Player SDK のダウンロードについては、「SDK の概要」をご参照ください。SDK ライセンスの管理については、「ライセンスの管理」をご参照ください。

再生データの表示

  1. ApsaraVideo Live コンソールにログインします。
  2. 左側のナビゲーションウィンドウで、データセンター > データモニタリング > SDK 品質モニタリングを選択します。

  3. [再生統計] タブで、アプリケーション名を選択し、[クエリ] をクリックします。

    説明

    アプリケーション名は、ApsaraVideo Player SDK ライセンスを申請した際に指定したタイトルと一致する必要があります。名前が一致しない場合、データは表示されません。

    次のディメンションでデータをフィルターできます。

    • クライアントタイプ、オペレーティングシステム、解像度、またはネットワークタイプでフィルターします。

    • 過去 1 時間から過去 3 日間までのカスタム時間範囲でデータをクエリできます。各クエリの期間は 24 時間を超えることや、複数日にまたがることはできません。

    • SDK バージョン、エンコード形式、ビデオフォーマット、ハードウェアデコーディング(はい/いいえ)、ISP、ドメイン名、または都道府県でフィルターを適用します。条件を追加するには、フィルター条件の追加 をクリックします。頻繁に使用する条件は、今後の利用のために保存できます。

  4. [アプリケーション概要] セクションには、サービス品質 (QoS) メトリックが表示されます。これらのメトリックは、ご利用のアプリケーションの再生品質を反映しています。次の表に、各メトリックの説明を示します。

    説明

    平均フレームレートのメトリックは、ビデオシナリオにのみ適用されます。他のすべてのメトリックは、オーディオとビデオ、またはオーディオのみのシナリオに適用されます。

    メトリック

    説明

    平均初回フレーム時間 (ミリ秒)

    再生リクエストの開始から最初のフレームがレンダリングされるまでの時間。

    カクつき率 (%)

    総再生時間に対する総カクつき時間の割合。計算式:カクつき時間 / 再生時間。

    平均フレームレート (fps)

    ライブストリーミング再生中にビデオフレームがレンダリングされるフレームレート。

    送信ビットレート (Kbps)

    ライブストリーミング再生中のアウトバウンドネットワーク転送レート。

    即時起動率 (%)

    1 秒以内に再生が開始されるライブストリームの割合。計算式:1 秒以内に開始されたライブストリーム数 / 再生されたライブストリーム総数。

    起動が遅い割合 (%)

    3 秒を超えてから再生が開始されるライブストリームの割合。計算式:3 秒以上で開始されたライブストリーム数 / 再生されたライブストリーム総数。

    再生成功率 (%)

    成功した再生試行の割合。計算式:成功した再生試行回数 / 総再生試行回数。

    CPU 使用率 (%)

    ライブストリーミング再生中の CPU 使用率。

シングルポイントトレース

ApsaraVideo Player SDK を使用したビデオ再生中にエラーが発生した場合、シングルポイントトレース機能を使用して、特定のユーザーまたは再生セッションの異常な動作をフルスタックで追跡できます。これにより、根本原因を迅速に診断し、再生体験を向上させることができます。

  1. ApsaraVideo Live コンソールにログインします。
  2. 左側のナビゲーションウィンドウで、データセンター > データモニタリング > SDK 品質モニタリングを選択します。

  3. [シングルポイントトレース] タブをクリックします。プレーヤーの作成時に提供された TraceID または UUID を入力します。

    image

  4. 操作列で 詳細の表示 をクリックして、再生セッションの詳細を表示できます。

関連ドキュメント

Player SDK