JavaScript 2.x を使用した QoE(Quality of Experience)の追跡

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

重要

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

QoS の実装

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

    QoSObject 変数:

    ヒント

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

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

    QoS オブジェクトの作成:

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

    _onBitrateChange = function() {
        this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject);
    };
    
    重要

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

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

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

    ヒント

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

このページ