AudioProcessorChain


@UnstableApi
public interface AudioProcessorChain

Known indirect subclasses
DefaultAudioSink.DefaultAudioProcessorChain

The default audio processor chain, which applies a (possibly empty) chain of user-defined audio processors followed by SilenceSkippingAudioProcessor and SonicAudioProcessor.


Provides a chain of audio processors, which are used for any user-defined processing and applying playback parameters (if supported). Because applying playback parameters can skip and stretch/compress audio, the sink will query the chain for information on how to transform its output position to map it onto a media position, via getMediaDuration and getSkippedOutputFrameCount.

Summary

Public methods

abstract PlaybackParameters

Configures audio processors to apply the specified playback parameters immediately, returning the new playback parameters, which may differ from those passed in.

abstract boolean
applySkipSilenceEnabled(boolean skipSilenceEnabled)

Configures audio processors to apply whether to skip silences immediately, returning the new value.

abstract AudioProcessor[]

Returns the fixed chain of audio processors that will process audio.

abstract long
getMediaDuration(long playoutDuration)

Returns the media duration corresponding to the specified playout duration, taking speed adjustment due to audio processing into account.

abstract long

Returns the number of output audio frames skipped since the audio processors were last flushed.

Public methods

applyPlaybackParameters

abstract PlaybackParameters applyPlaybackParameters(PlaybackParameters playbackParameters)

Configures audio processors to apply the specified playback parameters immediately, returning the new playback parameters, which may differ from those passed in. Only called when processors have no input pending.

Parameters
PlaybackParameters playbackParameters

The playback parameters to try to apply.

Returns
PlaybackParameters

The playback parameters that were actually applied.

applySkipSilenceEnabled

abstract boolean applySkipSilenceEnabled(boolean skipSilenceEnabled)

Configures audio processors to apply whether to skip silences immediately, returning the new value. Only called when processors have no input pending.

Parameters
boolean skipSilenceEnabled

Whether silences should be skipped in the audio stream.

Returns
boolean

The new value.

getAudioProcessors

abstract AudioProcessor[] getAudioProcessors()

Returns the fixed chain of audio processors that will process audio. This method is called once during initialization, but audio processors may change state to become active/inactive during playback.

getMediaDuration

abstract long getMediaDuration(long playoutDuration)

Returns the media duration corresponding to the specified playout duration, taking speed adjustment due to audio processing into account.

The scaling performed by this method will use the actual playback speed achieved by the audio processor chain, on average, since it was last flushed. This may differ very slightly from the target playback speed.

Parameters
long playoutDuration

The playout duration to scale.

Returns
long

The corresponding media duration, in the same units as duration.

getSkippedOutputFrameCount

abstract long getSkippedOutputFrameCount()

Returns the number of output audio frames skipped since the audio processors were last flushed.