NAME

       al_play_audio_stream - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro_audio.h>

              ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename)

DESCRIPTION

       Loads  and  plays  an  audio file, streaming from disk as it is needed.  This API can only play one audio
       stream at a time.  This requires a default mixer to be set, which is typically done  via  al_reserve_sam‐
       ples(3alleg5), but can also be done via al_set_default_mixer(3alleg5).

       Returns the stream on success, NULL on failure.  You must not destroy the returned stream, it will be au‐
       tomatically destroyed when the addon is shut down.

              Note:  the allegro_audio library does not support any audio file formats by default.  You must use
              the allegro_acodec addon, or register your own format handler.

SEE ALSO

       al_play_audio_stream_f(3alleg5), al_load_audio_stream(3alleg5)

SINCE

       5.2.8

              [Unstable API]: New API.

Allegro reference manual                                                           al_play_audio_stream(3alleg5)