ドキュメントAnalyticsストリーミングメディアコレクションガイド

Chromecast でのエクスペリエンス品質の追跡 track-quality-of-experience-on-chromecast

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • ユーザー
  • 管理者
  • 開発者

以下の手順は、すべての 2.x SDK に共通する実装のガイダンスです。

IMPORTANT
1.x バージョンの SDK を実装する場合は、1.x の開発ガイドをこちら（SDK のダウンロード）からダウンロードできます。

概要 overview

Quality of Experience の追跡には、サービス品質（QoS）およびエラー追跡が含まれますが、どちらもオプションの要素で、コアメディアトラッキングの実装には​ 不要 ​です。メディアプレーヤー API を使用して、QoS とエラーの追跡に関連する変数を識別できます。

プレーヤーイベント player-events

すべてのビットレート変更イベント時

  • 再生の QoS オブジェクトインスタンス（qosObject）を作成または更新します
  • を呼び出します trackEvent(Media.Heartbeat.Event.BitrateChange, qosObject);

プレーヤーのエラー時

を呼び出します trackError("media error id");

実装方法 implement

  1. メディアの再生中にいつビットレートが変更されるかを識別し、QoS 情報を使用して MediaObject インスタンスを作成します。

    QoSObject 変数：

    note tip
    TIP
    これらの変数は、QoS を追跡する場合にのみ必要です。
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    変数 説明 必須
    bitrate 現在のビットレート ○
    startupTime 起動時間 ○
    fps FPS の値 ○
    droppedFrames ドロップフレームの数 ○

    QoS オブジェクトの作成：createQoSObject

    code language-none 
    qosInfo = ADBMobile.media.createQoSObject(50000, 0, 24, 10);

  2. 再生中にビットレートが切り替わったときに、メディアハートビートインスタンスで BitrateChange イベントを呼び出します（trackEvent）。

    code language-none 
    ADBMobile.media.trackEvent(ADBMobile.media.Event.BitrateChange);
    note important
    IMPORTANT
    ビットレートが変更されるたびに、QoS オブジェクトを更新し、ビットレート変更イベントを呼び出します。これにより、最も正確な QoS データを取得できます。

  3. getQoSObject() メソッドで、最新の QoS 情報が返されるようにします。

  4. メディアプレーヤーでエラーが生じ、エラーイベントをプレーヤー API で利用できる場合は、trackError() を使用してそのエラーの情報を取得します（の概要を参照）。

    note tip
    TIP
    メディアプレーヤーのエラーの追跡は、メディアトラッキングセッションを停止しません。メディアプレーヤーのエラーが再生の続行を妨げる場合、trackError() の呼び出しの後で trackSessionEnd() を呼び出すことで、メディアトラッキングセッションを確実に終了するようにしてください。
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb