Class

SCNAudioPlayer

A controller for playback of a positional audio source in a SceneKit scene.

Declaration

@interface SCNAudioPlayer : NSObject

Overview

An SCNAudioPlayer object controls playback of a positional audio source in a SceneKit scene. To use positional audio, first create a reusable SCNAudioSource or AVAudioNode object to provide an audio stream. Then, create an audio player to control the playback of that audio source. Finally, attach the audio player to an SCNNode object for spatialized 3D audio playback based on the position of that node relative to the scene’s audioListener node.

Topics

Creating an Audio Player

- initWithSource:

Initializes an audio player for playing the specified simple audio source.

- initWithAVAudioNode:

Initializes an audio player for playing the specified AVFoundation audio node.

+ audioPlayerWithSource:

Returns an audio player (creating one if necessary) to play a simple audio source.

+ audioPlayerWithAVAudioNode:

Returns an audio player (creating one if necessary) to play an audio node.

Working with Audio Sources

audioSource

The source of audio played by this player.

audioNode

The audio node SceneKit uses for mixing audio from this player.

Responding to Playback

willStartPlayback

A block called by SceneKit when playback of the player’s audio source is about to begin.

didFinishPlayback

A block called by SceneKit when playback of the player’s audio source has completed.

Relationships

Inherits From

See Also

Audio

SCNAudioSource

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