<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "visionOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVKit",
  "identifier" : "/documentation/AVKit/AVExperienceController/ExpandedConfiguration",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "AVKit"
    ],
    "preciseIdentifier" : "s:5AVKit22AVExperienceControllerC21ExpandedConfigurationV"
  },
  "title" : "AVExperienceController.ExpandedConfiguration"
}
-->

# AVExperienceController.ExpandedConfiguration

A structure that specifies options for an expanded experience.

```
struct ExpandedConfiguration
```

## Overview

It’s valid to transition to this experience even when the original container isn’t in a view hierarchy. In this case, you must specify a [`fallbackPlacement`](/documentation/AVKit/AVExperienceController/ExpandedConfiguration/fallbackPlacement) or the transition result is [`AVExperienceController.TransitionContext.TransitionResult.reversed(reason:)`](/documentation/AVKit/AVExperienceController/TransitionContext/TransitionResult/reversed(reason:)).

## Topics

### Creating an expanded configuration

[`init(fallbackPlacement: AVExperienceController.ExpandedConfiguration.Placement)`](/documentation/AVKit/AVExperienceController/ExpandedConfiguration/init(fallbackPlacement:))

Creates a configuration object for an expanded experience.

### Specifying placement

[`var fallbackPlacement: AVExperienceController.ExpandedConfiguration.Placement`](/documentation/AVKit/AVExperienceController/ExpandedConfiguration/fallbackPlacement)

A fallback placement to use when the original container isn’t in the view controller hierarchy.

[`struct Placement`](/documentation/AVKit/AVExperienceController/ExpandedConfiguration/Placement)

A structure that represents where the video will be experienced.

### Configuring automatic immersive transitions

[`var automaticTransitionToImmersive: AVExperienceController.ExpandedConfiguration.AutomaticTransitionToImmersive`](/documentation/AVKit/AVExperienceController/ExpandedConfiguration/automaticTransitionToImmersive-swift.property)

The expanded experience automatic transition behavior for the immersive experience.

[`enum AutomaticTransitionToImmersive`](/documentation/AVKit/AVExperienceController/ExpandedConfiguration/AutomaticTransitionToImmersive-swift.enum)

The expanded experience automatic transition behavior into the immersive experience.


---

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)