Skip to main content

Track Selection

You can select and manage different track types and video resolutions for your playback. This guide shows you how to list available tracks, get active tracks, set tracks, and select video resolutions for your player

Track types​

Each playback can have four types of tracks: AUDIO, VIDEO, CLOSED CAPTION, and SUBTITLE. These different track types are denoted using MediaTrack.trackType.

public enum MediaTrackType {
/// Audio
case audio
/// Closed Caption
case closedCaption
/// Subtitle
case subtitle
/// Video
case video
}

List available tracks​

You can obtain all the available tracks of each type using the tracks(for:) API on the player. This API returns an Array of MediaTrack objects.

// get all video tracks
var availableVideoTracks = player.tracks(for: .video)

//get all audio tracks
var availableAudioTracks = player.tracks(for: .audio)

//get all closedCaption tracks
var availableClosedCaptionTracks = player.tracks(for: .closedCaption)

//get all subtitle tracks
var availableSubtitleTracks = player.tracks(for: .subtitle)

Get active track​

You can obtain the currently active track in each type from the Player using the selectedTrack(for:) API. This API returns the active track of any given MediaTrack.

///get active subtitles of tracks
var activeSubtitleTrack = player.selectedTrack(for: .subtitle)

///get active audio
var activeAudioTrack = player.selectedTrack(for: .audio)

///get active video
var activeVideoTrack = player.selectedTrack(for: .video)

///get active closedCaption
var activeCCTrack = player.selectedTrack(for: .closedCaption)

Set a track​

From the list of available tracks for AUDIO, VIDEO, CLOSED CAPTION, and SUBTITLE, you can choose any track and select it using the selectTrack(for:) API.

To unselect a track, pass nil to the selectTrack(for:) API.

player?.selectTrack(selectedTrack, for: .audio)
player?.selectTrack(selectedTrack, for: .video)
player?.selectTrack(selectedTrack, for: .closedCaption)
player?.selectTrack(selectedTrack, for: .subtitle)

// To unselect a track
player?.selectTrack(nil, for: .audio)
player?.selectTrack(nil, for: .video)
player?.selectTrack(nil, for: .closedCaption)
player?.selectTrack(nil, for: .subtitle)

In-stream video resolution selection​

You can fetch available video resolutions for the active stream to populate quality pickers in your user interface. In iOS, video renditions are managed by capping the player's maximum resolution and peak bitrate rather than selecting a discrete media track.

Fetch available video resolutions grouped by presentation size and filtered by multi-bitrate preference:

// Fetch available resolutions once player is Loaded or Playing (Async/Await)
let variants = try await player.getAvailableResolutions()
for variant in variants {
print("Resolution: \(Int(variant.resolution.width))x\(Int(variant.resolution.height)) [\(variant.minBitrate) - \(variant.maxBitrate) bps]")
}

// Cap playback at the selected variant; AVPlayer may still choose a lower rendition when network conditions change.
player.set(preferences: [
.preferredMaximumResolution(size: selectedVariant.resolution),
.preferredPeakBitRate(bitrate: selectedVariant.maxBitrate) // or can choose .preferredPeakBitRate(bitrate: selectedVariant.minBitrate)
])

// Return to Auto / adaptive streaming
player.set(preferences: [
.preferredMaximumResolution(size: .zero),
.preferredPeakBitRate(bitrate: 0)
])

Note: Call getAvailableResolutions() only after the player enters the loaded state.