Audio and Subtitle Track Monitoring in the Debug Overlay

Stream Probe introduces audio and subtitle track monitoring in this update, unifying all track switch events into a single debug overlay timeline.

TL;DR

The debug overlay previously only showed ABR (video quality) switches. It now tracks audio track changes and subtitle track switches as well, displaying all three in one unified timeline so you can see exactly what the player was doing at any given moment.

What's New

• AudioTrackInfo model: captures audio track metadata for monitoring
• SubtitleTrackInfo model: captures subtitle track metadata for monitoring
• TrackSwitchEvent model: unifies video, audio, and subtitle switch events under a single data structure
• Unified switch timeline in the overlay: replaces the old ABR-only timeline with a combined view of all track switches
• Updated manifest models: DashManifestInfo and HlsManifestInfo now include audio and subtitle track data parsed from the manifest
• Refactored overlay UI components: ABR timeline components have been replaced with generic track switch timeline components

How to Use

No additional configuration is required. If you are already using the Stream Probe debug overlay, audio and subtitle track switches will appear automatically in the unified timeline alongside existing video quality switch events.

Track switch events are accessible via the TrackSwitchEvent model if you are consuming the data programmatically:

// TrackSwitchEvent covers all track types
switch event.trackType {
case .video:
    // ABR quality switch
case .audio:
    // Audio track change
case .subtitle:
    // Subtitle track change
}

FAQ

[ { "question": "Do I need to update my integration to see audio and subtitle track events?", "answer": "No. The unified timeline is automatic. If the debug overlay was already enabled, you will see audio and subtitle switches without any code changes." }, { "question": "Are both HLS and DASH streams supported for audio and subtitle track monitoring?", "answer": "Yes. Both HlsManifestInfo and DashManifestInfo have been updated to parse and expose audio and subtitle track data." }, { "question": "What happened to the old ABR switch timeline components?", "answer": "They have been refactored into unified track switch timeline components. The visual output is the same for video quality switches, with audio and subtitle switches added alongside them." }, { "question": "Can I access track switch events programmatically, not just in the overlay?", "answer": "Yes. The TrackSwitchEvent model is part of the SDK data layer and can be consumed directly in your own code alongside the overlay UI." } ]