Audio.load Function

Format

b = audio_name.load(audio_filename);

Description

The Audio.load function reads the audio file named audio_filename and stores the audio data contained in the file in an Audio object. The loaded audio can then be played back using Audio.play or combined with other audio using Audio.concat.

CSPro can load and play most audio files in any of the following formats: m4a, mp4, mp3, wav, 3gp, flac, ogg, mkv. However, only m4a files (AAC encoded audio in an MPEG-4 container) can be used with the functions Audio.concat, Audio.length, Audio.record, and Audio.recordInteractive.

Return Value

The function returns a logical value of 1 (true) if the file was loaded and 0 (false) if the file could not be loaded.

Example

Audio recording;
if recording.load("myrecording.m4a") then
recording.play();
endif;