Record and Play Audio
Record and play audio data for processing in MATLAB® from audio input and output devices on your system. Audio playback and recording in MATLAB Online™ and MATLAB Web App Server™ are supported in Google Chrome®.
Record data from an audio input device such as a microphone connected to your system:
recordreturns immediate control to the calling function or the command prompt even as recording proceeds. Specify the length of the recording in seconds, or end the recording with the
stopmethod. Optionally, call the
resumemethods. The recording is performed asynchronously.
recordblockingretains control until the recording is complete. Specify the length of the recording in seconds. The recording is performed synchronously.
Create a numeric array corresponding to the signal data using the
The following examples show how to use the
Record Microphone Input
This example shows how to record microphone input, play back the recording, and store the recorded audio signal in a numeric array. You must first connect a microphone to your system.
audiorecorder object with default
recObj for recording audio
recObj = audiorecorder
recObj = audiorecorder with properties: SampleRate: 8000 BitsPerSample: 8 NumChannels: 1 DeviceID: -1 CurrentSample: 1 TotalSamples: 0 Running: 'off' StartFcn:  StopFcn:  TimerFcn:  TimerPeriod: 0.0500 Tag: '' UserData:  Type: 'audiorecorder'
audiorecorder creates an 8000 Hz, 8-bit,
Record your voice for 5 seconds.
recDuration = 5; disp("Begin speaking.") recordblocking(recObj,recDuration); disp("End of recording.")
Play the recording.
Store data in double-precision array
y = getaudiodata(recObj);
Plot the audio samples.
Record Two Channels from Different Sound Cards
To record audio independently from two different sound cards, with a microphone connected to each:
audiodevinfoto list the available sound cards. For example, this code returns a structure array containing all input and output audio devices on your system.Identify the sound cards you want to use by name, and note their
info = audiodevinfo;
audiorecorderobjects. For example, this code creates the
recorder1for recording a single channel from device 3 at 44.1 kHz and 16 bits per sample. The code then creates the
recorder2for recording a single channel from device 4 at 48 kHz.
recorder1 = audiorecorder(44100,16,1,3); recorder2 = audiorecorder(48000,16,1,4);
Record each audio channel separately.The recordings occur simultaneously as the first call to
record(recorder1); record(recorder2); pause(5);
recorddoes not block.
Stop the recordings.
Specify the Quality of the Recording
By default, an
audiorecorder object uses a sample rate of
8000 Hz, a depth of 8 bits (8 bits per sample), and a single audio channel. With
these settings, the required amount of data storage is low. For higher quality
recordings, increase the sample rate or bit depth.
For example, compact disks use a sample rate of 44,100 Hz, a 16-bit depth, and
two audio channels. Create an
audiorecorder object to record
with those settings.
myRecObj = audiorecorder(44100,16,2);
For more information on the available properties and values, see the
After you import or record audio, MATLAB supports several ways to listen to the data:
For simple playback using a single function call, use
soundsc. For example, load a sample MAT-file that contains signal and sample rate data, and listen to the audio.
load chirp.mat sound(y,Fs)
For more flexibility during playback, including the ability to pause, resume, or define callbacks, use the
audioplayerfunction. Create an
audioplayerobject, then call methods to play the audio. For example, listen to the
load gong.mat gong = audioplayer(y,Fs); play(gong);
For an additional example, see Record or Play Audio within a Function.
If you do not specify the sample rate,
sound plays back at
8192 Hz. For any playback, specify smaller sample rates to play back more slowly,
and larger sample rates to play back more quickly.
Most sound cards support sample rates between approximately 5000 and 192,000 Hz. Specifying sample rates outside this range can produce unexpected results.
Record or Play Audio within a Function
If you create an
object inside a function, the object exists only for the duration of the function.
For example, create a player function called
playFile and a
simple callback function
function playFile(myfile) load(myfile) obj = audioplayer(y,Fs); obj.TimerFcn = 'showSeconds'; obj.TimerPeriod = 1; play(obj); end function showSeconds disp("tick") end
playFile from the command prompt to play the file
At the recorded sample rate of 8192 samples per second, playing the 73,113 samples
in the file takes approximately 8.9 seconds. However, the
playFile function typically ends before playback completes,
and clears the
For complete playback or recording, consider these options:
record. The blocking methods retain control until playing or recording completes. If you block control, you cannot issue any other commands or methods (such as
resume) during the playback or recording.
Create an output argument for your function that generates an object in the base workspace. For example, modify the
playFilefunction to include an output argument.
function obj = playFile(myfile)
Call the function.
h = playFile("handel.mat");
hexists in the base workspace, you can pause playback from the command prompt.