Instance Property


The current torch mode.


@property(nonatomic) AVCaptureTorchMode torchMode;


Setting the value of this property also sets the torch level to its maximum current value.

Before setting the value of this property, call the isTorchModeSupported: method to make sure the device supports the desired mode. Setting the device to an unsupported torch mode results in the raising of an exception. For a list of possible values for this property, see AVCaptureTorchMode.

Before changing the value of this property, you must call lockForConfiguration: to acquire exclusive access to the device’s configuration properties. Otherwise, setting the value of this property raises an exception. When you finish configuring the device, call unlockForConfiguration to release the lock and allow other devices to configure the settings.

You can observe changes to the value of this property using Key-value observing.

See Also

Managing Torch Settings


A Boolean value that specifies whether the capture device has a torch.


Indicates whether the torch is currently available for use.


A Boolean value indicating whether the device’s torch is currently active.


The current torch brightness level.


Constants to specify the capture device’s torch mode.

- isTorchModeSupported:

Returns a Boolean value that indicates whether the device supports the specified torch mode.

- setTorchModeOnWithLevel:error:

Sets the illumination level when in torch mode.