JavaScript 2.x を使用した QoE(Quality of Experience)の追跡 track-quality-of-experience-on-javascript
以下の手順は、すべての 2.x SDK に共通する実装のガイダンスです。
IMPORTANT
1.x バージョンの SDK を実装する場合は、1.x の開発ガイドをこちら(SDK のダウンロード)からダウンロードできます。
QOS の実装
-
メディアの再生中にいつビットレートが変更されるかを識別し、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 オブジェクトの作成:
code language-js // Replace <bitrate>, <startuptime>, <fps> and // <droppeFrames> with the current playback QoS values. var qosObject = MediaHeartbeat.createQoSObject(<bitrate>, <startuptime>, <fps>, <droppedFrames>);
-
再生中にビットレートが切り替わったときに、メディアハートビートインスタンスで
BitrateChange
イベントを呼び出します。code language-js _onBitrateChange = function() { this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject); };
note important IMPORTANT ビットレートが変更されるたびに、QoS オブジェクトを更新し、ビットレート変更イベントを呼び出します。これにより、最も正確な QoS データを取得できます。 -
getQoSObject()
メソッドで、最新の QoS 情報が返されるようにします。 -
メディアプレーヤーでエラーが生じ、エラーイベントをプレーヤー API で利用できる場合は、
trackError()
を使用してそのエラーの情報を取得します(の概要を参照)。note tip TIP メディアプレーヤーのエラーの追跡は、メディアトラッキングセッションを停止しません。メディアプレーヤーのエラーが再生の続行を妨げる場合、 trackError()
の呼び出しの後でtrackSessionEnd()
を呼び出すことで、メディアトラッキングセッションを確実に終了するようにしてください。
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb