<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/Scene/immersiveContentBrightness(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI5ScenePAAE26immersiveContentBrightnessyQrAA09ImmersiveeF0VF"
  },
  "title" : "immersiveContentBrightness(_:)"
}
-->

# immersiveContentBrightness(_:)

Sets the content brightness of an immersive space.

```
nonisolated func immersiveContentBrightness(_ brightness: ImmersiveContentBrightness) -> some Scene
```

## Parameters

`brightness`

The level of content brightness that you prefer.

## Return Value

A scene that has the specified content brightness.

## Discussion

Pass one of the standard brightness levels defined in
[`ImmersiveContentBrightness`](/documentation/SwiftUI/ImmersiveContentBrightness) or a custom one that you create with the
[`custom(_:)`](/documentation/SwiftUI/ImmersiveContentBrightness/custom(_:)) method to this scene
modifier to set a preference for the content brightness in an
[`ImmersiveSpace`](/documentation/SwiftUI/ImmersiveSpace). The system takes the value that you set into
account, but might not be able to honor a specific preference.

When you do this to create an environment that’s suitable for video
playback, the standard brightness values provide good results for most
use cases. To optimize further, you can create a custom brightness
using a normalized value that expresses the linear brightness ratio
between a standard dynamic range white video frame and the background
that surrounds the player window.

> Important: This modifier doesn’t affect scenes other than
> immersive spaces.

---

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)