audiodev.emulated_audio

CI / no-hardware PCM: WAV files, waveform generator, in-memory loopback.

Never selected by audiodev.auto. Import this module explicitly.

audiodev.emulated_audio.wav_header(fmt, data_length)[source]

Build a 44-byte PCM RIFF/WAVE header for fmt and data_length bytes.

audiodev.emulated_audio.parse_pcm_wav(data)[source]

Return (AudioFormat, pcm_bytes) from a PCM WAV buffer.

class audiodev.emulated_audio.WavPCMOutput(path, format)[source]

Bases: PCMOutput

Write interleaved PCM into a WAV file; finalize sizes on close.

class audiodev.emulated_audio.WavPCMInput(path)[source]

Bases: PCMInput

Read interleaved PCM from a WAV file; readinto returns 0 at EOF.

class audiodev.emulated_audio.NullPCMOutput(format)[source]

Bases: PCMOutput

Discard PCM (write-path tests that must not touch a host sink).

class audiodev.emulated_audio.LoopbackBuffer(format, *, queue_ms=None)[source]

Bases: object

Shared in-memory PCM queue for a loopback pair.

class audiodev.emulated_audio.LoopbackPCMOutput(buffer)[source]

Bases: PCMOutput

Enqueue PCM into a LoopbackBuffer.

queued_size()[source]

Bytes still waiting to play or capture. Default 0.

is_active()[source]

True while PCM remains queued. Default False.

clear()[source]

Drop queued PCM now. Default no-op.

class audiodev.emulated_audio.LoopbackPCMInput(buffer)[source]

Bases: PCMInput

Dequeue PCM from a LoopbackBuffer (0 when empty).

queued_size()[source]

Bytes still waiting to play or capture. Default 0.

is_active()[source]

True while PCM remains queued. Default False.

clear()[source]

Drop queued PCM now. Default no-op.

audiodev.emulated_audio.loopback_pair(format, *, queue_ms=None)[source]

Return (LoopbackPCMOutput, LoopbackPCMInput) sharing one buffer.

class audiodev.emulated_audio.GeneratorPCMInput(format, *, wave='sine', frequency=440, duration_ms=None, amplitude=100)[source]

Bases: PCMInput

Endless or timed waveform as a PCMInput (no microphone).

audiodev.emulated_audio.pcm_out(format=None, *, path=None, loopback=None, discard=False, queue_ms=None)[source]

Standalone emulated playback: WAV path, loopback buffer, or discard.

audiodev.emulated_audio.pcm_in(format=None, *, path=None, loopback=None, wave=None, frequency=440, duration_ms=None, amplitude=100)[source]

Standalone emulated capture: WAV path, loopback buffer, or generator.