TeeAudioProcessor

Artifact: androidx.media3:media3-exoplayer

Kotlin |Java

@UnstableApi
public final class TeeAudioProcessor extends BaseAudioProcessor

java.lang.Object
↳	androidx.media3.common.audio.BaseAudioProcessor
	↳	androidx.media3.exoplayer.audio.TeeAudioProcessor

Audio processor that outputs its input unmodified and also outputs its input to a given sink. This is intended to be used for diagnostics and debugging.

This audio processor can be inserted into the audio processor chain to access audio data before/after particular processing steps have been applied. For example, to get audio output after playback speed adjustment and silence skipping have been applied it is necessary to pass a custom AudioProcessorChain when creating the audio sink, and include this audio processor after all other audio processors.

Summary

Nested types
`public interface TeeAudioProcessor.AudioBufferSink` A sink for audio buffers handled by the audio processor.
`public final class TeeAudioProcessor.WavFileAudioBufferSink implements TeeAudioProcessor.AudioBufferSink` A sink for audio buffers that writes output audio as .wav files with a given path prefix.

Public constructors
`TeeAudioProcessor(TeeAudioProcessor.AudioBufferSink audioBufferSink)` Creates a new tee audio processor, sending incoming data to the given `AudioBufferSink`.

Public methods
`AudioProcessor.AudioFormat`	`onConfigure(AudioProcessor.AudioFormat inputAudioFormat)` Called when the processor is configured for a new input format.
`void`	`queueInput(ByteBuffer inputBuffer)` Queues audio data between the position and limit of the `inputBuffer` for processing.

Protected methods
`void`	`onFlush()` This method is deprecated. Use `onFlush` instead.
`void`	`onQueueEndOfStream()` Called when the end-of-stream is queued to the processor.
`void`	`onReset()` Called when the processor is reset.

Protected methods

void

onFlush()

This method is deprecated.

Use onFlush instead.

void

onQueueEndOfStream()

Called when the end-of-stream is queued to the processor.

void

onReset()

Called when the processor is reset.

Inherited Constants

From androidx.media3.common.audio.AudioProcessor

static final ByteBuffer

EMPTY_BUFFER

An empty, direct ByteBuffer.

Inherited fields

From androidx.media3.common.audio.BaseAudioProcessor

`AudioProcessor.AudioFormat`	`inputAudioFormat` The current input audio format.
`AudioProcessor.AudioFormat`	`outputAudioFormat` The current output audio format.

Inherited methods

From androidx.media3.common.audio.AudioProcessor

long

getDurationAfterProcessorApplied(long durationUs)

Returns the expected duration of the output stream when the processor is applied given a input durationUs.

From androidx.media3.common.audio.BaseAudioProcessor

`final AudioProcessor.AudioFormat`	`configure(AudioProcessor.AudioFormat inputAudioFormat)` Configures the processor to process input audio with the specified format.
`final void`	`flush()` This method is deprecated. Use `flush` instead.
`final void`	`flush(AudioProcessor.StreamMetadata streamMetadata)` Prepares the audio processor to receive a new stream of input in the last `configured format` and clears any buffered data and pending output.
`ByteBuffer`	`@CallSuper getOutput()` Returns a buffer containing processed output data between its position and limit.
`final boolean`	`hasPendingOutput()` Returns whether the current output buffer has any data remaining.
`boolean`	`@CallSuper isActive()` Returns whether the processor is configured and will process input buffers.
`boolean`	`@CallSuper isEnded()` Returns whether this processor will return no more output from `getOutput` until `flush` has been called and more input has been queued.
`void`	`onFlush(AudioProcessor.StreamMetadata streamMetadata)` Called when the processor is `flushed`.
`final void`	`queueEndOfStream()` Queues an end of stream signal.
`final ByteBuffer`	`replaceOutputBuffer(int size)` Replaces the current output buffer with a buffer of at least `size` bytes and returns it.
`final void`	`reset()` Resets the processor to its unconfigured state, releasing any resources.

Public constructors