<!--
{
  "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/Audio/Material",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation5AudioO8MaterialV"
  },
  "title" : "Audio.Material"
}
-->

# Audio.Material

A type that describes the acoustic characteristics of a surface.

```
struct Material
```

## Overview

An audio material defines how a surface absorbs and scatters sound energy across frequency bands.
Use preset materials for common real-world surfaces, or create custom materials from raw
absorption and scattering coefficients.

```swift
// Use a preset material:
let walls: Audio.Material = .concrete

// Create a custom material:
let custom = Audio.Material(
    absorption: .init([0.01, 0.02, 0.03, 0.04, 0.05, 0.06, 0.07, 0.08, 0.09, 0.10]),
    scattering: .init([0.10, 0.09, 0.08, 0.07, 0.06, 0.05, 0.04, 0.03, 0.02, 0.01])
)

// Modify a preset material:
let thickCarpet: Audio.Material = .carpet.scalingAbsorption { frequency in
    frequency > 1000 ? 0.5 : .zero
}
```

## Topics

### Creating a material

[`init(name: String?, absorption: Audio.Absorption, scattering: Audio.Scattering)`](/documentation/RealityKit/Audio/Material/init(name:absorption:scattering:))

Creates an audio material from absorption and scattering data.

### Using hard surface materials

[`static let concrete: Audio.Material`](/documentation/RealityKit/Audio/Material/concrete)

A material that simulates the acoustic properties of concrete.

[`static let brick: Audio.Material`](/documentation/RealityKit/Audio/Material/brick)

A material that simulates the acoustic properties of brick.

[`static let glass: Audio.Material`](/documentation/RealityKit/Audio/Material/glass)

A material that simulates the acoustic properties of glass.

[`static let metal: Audio.Material`](/documentation/RealityKit/Audio/Material/metal)

A material that simulates the acoustic properties of metal.

[`static let tile: Audio.Material`](/documentation/RealityKit/Audio/Material/tile)

A material that simulates the acoustic properties of tile.

[`static let marble: Audio.Material`](/documentation/RealityKit/Audio/Material/marble)

A material that simulates the acoustic properties of marble.

[`static let wood: Audio.Material`](/documentation/RealityKit/Audio/Material/wood)

A material that simulates the acoustic properties of wood.

[`static let parquet: Audio.Material`](/documentation/RealityKit/Audio/Material/parquet)

A material that simulates the acoustic properties of parquet flooring.

[`static let dryWall: Audio.Material`](/documentation/RealityKit/Audio/Material/dryWall)

A material that simulates the acoustic properties of drywall.

[`static let plaster: Audio.Material`](/documentation/RealityKit/Audio/Material/plaster)

A material that simulates the acoustic properties of plaster.

### Using soft furnishing materials

[`static let carpet: Audio.Material`](/documentation/RealityKit/Audio/Material/carpet)

A material that simulates the acoustic properties of carpet.

[`static let curtain: Audio.Material`](/documentation/RealityKit/Audio/Material/curtain)

A material that simulates the acoustic properties of a curtain.

[`static let mattress: Audio.Material`](/documentation/RealityKit/Audio/Material/mattress)

A material that simulates the acoustic properties of a mattress.

[`static let seatingUpholstered: Audio.Material`](/documentation/RealityKit/Audio/Material/seatingUpholstered)

A material that simulates the acoustic properties of upholstered seating.

[`static let seatingHard: Audio.Material`](/documentation/RealityKit/Audio/Material/seatingHard)

A material that simulates the acoustic properties of hard seating.

### Using natural surface materials

[`static let water: Audio.Material`](/documentation/RealityKit/Audio/Material/water)

A material that simulates the acoustic properties of water.

[`static let ice: Audio.Material`](/documentation/RealityKit/Audio/Material/ice)

A material that simulates the acoustic properties of ice.

[`static let snow: Audio.Material`](/documentation/RealityKit/Audio/Material/snow)

A material that simulates the acoustic properties of snow.

[`static let sand: Audio.Material`](/documentation/RealityKit/Audio/Material/sand)

A material that simulates the acoustic properties of sand.

[`static let soil: Audio.Material`](/documentation/RealityKit/Audio/Material/soil)

A material that simulates the acoustic properties of soil.

[`static let gravel: Audio.Material`](/documentation/RealityKit/Audio/Material/gravel)

A material that simulates the acoustic properties of gravel.

[`static let trees: Audio.Material`](/documentation/RealityKit/Audio/Material/trees)

A material that simulates the acoustic properties of trees.

### Adjusting acoustic properties

[`func scalingAbsorption(by: (Float) -> Float) -> Audio.Material`](/documentation/RealityKit/Audio/Material/scalingAbsorption(by:))

Scale the absorption data by a frequency-dependent scalar value between -1 and 1.

[`func scalingScattering(by: (Float) -> Float) -> Audio.Material`](/documentation/RealityKit/Audio/Material/scalingScattering(by:))

Scale the scattering data by a frequency-dependent scalar value between -1 and 1.

### Instance Properties

[`var name: String?`](/documentation/RealityKit/Audio/Material/name)

The name of the audio material.

### Instance Methods

[`func absorption(Audio.Absorption) -> Audio.Material`](/documentation/RealityKit/Audio/Material/absorption(_:))

Creates a new audio material with the provided absorption data.

[`func scattering(Audio.Scattering) -> Audio.Material`](/documentation/RealityKit/Audio/Material/scattering(_:))

Creates a new audio material with the provided scattering data.

### Type Properties

[`static let `default`: Audio.Material`](/documentation/RealityKit/Audio/Material/default)

Default audio material.

## Relationships

### Conforms To

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Equatable`](/documentation/Swift/Equatable)

[`Hashable`](/documentation/Swift/Hashable)

[`Sendable`](/documentation/Swift/Sendable)

---

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)