DocumentationAnalyticsStreaming Media Collection Guide

Track quality of experience on iOS

Last update: June 25, 2024
  • Topics:
  • Media Analytics

CREATED FOR:

  • User
  • Admin
  • Developer

The following instructions provide guidance for implementation across all 2.x SDKs.

IMPORTANT
If you are implementing a 1.x version of the SDK, you can download the 1.x Developers Guides here: Download SDKs.

Implement QOS

  1. Identify when the bitrate changes during media playback and create the MediaObject instance using the QoS information.

    QoSObject variables:

    VariableDescriptionRequired
    bitrateCurrent bitrateYes
    startupTimeStartup timeYes
    fpsFPS valueYes
    droppedFramesNumber of dropped framesYes
    TIP
    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]];

  2. Make sure that getQoSObject method returns the most updated QoS information.

  3. When playback switches bitrates, call the BitrateChange event in the Media Heartbeat instance:

    - (void)onBitrateChange:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventBitrateChange
                     mediaObject:nil
                     data:nil];
}
    IMPORTANT
    Update the QoS object and call the bitrate change event on every bitrate change. This provides the most accurate QoS data.
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb