For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
StatusSupportDiscussionsLog inSign Up
Docs HomeAPI ReferenceVideo on DemandAI FeaturesLive StreamingVideo PlayerVideo DataCloud PlayoutRecipes
Docs HomeAPI ReferenceVideo on DemandAI FeaturesLive StreamingVideo PlayerVideo DataCloud PlayoutRecipes
  • Player SDKs
    • Introduction
  • Web player
    • Install the FastPix web player
    • Play uploaded videos
    • Handle playback errors
  • Android player
    • Install FastPix Android player
    • Set up the player
    • Play uploaded videos
    • Handle playback errors
  • iOS player
    • Install FastPix iOS player
    • Play uploaded videos
    • Handle playback errors
      • Play live and on-demand streams
      • Adjust volume and mute
      • Control playback speed
      • Set playback resolution
      • Set rendition order
      • Set autoplay and loop
  • Flutter player
    • Install FastPix Flutter player
    • Play uploaded videos
    • Handle playback errors
LogoLogo
StatusSupportDiscussionsLog inSign Up
On this page
  • Set a minimum resolution
  • Set a maximum resolution
  • Set a specific resolution
  • Set a resolution range
  • Use adaptive bitrate streaming (ABR)
  • Set up the quality manager
  • Get available quality levels
  • Get the current quality level
  • Switch to a specific quality level
  • Reset to auto mode
  • Load quality levels dynamically
  • Handle quality change callbacks
iOS playerPlayback

Set playback resolution

Was this page helpful?
Previous

Set rendition order

Next
Built with

Learn how to control video playback resolution and adaptive bitrate streaming in the FastPix iOS Player.

The FastPix iOS Player gives you flexibility to customize video playback resolution. You can set minimum, maximum, or specific resolution values, and let users choose their preferred quality level. The SDK also supports adaptive bitrate streaming (ABR) for automatic quality adjustments based on network conditions.

Set a minimum resolution

Ensure the player only streams video at or above a specified resolution:

1// Set minimum resolution
2playerViewController.prepare(
3    playbackID: playbackID,
4    playbackOptions: PlaybackOptions(minResolution: .atLeast270p)
5)
6
7// With a playback token
8playerViewController.prepare(
9    playbackID: playbackID,
10    playbackOptions: PlaybackOptions(
11        minResolution: .atLeast270p,
12        playbackToken: playbackToken
13    )
14)

Set a maximum resolution

Ensure the player only streams video up to a specified resolution:

1// Set maximum resolution
2playerViewController.prepare(
3    playbackID: playbackID,
4    playbackOptions: PlaybackOptions(maxResolution: .upTo1080p)
5)
6
7// With a playback token
8playerViewController.prepare(
9    playbackID: playbackID,
10    playbackOptions: PlaybackOptions(
11        maxResolution: .upTo1080p,
12        playbackToken: playbackToken
13    )
14)

Set a specific resolution

Lock playback to a single resolution:

1// Set a fixed resolution
2playerViewController.prepare(
3    playbackID: playbackID,
4    playbackOptions: PlaybackOptions(resolution: .set480p)
5)
6
7// With a playback token
8playerViewController.prepare(
9    playbackID: playbackID,
10    playbackOptions: PlaybackOptions(
11        resolution: .set480p,
12        playbackToken: playbackToken
13    )
14)

Set a resolution range

Define both a minimum and maximum resolution to stream video within a specific range:

1// Set a resolution range
2playerViewController.prepare(
3    playbackID: playbackID,
4    playbackOptions: PlaybackOptions(
5        minResolution: .atLeast270p,
6        maxResolution: .upTo1080p
7    )
8)
9
10// With a playback token
11playerViewController.prepare(
12    playbackID: playbackID,
13    playbackOptions: PlaybackOptions(
14        minResolution: .atLeast270p,
15        maxResolution: .upTo1080p,
16        playbackToken: playbackToken
17    )
18)

Use adaptive bitrate streaming (ABR)

ABR automatically adjusts video quality based on network conditions, reducing buffering and improving playback stability. The SDK also supports manual resolution switching, letting users select specific quality levels during playback.

Set up the quality manager

1// Assign the delegate and initialize the quality manager
2playerViewController.qualityDelegate = self
3playerViewController.setupQualityManager(delegate: self)

Get available quality levels

Each QualityLevel includes a label (for example, “Auto”, “240p”, “720p”), bitrate, resolution, and an isAuto flag:

1let levels = playerViewController.getResolutionLevels()

Get the current quality level

1let current = playerViewController.getCurrentResolutionLevel()

Switch to a specific quality level

1playerViewController.setResolutionLevel(level)

Note: Playback continues from the same position. The player might buffer briefly during the switch.

Reset to auto mode

Switch back to ABR so the player adjusts quality automatically:

1playerViewController.resetToAuto()

Load quality levels dynamically

Quality levels become available only after playback starts. Trigger loading manually when the player is ready:

1playerViewController.qualityManager?.loadQualityLevels()

Trigger this when player.timeControlStatus == .playing for accurate detection.

Handle quality change callbacks

Implement the quality delegate to receive updates:

1// Called when quality levels are fetched and ready
2func onQualityLevelsUpdated(levels: [QualityLevel]) {
3    print("Quality levels available: \(levels.count)")
4}
5
6// Called when the resolution changes (user or ABR)
7func onQualityLevelChanged(selectedLevel level: QualityLevel) {
8    print("Switched to: \(level.label)")
9}
10
11// Called when a quality switch is in progress
12func onQualitySwitching(isSwitching: Bool) {
13    print("Switching in progress...")
14}
15
16// Called when quality switching fails
17func onQualityLevelFailed(error: QualityLevelError) {
18    print("Quality switch failed: \(error)")
19}