Bin element distributing a mixing job between multiple Membrane.AudioMixer elements.

A tree of AudioMixers is created according to max_inputs_per_node parameter:

• if number of input tracks is smaller than max_inputs_per_node, only one AudioMixer element is created for the entire job
• if there are more input tracks than max_inputs_per_node, there are created enough mixers so that each mixer has at most max_inputs_per_node inputs - outputs from those mixers are then mixed again following the same rules - another level of mixers is created having enough mixers so that each mixer on this level has at most max_inputs_per_node inputs (those are now the outputs of the previous level mixers). Levels are created until only one mixer in the level is needed - output from this mixer is the final mixed track.

Bin allows for specifying options for Membrane.AudioMixer, which are applied for all AudioMixers.

Recommended to use in case of mixing jobs with many inputs.

A number of inputs to the bin must be specified in the number_of_inputs option.

Bin options

Passed via struct Membrane.AudioMixerBin.t/0

• max_inputs_per_node

  pos_integer()

  Default value: 10
  The maximum number of inputs to a single mixer in the mixers tree. Must be at least 2.

• mixer_options

  AudioMixer.t()

  Default value: %Membrane.AudioMixer{stream_format: nil, frames_per_buffer: 2048, prevent_clipping: true, native_mixer: false, synchronize_buffers?: false}
  The options that would be passed to each created AudioMixer.

• number_of_inputs

  pos_integer()

  Required
  The exact number of inputs to the bin. Must be at least 1.

Pads

:input

Accepted formats:

%RawAudio{sample_format: sample_format}
when sample_format in [:s8, :s16le, :s16be, :s24le, :s24be, :s32le, :s32be]

Membrane.RemoteStream

Pad options:

• offset

  Time.t()

  Default value: 0
  Offset of the input audio at the pad.

:output

Accepted formats:

RawAudio