---
title: "onImmersionChange(initial:_:)"
framework: swiftui
role: symbol
role_heading: Instance Method
path: "swiftui/view/onimmersionchange(initial:_:)"
---

# onImmersionChange(initial:_:)

Performs an action when the immersion state of your app changes.

## Declaration

```swift
nonisolated func onImmersionChange(initial: Bool = true, _ action: @escaping (ImmersionChangeContext, ImmersionChangeContext) -> Void) -> some View

```

## Parameters

- `initial`: Whether the action should be run when this view initially appears.
- `action`: A closure to run when the immersion changes.

## Discussion

Discussion Depending on the immersion style used for the Immersive Space in your app, the amount of immersion can be controlled by actions such as turning the Digital Crown. Use this modifier to define a closure that is run when the immersion state changes. The following example sets the value of a binding depending on the current amount of immersion: struct ImmersiveView: View {     @Binding var enableSoundEffects: Bool

var body: some View {         MyView()             .onImmersionChange { _, newImmersion in                 guard let amount = newImmersion.amount else {                     enableSoundEffects = false                     return                 }                 // Enable some effects based on the updated                 // amount of immersion                 enableSoundEffects = amount > 0.5             }     } }

## See Also

### Responding to immersion changes

- [ImmersionChangeContext](swiftui/immersionchangecontext.md)