al_play_audio_stream(3alleg5)

💖 al_play_audio_stream(3alleg5) 💖

okay bestie, so this one lives in the allegro5 manual (that's the Allegro reference manual, the whole fam) and it's giving "press play and let it cook" energy. it's an Allegro 5 API function, periodt. ✨

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro_audio.h>

ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename)

like, that's the whole vibe. one file, one stream, go off. 💅

---

🎀 DESCRIPTION 🎀

so what it does: it loads and plays an audio file, streaming from disk as it is needed — not hoarding the whole thing in memory, just sipping as it goes. very mindful, very demure. 🧚

💀 real talk though: this API can only play one audio stream at a time. one. singular. it's giving monogamy.

it also requires a default mixer to be set, which is typically done via al_reserve_samples(3alleg5), but can also be done via al_set_default_mixer(3alleg5). pick your fighter, both work. 🫶

what you get back:

• the stream on success 🌈
• NULL on failure 😭

⚠️ DO NOT destroy the returned stream. like, not me watching you call destroy on it — no. it will be automatically destroyed when the addon is shut down, so hands off, it's not yours to end. 🙈

Note: the allegro_audio library does not support any audio file formats by default. none. zero. nada. 😭 you must use the allegro_acodec addon, or register your own format handler. those are the options, bestie, there is no secret third thing. 💅

---

👑 SEE ALSO 👑

• al_play_audio_stream_f(3alleg5) — the _f variant, iykyk
• al_load_audio_stream(3alleg5) — if you wanna load without the auto-play main character moment

---

⭐ SINCE ⭐

5.2.8 — so it's a newer baby, freshly iconic. ✨

🦋 [Unstable API]: New API. (yes it says unstable, no that's not a red flag, it's just young and figuring itself out 🎀)

---

and that's the whole page, bestie!! 🍓 this was the Allegro reference manual dropping the al_play_audio_stream(3alleg5) lore — go stream something, but only ONE thing, fr fr. mwah 💖✨