Quality of service (QoS) offers a detailed view into how the video engine is performing. TVSDK provides detailed statistics about playback, buffering, and devices.
TVSDK also provides information about the following downloaded resources:
You can read quality of service (QoS) information about downloaded resources, such as fragments and tracks, from the LoadInformation class.
Implement the onLoadInformationAvailable
callback event listener.
private function onLoadInformationAvailable(event:LoadInformationEvent):void {
var loadInformation:LoadInformation = event.loadInformation;
// process the load information here
}
Register the event listener, which TVSDK calls every time a fragment has downloaded.
player.addEventListener(LoadInformationEvent.LOAD_INFORMATION_AVAILABLE,
onLoadInformationAvailable);
Read the data of interest from the LoadInformation
that is passed to the callback.
Property | Type | Description |
---|---|---|
downloadDuration | Number |
The duration of the download in milliseconds. TVSDK does not differentiate between the time it took the client to connect to the server and the time it took to download the full fragment. For example, if a 10 MB segment takes 8 seconds to download, TVSDK provides that information, but does not tell you that it took 4 seconds until the first byte and another 4 seconds to download the entire fragment. |
mediaDuration | Number |
The media duration of the downloaded fragments in milliseconds. |
size | Number |
The size of the downloaded resource in bytes. |
trackIndex | int |
The index of the corresponding track, if known; otherwise, 0. |
trackName | String |
The name of the corresponding track, if known; otherwise, null. |
trackType | String |
The type of the corresponding track, if known; otherwise, null. |
type | String |
What TVSDK downloaded. One of the following:
|
url | String |
The URL that points to the downloaded resource. |
You can read playback, buffering, and device statistics from the QOSProvider class.
The QOSProvider
class provides various statistics, including information about buffering, bit rates, frame rates, time data, and so on.
It also provides information about the device, such as the manufacturer, model, operating system, SDK version, and screen size/density.
Instantiate a media player.
Create a QOSProvider
object and attach it to the media player.
// Create Media Player.
_mediaQosProvider = new QOSProvider;
_mediaQosProvider.attachMediaPlayer(_mediaPlayer);
(Optional) Read the playback statistics.
One solution to read playback statistics is to have a timer, that periodically fetches the new QoS values from the QOSProvider
. For example:
var qosTimer:Timer = new Timer(1000); // every 1 second
qosTimer.addEventListener(TimerEvent.Timer, onQoSTimer);
qosTimer.start();
private function onQoSTimer(event:TimerEvent):void {
var playbackInformation:PlaybackInformation = _mediaQosProvider.getPlaybackInformation();
qosInfo["Frame rate"] = playbackInformation.frameRate.toFixed();
qosInfo["Dropped frames"] = playbackInformation.droppedFrameCount.toFixed();
qosInfo["Bitrate"] = playbackInformation.bitrate.toFixed();
qosInfo["Bandwidth"] = playbackInformation.perceivedBandwidth;
qosInfo["Buffering time"] = playbackInformation.bufferingTime.toFixed();
qosInfo["Buffer length"] = playbackInformation.bufferLength.toFixed();
qosInfo["Buffer time"] = playbackInformation.bufferTime.toFixed();
qosInfo["Empty buffer count"] = playbackInformation.emptyBufferCount.toFixed();
qosInfo["Time to load"] = playbackInformation.timeToLoad.toFixed();
qosInfo["Time to start"] = playbackInformation.timeToStart.toFixed();
qosView.update(qosInfo);
}
(Optional) Read the device-specific information.
// Show device information
var deviceInfo:DeviceInformation = new QOSProvider.deviceInformation;
qosInfo["deviceModel"] = deviceInfo.manufacturer +"-" + deviceInfo.model;
qosInfo["os"] = deviceInfo.os;
qosInfo["runtime"] = deviceInfo.runtimeVersion;
qosInfo["widthPixels"] = deviceInfo.widthPixels;
qosInfo["heightPixels"] = deviceInfo.heightPixels;
qosView.update(qosInfo);