Chromecast でのエクスペリエンス品質の追跡 track-quality-of-experience-on-chromecast
以下の手順は、すべての 2.x SDK に共通する実装のガイダンスです。
IMPORTANT
1.x バージョンの SDK を実装する場合は、1.x の開発ガイドをこちら(SDK のダウンロード)からダウンロードできます。
概要 overview
Quality of Experience の追跡には、サービス品質(QoS)およびエラー追跡が含まれますが、どちらもオプションの要素で、コアメディアトラッキングの実装には 不要 です。メディアプレーヤー API を使用して、QoS とエラーの追跡に関連する変数を識別できます。
プレーヤーイベント player-events
すべてのビットレート変更イベント時
- 再生の QoS オブジェクトインスタンス(
qosObject
)を作成または更新します - を呼び出します
trackEvent(Media.Heartbeat.Event.BitrateChange, qosObject);
プレーヤーのエラー時
を呼び出します trackError("media error id");
実装方法 implement
-
メディアの再生中にいつビットレートが変更されるかを識別し、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 オブジェクトの作成:createQoSObject
code language-none qosInfo = ADBMobile.media.createQoSObject(50000, 0, 24, 10);
-
再生中にビットレートが切り替わったときに、メディアハートビートインスタンスで
BitrateChange
イベントを呼び出します(trackEvent)。code language-none ADBMobile.media.trackEvent(ADBMobile.media.Event.BitrateChange);
note important IMPORTANT ビットレートが変更されるたびに、QoS オブジェクトを更新し、ビットレート変更イベントを呼び出します。これにより、最も正確な QoS データを取得できます。 -
getQoSObject()
メソッドで、最新の QoS 情報が返されるようにします。 -
メディアプレーヤーでエラーが生じ、エラーイベントをプレーヤー API で利用できる場合は、
trackError()
を使用してそのエラーの情報を取得します(の概要を参照)。note tip TIP メディアプレーヤーのエラーの追跡は、メディアトラッキングセッションを停止しません。メディアプレーヤーのエラーが再生の続行を妨げる場合、 trackError()
の呼び出しの後でtrackSessionEnd()
を呼び出すことで、メディアトラッキングセッションを確実に終了するようにしてください。
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb