Show Menu
TOPICS×

Chromecast での Quality of Experience の追跡

以下の手順は、すべての 2.x SDK に共通する実装のガイダンスです。1.x バージョンの SDK を実装する場合は、1.x の開発ガイドをこちら( SDK のダウンロード )からダウンロードできます。

概要

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

プレーヤーイベント

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

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

プレーヤーのエラー時

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

実装方法

  1. メディアの再生中にいつビットレートが変更されるかを識別し、QoS 情報を使用して
    MediaObject
    インスタンスを作成します。
    QoSObject 変数:
    これらの変数は、QoS を追跡する場合にのみ必要です。
    変数
    説明
    必須
    bitrate
    現在のビットレート
    startupTime
    起動時間
    fps
    FPS の値
    droppedFrames
    ドロップフレームの数
    QoS オブジェクトの作成:
    createQoSObject
    qosInfo = ADBMobile.media.createQoSObject(50000, 0, 24, 10);
  2. 再生中にビットレートが切り替わったときに、メディアハートビートインスタンスで
    BitrateChange
    イベントを呼び出します( trackEvent )。
    ADBMobile.media.trackEvent(ADBMobile.media.Event.BitrateChange);
    ビットレートが変更されるたびに、QoS オブジェクトを更新し、ビットレート変更イベントを呼び出します。これにより、最も正確な QoS データを取得できます。
  3. getQoSObject()
    メソッドで、最新の QoS 情報が返されるようにします。
  4. メディアプレーヤーでエラーが生じ、エラーイベントをプレーヤー API で利用できる場合は、
    trackError()
    を使用してそのエラーの情報を取得します( の概要 を参照)。
    メディアプレーヤーのエラーの追跡は、メディアトラッキングセッションを停止しません。メディアプレーヤーのエラーが再生の続行を妨げる場合、
    trackError()
    の呼び出しの後で
    trackSessionEnd()
    を呼び出すことで、メディアトラッキングセッションを確実に終了するようにしてください。