The following instructions provide guidance for implementation across all 2.x SDKs.
If you are implementing a 1.x version of the SDK, you can download the 1.x Developers Guides here: Download SDKs.
Identify when the bitrate changes during media playback and create the MediaObject
instance using the QoS information.
QoSObject variables:
Variable | Description | Required |
---|---|---|
bitrate |
Current bitrate | Yes |
startupTime |
Startup time | Yes |
fps |
FPS value | Yes |
droppedFrames |
Number of dropped frames | Yes |
These variables are only required if you are planning to track QoS.
QoS object creation:
id qosObject = [ADBMediaHeartbeat createQoSObjectWithBitrate:[BITRATE]
startupTime:[STARTUP_TIME]
fps:[FPS]
droppedFrames:[DROPPED_FRAMES]];
Make sure that getQoSObject
method returns the most updated QoS information.
When playback switches bitrates, call the BitrateChange
event in the Media Heartbeat instance:
- (void)onBitrateChange:(NSNotification *)notification {
[_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventBitrateChange
mediaObject:nil
data:nil];
}
Update the QoS object and call the bitrate change event on every bitrate change. This provides the most accurate QoS data.