Articles in this section

Debug tools for Android

StatsView

On top of the stats API exposed by the SDK, we created a view helper to help you integrate and understand Streamroot DNA™ faster. The StatsView will inform you about the different states of the SDK lifecycle and Streamroot metrics.

The view looks like the following:


Screenshot_2017-12-22-09-31-07.png

 

Adding a StatsView is really simple.

First, you will need to add the following Streamroot dependency to the build.gradle file of your app module.

implementation 'io.streamroot.dna:dna-utils:3.0.0'

Then, you will need to update your layout to include the following snippet:

<io.streamroot.dna.utils.stats.StatsView
    android:id="@+id/streamroot_stats"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

Finally, initialize a StreamStatsManager and give it the instance of the SDK you previously instantiated:

Java:

StatsView statsView = findViewById(R.id.streamroot_stats);
StatsViewManager statsManager = StreamStatsManager.newStatsManager(<StreamrootSDK>, statsView);
statsManager.start();

 

At the same time you close the Streamroot SDK, close as well the StatsManager.

statsManager.stop();

 

Fetching stats

Knowing how much peers are connected to you and how much offload a single SDK instance is performing while you are integrating the SDK could be useful. It could as well be used to send data to third parties analytics.

The SDK exposes a fetchStats method which could be used like the following on an initialized SDK instance:

dnaClient.fetchStats(new InformationCallback() {
    @Override
    public void onStats(State state, long cdn, long dna, long upload, int peers) {
        // Process the stats here
    }
});

With the Java 8 lambda feature, it is even more simple:

dnaClient.fetchStats((state, cdn, dna, upload, peer) -> {
    // Process the stats here
});

  • cdn: Traffic downloaded from the CDN (cumulated bytes).
  • dna: Traffic downloaded from the DNA network (cumulated bytes).
  • upload: Traffic uploaded to the DNA network (cumulated bytes).
  • peers: Real time connected peers count.
  • stat: Current SDK status

 

 

Related articles