Input Audio File

How it fits

Typical backends

Caveats

• I/O contractThe bound slot is treated as a directory: every recognised audio file in it is played in sorted filename order, and files with unrecognised extensions are silently skipped. Pin the slot at a directory holding a single file for a deterministic test.
• FallbackA file that fails to decode is logged and skipped rather than aborting the run, so a corrupt clip leaves a gap instead of stopping the playlist.
• LatencyPlayback is paced to real time regardless of how fast decoding could run, so a one-minute clip takes one minute to emit.
• I/O contractframe_size_ms sets each chunk's duration; the final chunk of a file is shorter when the length does not divide evenly. The emitted channel count matches the source layout with no downmix.
• Parameter interactionsample_rate left at the sentinel keeps the file's native rate, while a positive value resamples on the fly; this is captured per opened file, whereas frame_size_ms, repeat, and the bound slot can be changed at runtime.
• State lifetimerepeat loops the playlist indefinitely when on, and stops after the last file when off.