Stats for HLS Player

Stats Information

Statistics for an on-going stream can be viewed by user for debugging purposes. It can also be used as a standalone dependency if required and has no dependency on 100ms SDK.

Add dependency

Adding the Player-Stats plugin and SDK dependency to your app-level build.gradle.

settings.gradle


dependencies {
 // See the version in the badge above.
 // There are separate libraries for the sdk, virtual background and hls-player-stats.
 //     add just the ones you need.
 def hmsVersion = "x.x.x"
 implementation "live.100ms:android-sdk:$hmsVersion"
 implementation "live.100ms:hls-player-stats:$hmsVersion"
}

build.gradle


dependencies {
 def hmsVersion = "x.x.x"
 // See the version in the jitpack badge above.
 implementation "com.github.100mslive.android-sdk:lib:$hmsVersion"
 implementation "com.github.100mslive.android-sdk:stats:$hmsVersion"

}

Note

This Plugin supports Exoplayer versions 2.15.0 and above.

Instantiate PlayerEventsCollector

An Existing exoplayer instance can be directly attached to PlayerEventsCollector as follows :


            // an existing exoplayer instance
            val exoplayer : Exoplayer

            // this is an optional configuration provided while instantiated while creating the object, where
            // @param `eventRate` is the rate in milliseconds at which client wants to recieve the events.(default set to 2000 i.e 2 seconds)
            val initConfig = InitConfig(eventRate = 2000)

            playerEventsCollector = PlayerEventsCollector(exoplayer : exoplayer)


            // an existing exoplayer instance
            Exoplayer exoplayer;

            // this is an optional configuration provided while instantiated while creating the object, where
            // @param `eventRate` is the rate in milliseconds at which client wants to recieve the events.(default set to 2000 i.e 2 seconds)
            InitConfig initConfig = new InitConfig(2000);

            PlayerEventsCollector playerEventsCollector = PlayerEventsCollector(exoplayer,initConfig);

Listening to updates from PlayerEventsCollector

To start listeneing updates from the plugin , listener can be attached as follows :


           playerEventsCollector.addListener(object : PlayerEventsListener {
                override fun onEventUpdate(playerStats: PlayerStats) {
                    // playerStats object contains information for all the stats provided by the plugin.
                    // more information for this object is mentioned at the end of the document.
                }
            })


            playerEventsCollector.addListener(new PlayerEventsListener() {
                @Override
                public void onEventUpdate(@NonNull PlayerStats playerStats) {

                }
            });

To stop listeneing updates from the plugin , listener can be removed as follows :


            playerEventsCollector.removeListener()


            playerEventsCollector.removeListener();

Note

removeListener() must be called when view listening to it is destroyed

Interpretting the values :

Name	Description	Unit	Usage
bandwidthEstimate	The current bandwidth, as estimated by the player	bytes per second	Use this to show the current network speed of the user
bytesDownloaded	The total bytes downloaded within the given poll duration	Bytes	Use this to calculate the total Bytes downloaded in a session or to show the network activity
bitrate	bitrate of the current layer being played	bytes per second	Use to show a bitrate chart to the user
bufferedDuration	An estimate of the total buffered duration from the current position	ms	This can be used to show how much data is already buffered
video width	The width of the video	pixels	Used to know the resolution being played
video height	The height of the video	pixels	Used to know the resolution being played
video frameRate	The frame rate	frames per second	Used to know the FPS
droppedFrames	The number of dropped frames since the last call to this method	Int	Used to calculate the total number of dropped frames
distanceFromLiveEdge	Distance of current playing position from live edge	Int	Used to calculate how far current player position is from live edge of content.

Stats for WebRTC Pre-Call Diagnostics

Have a suggestion? Recommend changes ->