JavaScript 3.x を使用したエクスペリエンス品質の追跡

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

重要

以前のバージョンの SDK を実装している場合は、SDK のダウンロードから開発者ガイドをダウンロードできます。

QOE の実装

  1. メディア再生中のビットレートの変化を識別し、QoE 情報を使用して qoeObject インスタンスを作成します。

    QoEObject の変数:

    ヒント

    これらの変数は、QoS を追跡する場合にのみ必要です。

    変数 タイプ 説明
    bitrate 数値 現在のビットレート
    startupTime 数値 起動時間
    fps 数値 FPS の値
    droppedFrames 数値 ドロップフレームの数

    QoE オブジェクトの作成:

    // Replace <bitrate>, <startuptime>, <fps> and
    // <droppeFrames> with the current playback QoE values.
    var qoeObject = ADB.Media.createQoEObject(<bitrate>,
                                                   <startuptime>,
                                                   <fps>,
                                                   <droppedFrames>);
    tracker.updateQoEObject(qoeObject);
    
  2. 再生中にビットレートが切り替わったときに、メディアハートビートインスタンスで BitrateChange イベントを呼び出します。

    _onBitrateChange = function() {
        // If the new bitrate value is available provide it to the tracker.
        var qoeObject = ADB.Media.createQoEObject(1000000, 2.4, 25, 10);
        tracker.updateQoEObject(qoeObject);
    
        tracker.trackEvent(ADB.Media.Event.BitrateChange);
    };
    
    重要

    ビットレートが変更されるたびに、QoE オブジェクトを更新し、ビットレート変更イベントを呼び出します。 これにより、最も正確な QoE データを取得できます。

  3. 必ず updateQoEObject() メソッドを呼び出して、最新の QoE 情報を SDK に提供してください。

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

    ヒント

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

このページ