sound

Convert matrix of signal data to sound

Syntax

sound(y)
sound(y,Fs)
sound(y,Fs,nBits)

Description

example

sound(y) sends audio signal y to the speaker at the default sample rate of 8192 hertz.

example

sound(y,Fs) sends audio signal y to the speaker at sample rate Fs.

example

sound(y,Fs,nBits) uses nBits bits per sample for audio signal y.

Examples

collapse all

Load the example file gong.mat, which contains sample data y and rate Fs, and listen to the audio.

load gong.mat;
sound(y);

Play an excerpt from Handel's “Hallelujah Chorus” at twice the recorded sample rate.

load handel.mat;
sound(y, 2*Fs);
load handel.mat;
nBits = 16;
sound(y,Fs,nBits);

MATLAB® plays the audio with a bit depth of 16 bits per sample, if this is supported on your system.

Input Arguments

collapse all

Audio data, specified as an m-by-1 column vector for single-channel (mono) audio, or an m-by-2 matrix for stereo playback, where m is the number of audio samples. If y is an m-by-2 matrix, then the first column corresponds to the left channel, and the second column corresponds to the right channel. Stereo playback is available only if your system supports it.

Data Types: double

Sample rate, in hertz, of audio data y, is specified as a positive number from 1000 through 384000. Valid values depend on both the sample rates permitted by MATLAB® and the specific audio hardware on your system. MATLAB has a hard restriction of 1000 Hz <= Fs <= 384000 Hz, although further hardware-dependent restrictions apply.

Data Types: single | double

Bit depth of the sample values, specified as an integer. Valid values depend on the audio hardware installed. Most platforms support bit depths of 8 bits or 16 bits.

Tips

  • The sound function supports sound devices on all Windows® and most UNIX® platforms.

  • Most sound cards support sample rates between 5 and 48 kilohertz. Specifying a sample rate outside this range might produce unexpected results.

Introduced before R2006a