<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "visionOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVKit",
  "identifier" : "/documentation/AVKit/AVExperienceController/transition(to:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "AVKit"
    ],
    "preciseIdentifier" : "s:5AVKit22AVExperienceControllerC10transition2toAC17TransitionContextV0F6ResultOAC10ExperienceO_tYaF"
  },
  "title" : "transition(to:)"
}
-->

# transition(to:)

Transitions the video to a different experience.

```
@discardableResult @MainActor final func transition(to toExperience: AVExperienceController.Experience) async -> AVExperienceController.TransitionContext.TransitionResult
```

## Parameters

`toExperience`

The experience to transition to.

## Return Value

A transition result.

## Discussion

Call this method to transition to a different experience such as [`AVExperienceController.Experience.expanded`](/documentation/AVKit/AVExperienceController/Experience-swift.enum/expanded). When you initiate a transition, the system calls the experience controller’s delegate methods so your app can respond to experience changes.

You determine the success of a transition by evaluating the [`AVExperienceController.TransitionContext.TransitionResult`](/documentation/AVKit/AVExperienceController/TransitionContext/TransitionResult) this method returns. A transition result of [`AVExperienceController.TransitionContext.TransitionResult.completed`](/documentation/AVKit/AVExperienceController/TransitionContext/TransitionResult/completed) indicates a successful transition, in which case the system updates the [`experience`](/documentation/AVKit/AVExperienceController/experience-swift.property) property to the new experience. A transition result of [`AVExperienceController.TransitionContext.TransitionResult.reversed(reason:)`](/documentation/AVKit/AVExperienceController/TransitionContext/TransitionResult/reversed(reason:)) indicates a failed transition. Evaluate the result’s [`AVExperienceController.TransitionContext.ReversedReason`](/documentation/AVKit/AVExperienceController/TransitionContext/ReversedReason) to determine why the transition failed. A failure that occurs before the transition begins results in the system not invoking any delegate callback methods. If the failure happens after the callback to  [`experienceController(_:prepareForTransitionUsing:)`](/documentation/AVKit/AVExperienceController/Delegate-swift.protocol/experienceController(_:prepareForTransitionUsing:)) occurs, the transition context changes to [`AVExperienceController.TransitionContext.Status.finished(result:)`](/documentation/AVKit/AVExperienceController/TransitionContext/Status-swift.enum/finished(result:)).

---

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)