A Boolean value that indicates whether the capture device should automatically switch to low light boost mode when necessary.
SDKs
- iOS 6.0+
- Mac Catalyst 13.0+
Framework
- AVFoundation
Declaration
var automaticallyEnablesLowLightBoostWhenAvailable: Bool { get set }
Discussion
On an AVCapture
object where is
is true
, a special low light boost mode may be engaged to improve image quality. When the automatically
property is set to true
, the capture device switches at its discretion to a special boost mode under low light. When the scene becomes sufficiently lit, the device switches back to normal operation. An AVCapture
that supports this feature may only engage boost mode for certain source formats or resolutions.
The default value of this property is false
. Setting this property throws an invalid
if is
is false
. The AVCapture
object must be locked for configuration using lock
before clients can set this method, otherwise an generic
is thrown.
Clients may observe changes to the is
property using Key-value observing to know when the boost mode engages. The switch between normal operation and low light boost mode may drop one or more video frames.