Roku での Quality of Experience の追跡

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

QoS の実装

1. メディアの再生中にいつビットレートが変更されるかを識別し、mediaUpdateQoS API を使用してメディア SDK の QoS 情報を更新します。

   QoSObject 変数：

   ヒント

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

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

   次に例を示します。

   bitrate = 200000
   fps = 0
   droppedFrames = 1
   startupTime = 2
   qosinfo = adb_media_init_qosinfo(bitrate, startupTime, fps, droppedFrames)
   
   ADBMobile().mediaUpdateQoS(qosinfo)
   

2. 再生中にビットレートが切り替わったときに、trackEvent(BitrateChange) を呼び出して、ビットレートが変更されたことをメディア SDK に通知します。

   ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_BITRATE_CHANGE)
   

   メモ

   更新されたビットレート値と共に updateQoSObject を呼び出す必要があります。

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

   ヒント

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