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);
See also: @audioplayer/get, @audioplayer/isplaying, @audioplayer/pause, @audioplayer/play, @audioplayer/playblocking, @audioplayer/resume, @audioplayer/set, @audioplayer/stop, audiodevinfo, @audiorecorder/audiorecorder, sound, soundsc.