<!--
{
  "availability" : [
    "iOS: 8.0.0 - 26.0.0",
    "iPadOS: 8.0.0 - 26.0.0",
    "macCatalyst: 13.1.0 - 26.0.0",
    "macOS: 10.8.0 - 26.0.0",
    "tvOS: 9.0.0 - 26.0.0",
    "visionOS: 1.0.0 - 26.0.0",
    "watchOS: 3.0.0 - 26.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "SceneKit",
  "identifier" : "/documentation/SceneKit/SCNAudioSource",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "SceneKit"
    ],
    "preciseIdentifier" : "c:objc(cs)SCNAudioSource"
  },
  "title" : "SCNAudioSource"
}
-->

# SCNAudioSource

A simple, reusable audio source—music or sound effects loaded from a file—for use in positional audio playback.

```
class SCNAudioSource
```

## Overview

To create positional audio effects, create an [`SCNAudioPlayer`](/documentation/SceneKit/SCNAudioPlayer) object from the audio source to control playback, and add that player object to an [`SCNNode`](/documentation/SceneKit/SCNNode) object in your scene. SceneKit then automatically spatializes 3D audio effects based on the position of that node relative to the scene’s [`audioListener`](/documentation/SceneKit/SCNSceneRenderer/audioListener) node.

## Topics

### Creating an Audio Source

[`+  audioSourceNamed:`](/documentation/SceneKit/SCNAudioSource/init(named:))

Returns the audio source associated with the specified filename.

[`-  initWithFileNamed:`](/documentation/SceneKit/SCNAudioSource/init(fileNamed:))

Initializes an audio source from an audio file in the application’s main bundle.

[`-  initWithURL:`](/documentation/SceneKit/SCNAudioSource/init(url:)-3qyjs)

Initializes an audio source from the specified audio file.

### Controlling 3D Audio Spatialization

[`positional`](/documentation/SceneKit/SCNAudioSource/isPositional)

A Boolean value that determines whether audio from this source uses 3D positional mixing.

### Preloading Audio Data

[`-  load`](/documentation/SceneKit/SCNAudioSource/load())

Loads audio data from the source and prepares it for playing.

### Setting Default Playback Parameters

[`volume`](/documentation/SceneKit/SCNAudioSource/volume)

The default playback volume for the audio source.

[`rate`](/documentation/SceneKit/SCNAudioSource/rate)

The default playback rate for the audio source.

[`reverbBlend`](/documentation/SceneKit/SCNAudioSource/reverbBlend)

The default blend of blend of unmodified and reverb-processed (also called dry and wet) audio for playback of the audio source.

[`loops`](/documentation/SceneKit/SCNAudioSource/loops)

A Boolean value that determines whether the audio source should play repeatedly.

[`shouldStream`](/documentation/SceneKit/SCNAudioSource/shouldStream)

A Boolean value that determines whether the audio source should stream content from its source URL when playing.

## Relationships

### Conforms To

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

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

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

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

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

[`NSCoding`](/documentation/Foundation/NSCoding)

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

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

[`NSCopying`](/documentation/Foundation/NSCopying)

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

---

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)