Client API for Web

Statistics API for Web

This article explains how to use Streamroot's Statistics API.

Streamroot instances are always exposed on the global namespace.

You can obtain the number of instances with the following window.Streamroot.instances.length.

But in general, when you have only one instance on your page, you can access the data using window.Streamroot.instances[0].

 

Example

When calling :

window.Streamroot.instances[0]

It returns :

{
    dnaDownloadAllowed: true,
    dnaDownloadEnabled: true, // Deprecated from DNA 2.4
    dnaDownloadOnCellularAllowed: null,
    dnaDownloadOnWifiEthernetAllowed: null,
    dnaUploadAllowed: true,
    dnaUploadEnabled: true, // Deprecated from DNA 2.4
    dnaUploadOnCellularAllowed: null,
    dnaUploadOnWifiEthernetAllowed: null,
    id: "123e4567-e89b-12d3-a456-426655440000",
    stats: {
      allContents: {
        cdnDownload: 23641258,
        dnaDownload: 45619783,
        dnaUpload: 36449517
      },
      currentContent: {
        cdnDownload: 23641258,
        dnaDownload: 45619783,
        dnaUpload: 36449517
      },
      realtime: {
        dnaSources: 8,
      },
    },
    transferStatus: {
      effectiveDownloadAllowed: true,
      effectiveUploadAllowed: true,
    },
    versions: {
      peerAgent:"5.4.2",
      streamrooter:"0.14.1",
      wrapper:"1.0.30"
    }
}

 

API table

NAME DESCRIPTION
dnaDownloadEnabled

Getter/Setter to switch DNA download ON or OFF.
Warning: deprecated in DNA 2.4
dnaUploadEnabled

Getter/Setter to switch DNA upload ON or OFF.
Warning: deprecated in DNA 2.4
dnaDownloadAllowed*

Getter/Setter to allow or not DNA download, regardless of the network type**.
dnaDownloadOnCellularAllowed*

Getter/Setter to allow or not DNA download.
This will be applied if the network type** is Cellular (i.e. 4G, 3G ..).
dnaDownloadOnWifiEthernetAllowed*

Getter/Setter to allow or not DNA download.
This will be applied if the network type** is Wi-Fi or Ethernet.
dnaUploadAllowed*

Getter/Setter to allow or not DNA upload, regardless of the network type**.
dnaUploadOnCellularAllowed*

Getter/Setter to allow or not DNA upload.
This will be applied if the network type** is Cellular (i.e. 4G, 3G ..).
dnaUploadOnWifiEthernetAllowed*

Getter/Setter to allow or not DNA upload.
This will be applied if the network type** is Wi-Fi or Ethernet.
id

Returns the ID of the Streamrooter running in the page.
You can set this ID in the dnaConfig when instantiating Streamroot’s module.
It will be automatically generated otherwise.
allContents (in Bytes)

Stats that describe the whole session (stats are aggregated over successive contents that have been played in case of a playlist).
currentContent (in Bytes)

Stats that describe the current content being played.
realtime.dnaSources

Returns the current number of peers connected to the client.
effectiveDownloadAllowed*

Return the effective state of download (allowed or not).
Depending on the Network type**, it will be calculated like so:
dnaDownloadAllowed AND dnaDownloadOnWifiEthernetAllowed (if you are on Wi-Fi for instance).
effectiveUploadAllowed*

Return the effective state of upload (allowed or not).
Depending on your Network type**, it will be calculated like so:
dnaUploadOnAllowed AND dnaUploadOnCellularAllowed (if you are on 4G for instance).
versions

List of all DNA components versions.

 

* To learn more about the Download and Upload setters, please see our dedicated documentation.

Related articles

In this article