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_samples(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
       automatically 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)