Class

AVAudioNode

An abstract class for an audio generation, processing, or I/O block.

Declaration

@interface AVAudioNode : NSObject

Overview

AVAudioEngine objects contain instances of various AVAudioNode subclasses. This base class provides certain common functionality.

Nodes have input and output busses, which can be thought of as connection points. For example, an effect typically has one input bus and one output bus. A mixer typically has multiple input busses and one output bus.

Busses have formats, expressed in terms of sample rate and channel count. When making connections between nodes, often the format must match exactly. However, there are exceptions such as the AVAudioMixerNode and AVAudioOutputNode classes.

Nodes do not currently provide useful functionality until attached to an engine.

Topics

Configuring an Input Format Bus

- inputFormatForBus:

Returns the input format for the specified bus.

- nameForInputBus:

Returns the name of an input bus.

numberOfInputs

The number of input busses for the node.

Creating and Output Format Bus

- outputFormatForBus:

Returns the output format for the specified bus.

- nameForOutputBus:

Returns the name of the output bus.

numberOfOutputs

The number of output busses for the node.

Installing and Removing An Audio Tap

- installTapOnBus:bufferSize:format:block:

Installs an audio tap on the bus to record, monitor, and observe the output of the node.

- removeTapOnBus:

Removes an audio tap on a bus.

Getting the Audio Engine for the Node

engine

The audio engine of the node.

Getting the Latest Node Render Time

lastRenderTime

The time for which the node most recently rendered.

Getting Audio Node Properties

AUAudioUnit

An AUAudioUnit object wrapping or underlying the implementation's AudioUnit instance.

latency

The processing latency of the node, in seconds.

outputPresentationLatency

The maximum render pipeline latency downstream of the node, in seconds.

Resetting the Audio Node

- reset

Clear a unit's previous processing state.

Constants

AVAudioNodeTapBlock

The block that receives copies of the output of an AVAudioNode.

AVAudioNodeBus

The index of a bus on an AVAudioNode.

Relationships

Inherits From

See Also

Multitrack Playback and Recording

Audio Engine Building Blocks

Add audio input, processing, and output to an audio engine instance.

AVAudioEngine

A group of connected audio node objects used to generate and process audio signals and perform audio input and output.

AVAudioUnit

A subclass of the audio node class that, depending on the type of the audio unit, processes audio either in real time or non-real time.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software