<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macCatalyst: 26.0.0 -",
    "macOS: 26.0.0 -",
    "tvOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVFoundation",
  "identifier" : "/documentation/AVFoundation/AVCaptureExternalDisplayConfigurator",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "AVFoundation"
    ],
    "preciseIdentifier" : "c:objc(cs)AVCaptureExternalDisplayConfigurator"
  },
  "title" : "AVCaptureExternalDisplayConfigurator"
}
-->

# AVCaptureExternalDisplayConfigurator

A configurator class allowing you to configure properties of an external display to match the camera’s active video format.

```
class AVCaptureExternalDisplayConfigurator
```

## Overview

An [`AVCaptureExternalDisplayConfigurator`](/documentation/AVFoundation/AVCaptureExternalDisplayConfigurator) allows you to configure a connected external display to output a clean feed using a `CALayer`. Using the configurator, you can opt into automatic adjustment of the external display’s color space and / or frame rate to match your device’s capture configuration. These adjustments are only applied to the external display, not to the device.

> Note: Not all displays support the same configuration options as the device’s capture formats. Your adjustments to the external display are applied with utmost effort to accurately represent the capture device. When your capture device’s ``doc://com.apple.avfoundation/documentation/AVFoundation/AVCaptureDevice/activeFormat`` is unavailable on the external display, the configurator automatically chooses the closest available format.

## Topics

### Determining configuration support

[`isMatchingFrameRateSupported`](/documentation/AVFoundation/AVCaptureExternalDisplayConfigurator/isMatchingFrameRateSupported)

Whether the external display supports matching frame rate to a capture device.

[`isPreferredResolutionSupported`](/documentation/AVFoundation/AVCaptureExternalDisplayConfigurator/isPreferredResolutionSupported)

Whether the external display supports configuration to your preferred resolution.

[`isBypassingColorSpaceConversionSupported`](/documentation/AVFoundation/AVCaptureExternalDisplayConfigurator/isBypassingColorSpaceConversionSupported)

Whether the external display supports bypassing color space conversion.

### Creating an external display configurator

[`init(device:previewLayer:configuration:)`](/documentation/AVFoundation/AVCaptureExternalDisplayConfigurator/init(device:previewLayer:configuration:))

An external display configurator instance that attempts to synchronize the preview layer configuration with the device capture configuration.

### Inspecting the configurator

[`activeExternalDisplayFrameRate`](/documentation/AVFoundation/AVCaptureExternalDisplayConfigurator/activeExternalDisplayFrameRate)

The currently configured frame rate on the external display that’s displaying the preview layer.

[`device`](/documentation/AVFoundation/AVCaptureExternalDisplayConfigurator/device)

The device for which the coordinator configures the preview layer.

[`isActive`](/documentation/AVFoundation/AVCaptureExternalDisplayConfigurator/isActive)

This property tells you whether the configurator is actively configuring the external display.

[`previewLayer`](/documentation/AVFoundation/AVCaptureExternalDisplayConfigurator/previewLayer)

The layer for which the configurator adjusts display properties to match the device’s state.

### Stopping configuration

[`stop()`](/documentation/AVFoundation/AVCaptureExternalDisplayConfigurator/stop())

Forces the external display configurator to asynchronously stop configuring the external display.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)