<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -",
    "macOS: 27.0.0 -",
    "tvOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/AudioPlaybackGroupController/gain",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation28AudioPlaybackGroupControllerC4gainSdvp"
  },
  "title" : "gain"
}
-->

# gain

The individual gain in decibels for all audio resources in the group.

```
@MainActor @preconcurrency var gain: Audio.Decibel { get set }
```

## Discussion

The gain must be zero or negative, where zero is nominal loudness and negative infinity is silent.
If the gain is positive, it will be reset to zero.

Use the [`fade(to:duration:)`](/documentation/RealityKit/AudioPlaybackGroupController/fade(to:duration:)) method to change
the gain gradually and create smooth transitions.

---

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)