Type

AudioEncodingConfig

Configuration object that controls audio encoding. Can be used to set codec, quality, and more.

type AudioEncodingConfig = {
	codec: AudioCodec;
	bitrate?: number | Quality;
	onEncodedPacket?: (packet: EncodedPacket, meta: EncodedAudioChunkMetadata | undefined) => unknown;
	onEncoderConfig?: (config: AudioEncoderConfig) => unknown;
} & AudioEncodingAdditionalOptions;

See AudioCodec, Quality, EncodedPacket, and AudioEncodingAdditionalOptions.

Used by

• new AudioBufferSource()
• new AudioSampleSource()
• new MediaStreamAudioTrackSource()

Properties

codec

codec: AudioCodec;

The audio codec that should be used for encoding the audio samples.

See AudioCodec.

bitrate

bitrate?: number | Quality;

The target bitrate for the encoded audio, in bits per second. Alternatively, a subjective Quality can be provided. Required for compressed audio codecs, unused for PCM codecs.

See Quality.

bitrateMode

bitrateMode?: 'constant' | 'variable';

Configures the bitrate mode.

fullCodecString

fullCodecString?: string;

The full codec string as specified in the WebCodecs Codec Registry. This string must match the codec specified in codec. When not set, a fitting codec string will be constructed automatically by the library.

Events

onEncodedPacket

onEncodedPacket?: ((packet: EncodedPacket, meta: EncodedAudioChunkMetadata | undefined) => unknown);

Called for each successfully encoded packet. Both the packet and the encoding metadata are passed.

See EncodedPacket.

onEncoderConfig

onEncoderConfig?: ((config: AudioEncoderConfig) => unknown);

Called when the internal encoder config, as used by the WebCodecs API, is created.