Track quality of experience on Roku

The following instructions provide guidance for implementation across all 2.x SDKs.

Implemement QOS

1. Identify when the bitrate changes during media playback, and use the mediaUpdateQoS API to update the QoS info on the Media SDK.

   QoSObject variables:

   TIP

   These variables are only required if you are tracking QoS.

   Variable	Description	Required
   bitrate	Current bitrate	Yes
   startupTime	Startup time	Yes
   fps	FPS value	Yes
   droppedFrames	Number of dropped frames	Yes

   For example:

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

2. When playback switches bitrates, call trackEvent(BitrateChange) to notify the Media SDK that the Bitrate changed.

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

   NOTE

   You need to call updateQoSObject with the updated bitrate value.

3. When the media player encounters an error, and the error event is available to the player API, use trackError() to capture the error information. (See Overview.)

   TIP

   Tracking media player errors will not stop the media tracking session. If the media player error prevents the playback from continuing, make sure that the media tracking session is closed by calling trackSessionEnd() after calling trackError().