---
title: automaticallyWaitsToMinimizeStalling
framework: avfoundation
role: symbol
role_heading: Instance Property
path: avfoundation/avplayer/automaticallywaitstominimizestalling
---

# automaticallyWaitsToMinimizeStalling

A Boolean value that indicates whether the player should automatically delay playback in order to minimize stalling.

## Declaration

```swift
nonisolated var automaticallyWaitsToMinimizeStalling: Bool { get set }
```

## Discussion

Discussion When playing media delivered over HTTP, this property is used to determine if the player should automatically delay playback in order to minimize stalling. When this property is true and the player changes from a paused state (rate of 0.0) to a played state (rate > 0.0), the player will try to determine if the current item can play to its end at the currently specified rate. If it determines that it’s likely to encounter a stall, the value of the player’s timeControlStatus will change to AVPlayer.TimeControlStatus.waitingToPlayAtSpecifiedRate and playback will automatically start when the likelihood of stalling has been minimized. A similar condition will occur during playback if the current player item’s playback buffer is exhausted and playback stalls. Playback will automatically resume when the likelihood of stalling has been minimized. You will need to set this property to false when you require precise control over playback start times, such as if you’re are synchronizing multiple player instances using the setRate(_:time:atHostTime:) method. If the value of this property is false, playback will start immediately when requested as long as the playback buffer is not empty. If the playback buffer becomes empty and playback stalls, the player’s timeControlStatus will switch to AVPlayer.TimeControlStatus.paused and the playback rate will change to 0.0. Changing the value of this property to false while the player’s timeControlStatus is AVPlayer.TimeControlStatus.waitingToPlayAtSpecifiedRate and its reasonForWaitingToPlay is toMinimizeStalls will cause the player to immediately attempt playback at the specified rate. important: For clients linked against iOS 10.0 and later or macOS 10.12 and later (and running on those versions), the default value of this property is true. This property did not exist in previous OS versions and the observed behavior was dependent on the type of media played: HTTP Live Streaming (HLS): When playing HLS media, the player behaved as if automaticallyWaitsToMinimizeStalling is true. File-based Media: When playing file-based media, including progressively downloaded content, the player behaved as if automaticallyWaitsToMinimizeStalling is false. You should verify that your playback applications perform as expected using this new default automatic waiting behavior.

## See Also

### Configuring waiting behavior

- [reasonForWaitingToPlay](avfoundation/avplayer/reasonforwaitingtoplay.md)
- [AVPlayer.WaitingReason](avfoundation/avplayer/waitingreason.md)
- [timeControlStatus](avfoundation/avplayer/timecontrolstatus-swift.property.md)
- [AVPlayer.TimeControlStatus](avfoundation/avplayer/timecontrolstatus-swift.enum.md)
- [playImmediately(atRate:)](avfoundation/avplayer/playimmediately(atrate:).md)
