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

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

最終更新日:Feb 19, 2025

ApsaraVideo Player SDKを使用してアプリケーションでビデオを再生する場合、再生統計に基づいてアプリケーションの再生品質を監視できます。 再生品質モニタリング機能は、ApsaraVideo Player SDKから収集されたイベント追跡データに基づいて実装されます。 この機能を使用して、失敗率、インスタントスタートアップ率、吃音率などの再生品質指標を表示できます。 このトピックでは、再生データを表示する方法について説明します。

仕組み

再生データは、ApsaraVideo Player SDKに埋め込まれたイベント追跡ポイントに基づいて収集されます。 次の図は、再生ワークフローのイベント追跡ポイントを示しています。

image.png

使用上の注意

  1. ApsaraVideo MediaBox SDKを使用する必要があります。 ライセンスが有効で、ログレポート機能が有効になっていることを確認します。

  2. ネイティブRTS SDK V5.4.9.2以降がサポートされています。

  3. ApsaraVideo Player SDK for Web V2.16.0以降がサポートされています。

  4. ApsaraVideo Player SDKのダウンロード方法の詳細については、「SDKの概要とダウンロード」をご参照ください。 SDKライセンスを申請する方法の詳細については、「ライセンスの管理」をご参照ください。

再生データの表示

  1. ApsaraVideo Live コンソール にログインします。

  2. 左側のナビゲーションウィンドウで、[データセンター] > [モニタリング] > [SDK品質モニタリング] を選択します。

  3. [再生統計] タブで、ドロップダウンリストからアプリケーションを選択し、[クエリ] をクリックしてデータを表示します。

    説明

    アプリケーション名は、ApsaraVideo Player SDKライセンスを申請するアプリケーションの名前である必要があります。 無効なアプリケーション名を入力した場合、データは返されません。

    次の条件に基づいてデータをフィルタリングできます。

    • クライアントタイプ、システムタイプ、解像度、およびネットワークタイプに基づいてデータをフィルタリングできます。

    • 過去3日間のデータをクエリできます。 各クエリのカスタム時間範囲は24時間未満である必要があります。

    • SDKのバージョン、エンコード形式、ビデオ形式、デコード方法 (ソフトウェアデコードまたはハードウェアデコード) 、インターネットサービスプロバイダー (ISP) 、ドメイン名、および省に基づいてデータをフィルタリングできます。 [新しいフィルター条件] をクリックしてカスタム条件を作成し、後で使用するために保存します。

  4. [再生統計] タブで、次のサービス品質 (QoS) メトリクスを表示します。 QoSメトリックは、アプリケーションの再生品質を反映します。

    説明

    平均フレームレート指標は、ビデオシナリオでのみ使用できます。 その他のメトリックは、オーディオとビデオ、またはオーディオのみのシナリオで使用できます。

    メトリクス

    説明

    最初のフレームの平均持続時間 (ミリ秒)

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

    吃音率 (%)

    合計再生時間に対するスタッタリングが発生する合計時間の割合。

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

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

    送信ビットレート (Kbps)

    再生中のアウトバウンドネットワーク伝送速度。

    インスタント起動率 (%)

    1秒以内に再生を開始するライブストリームの割合。 これは、1秒以内に再生を開始するライブストリームの数を、再生されるすべてのライブストリームの数で割ったものに等しい。

    遅いスタートアップ率 (%)

    3秒後に再生を開始するライブストリームの割合。 これは、3秒後に再生を開始するライブストリームの数を、再生されるすべてのライブストリームの数で割ったものに等しくなります。

    再生成功率 (%)

    再生の成功率。 計算式: 再生成功 /すべての再生。

    CPU使用率 (%)

    再生中のCPU使用率。

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

ApsaraVideo Player SDKでエラーが発生した場合、シングルポイントトレース機能を使用して、セッションおよびユーザーレベルで再生の詳細を照会し、すべてのリンクで再生の例外をトレースできます。 これにより、トラブルシューティングの効率と視聴者エクスペリエンスが向上します。

  1. ApsaraVideo Live コンソール にログインします。

  2. 左側のナビゲーションウィンドウで、[データセンター] > [モニタリング] > [SDK品質モニタリング] を選択します。

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

    image

  4. 再生セッションの [操作] 列の [詳細の表示] をクリックして、データを表示します。

関連ドキュメント

ApsaraVideo Player SDK