以下の手順は、すべての 2.x SDK に共通する実装のガイダンスです。
1.x バージョンの SDK を実装する場合は、1.x の開発ガイドをこちら(SDK のダウンロード)からダウンロードできます。
メディアの再生中にいつビットレートが変更されるかを識別し、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>);
再生中にビットレートが切り替わったときに、メディアハートビートインスタンスで BitrateChange
イベントを呼び出します。
_onBitrateChange = function() {
this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject);
};
ビットレートが変更されるたびに、QoS オブジェクトを更新し、ビットレート変更イベントを呼び出します。これにより、最も正確な QoS データを取得できます。
getQoSObject()
メソッドで、最新の QoS 情報が返されるようにします。
メディアプレーヤーでエラーが生じ、エラーイベントをプレーヤー API で利用できる場合は、trackError()
を使用してそのエラーの情報を取得します(の概要を参照)。
メディアプレーヤーのエラーの追跡は、メディアトラッキングセッションを停止しません。メディアプレーヤーのエラーが再生の続行を妨げる場合、trackError()
の呼び出しの後で trackSessionEnd()
を呼び出すことで、メディアトラッキングセッションを確実に終了するようにしてください。