AudioSample objects are used for playing external audio files (supported formats are WAV and AIF — 16, 24 and 32 bit PCM, and 32-bit float). They can be played, pitch-shifted, looped, paused, resumed, and stopped, among other things.

An application may have several AudioSample objects playing at the same time.  In fact, it is possible to create complex timbres by loading several simpler sound objects and manipulating them (e.g., change their frequency and/or volume) in real-time.  AudioSample objects open endless timbral possibilities for interactive applications.

NOTE: One limitation is that AudioSamples are very expensive in terms of memory. Although it is possible to load whole songs, you should load only smaller files (e.g., a few seconds long). Since AudioSamples can be looped, one may load specially edited loops, and use them to create longer sound artifacts. For example, see here.

AudioSample is included in the music library, so, you need the following in your program:

from music import *

The simplest way to create an AudioSample object is this (where “sound.wav” is stored in the same folder as your program):

 a = AudioSample("sound.wav")

Audio samples may also be created using one of the following functions:

Once an audio sample, a, has been created, the following functions are available:

NOTE: All the above functions have an optional parameter, voice – to indicate a particular voice, if desired. For most practical situations this is not necessary to use.

Also, see Play.audio().