Audio Player (GNU Octave (version 8.1.0))

33.3 Audio Player

The following methods are used to create and use audioplayer objects. These objects can be used to play back audio data stored in Octave matrices and arrays. The audioplayer object supports playback from various devices available to the system, blocking and non-blocking playback, convenient pausing and resuming and much more.

: player = audioplayer (y, fs) ¶

: player = audioplayer (y, fs, nbits) ¶

: player = audioplayer (y, fs, nbits, id) ¶

: player = audioplayer (recorder) ¶

: player = audioplayer (recorder, id) ¶

Create an audioplayer object that will play back data y at sample rate fs.

The signal y can be a vector (mono audio) or a two-dimensional array (multi-channel audio).

The optional arguments nbits and id specify the number of bits per sample and player device ID, respectively. Device IDs may be found using the audiodevinfo function.

Given an audiorecorder object recorder, use the data from the object to initialize the player.

The list of actions for an audioplayer object are shown below. All methods require an audioplayer object as the first argument.

Method	Description
get	Read audioplayer property values
isplaying	Return true if audioplayer is playing
pause	Pause audioplayer playback
play	Play audio stored in audioplayer object w/o blocking
playblocking	Play audio stored in audioplayer object
resume	Resume playback after pause
set	Write audioplayer property values
stop	Stop playback

Example

Create an audioplayer object that will play back one second of white noise at 44100 sample rate using 8 bits per sample.

y = 0.25 * randn (2, 44100);
player = audioplayer (y, 44100, 8);
play (player);