Instance Property

activeVideoMaxFrameDuration

The currently active maximum frame duration

Declaration

var activeVideoMaxFrameDuration: CMTime { get set }

Discussion

A device’s maximum frame duration is the reciprocal of its minimum frame rate. You can set the value of this property to limit the minimum frame rate during a capture session. The capture device automatically chooses a default maximum frame duration based on its active format. After changing the value of this property, you can return to the default maximum frame duration by setting this property’s value to invalid. Choosing a new preset for the capture session also resets this property to its default value.

Attempting to set this property to a value not found in the active format’s videoSupportedFrameRateRanges array raises an exception (invalidArgumentException).

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 are done 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 Frame Rate Settings

var activeVideoMinFrameDuration: CMTime

The currently active minimum frame duration.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software