Class

AVCaptureConnection

A connection between a specific pair of capture input and capture output objects in a capture session.

Declaration

class AVCaptureConnection : NSObject

Overview

Capture inputs have one or more input ports (instances of AVCaptureInput.Port). Capture outputs can accept data from one or more sources (for example, an AVCaptureMovieFileOutput object accepts both video and audio data).

You can add an AVCaptureConnection instance to a session using the addConnection(_:) method only if the canAddConnection(_:) method returns true. When using the addInput(_:) or addOutput(_:) method, the session forms connections automatically between all compatible inputs and outputs. You only need to add connections manually when adding an input or output with no connections. You can also use connections to enable or disable the flow of data from a given input or to a given output.

Topics

Creating a Connection

init(inputPorts: [AVCaptureInput.Port], output: AVCaptureOutput)

Initializes a capture connection to describe a connection between the specified input ports and the specified output.

init(inputPort: AVCaptureInput.Port, videoPreviewLayer: AVCaptureVideoPreviewLayer)

Initializes a capture connection to describe a connection between the specified input port and the specified video preview layer.

Configuration

var isEnabled: Bool

Indicates whether the connection is enabled.

var isActive: Bool

Indicates whether the connection is active.

var inputPorts: [AVCaptureInput.Port]

The connection’s input ports.

var output: AVCaptureOutput?

The connection’s output port.

var videoPreviewLayer: AVCaptureVideoPreviewLayer?

The video preview layer associated with the connection.

var audioChannels: [AVCaptureAudioChannel]

An array of AVCaptureAudioChannel objects.

Managing Video Configuration

var videoOrientation: AVCaptureVideoOrientation

Indicates whether to rotate the video flowing through the connection to a given orientation.

var isVideoOrientationSupported: Bool

A Boolean value that indicates whether the connection supports changing the orientation of the video.

enum AVCaptureVideoOrientation

Constants indicating video orientation.

var videoFieldMode: AVVideoFieldMode

An indicator of how interlaced video flowing through the connection should be treated

var isVideoFieldModeSupported: Bool

A Boolean value that indicates whether the connection supports setting the videoFieldMode property.

var videoMinFrameDuration: CMTime

The minimum time interval between which the receiver should output consecutive video frames.

var isVideoMinFrameDurationSupported: Bool

A Boolean value that indicates whether the connection supports setting the videoMinFrameDuration property.

var videoMaxFrameDuration: CMTime

The maximum time interval between which the receiver should output consecutive video frames.

var isVideoMaxFrameDurationSupported: Bool

A Boolean value that indicates whether the connection supports setting the videoMaxFrameDuration property.

var videoScaleAndCropFactor: CGFloat

The current video scale and crop factor in use by the receiver.

var videoMaxScaleAndCropFactor: CGFloat

The maximum video scale and crop factor by the connection.

Managing the Video Mirroring Settings

var automaticallyAdjustsVideoMirroring: Bool

A Boolean value that indicates whether the value of isVideoMirrored can change based on configuration of the session.

var isVideoMirroringSupported: Bool

A Boolean value that indicates whether the connection supports video mirroring.

var isVideoMirrored: Bool

A Boolean value that indicates whether the video flowing through the connection should be mirrored about its vertical axis.

Managing the Video Stabilization Settings

var isVideoStabilizationSupported: Bool

A Boolean value that indicates whether this connection supports video stabilization.

var activeVideoStabilizationMode: AVCaptureVideoStabilizationMode

The stabilization mode currently active for the connection.

var preferredVideoStabilizationMode: AVCaptureVideoStabilizationMode

The stabilization mode most appropriate for use with the connection.

var isVideoStabilizationEnabled: Bool

A Boolean value that indicates whether video stabilization is active for the connection.

Deprecated

var enablesVideoStabilizationWhenAvailable: Bool

A Boolean value that indicates whether the system should enable video stabilization when it is available.

Deprecated

Managing Camera Calibration Delivery Settings

var isCameraIntrinsicMatrixDeliverySupported: Bool

A Boolean value indicating whether the capture connection currently supports delivery of camera intrinsics information.

var isCameraIntrinsicMatrixDeliveryEnabled: Bool

A Boolean value that specifies whether to configure the capture pipeline for delivery of camera intrinsics information.

Constants

enum AVCaptureVideoOrientation

Constants indicating video orientation.

enum AVVideoFieldMode

Constants indicating video field mode, for use with the videoFieldMode property.

Relationships

Inherits From

NSObject