Main Content

sound

Convert matrix of signal data to sound

Description

example

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

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 example data y and sample rate Fs, and play 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 bit depth is supported on your system.

Input Arguments

collapse all

Audio data, specified as an m-by-1 numeric column vector for single-channel (mono) audio, or an m-by-2 numeric matrix for stereo audio, 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 to the right channel. Stereo playback is available only if your system supports it.

Data Types: double

Sample rate in hertz (Hz), specified as a positive scalar.

Valid values of the sample rate depend on the audio hardware of your system. Typical sample rates supported by most setups are 8000, 11,025, 22,050, 44,100, 48,000, 96,000, and 192,000 Hz.

Data Types: single | double

Bits per sample, specified as 16, 8, or 24.

Valid values of nBits depend on the audio hardware of your system.

Limitations

  • In MATLAB® Online™ or MATLAB Web App Server™, sound ignores nBits. Instead, it plays audio data using the default number of bits per sample of the output audio device.

Tips

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

  • sound in MATLAB Online and MATLAB Web App Server is supported in Google Chrome™.

  • Note

    Security Considerations When Using MATLAB Online or MATLAB Web App Server: When using sound in MATLAB Online or MATLAB Web App Server, certain features and settings help you keep control of your privacy.

    To reduce the likelihood of unwanted applications using your microphone, turn off automatic access to your audio device. You can change these settings at any time. After granting permission to a website once, your browser may be able to access your microphone automatically for that site on future visits. Use the browser settings for Google Chrome to revoke access for specific sites after you have initially allowed access.

    You can also access the MATLAB Online website or MATLAB Web App Server using the private browsing mode in Google Chrome. When you do this, Chrome™ automatically asks you for permission to access your microphone every time you open the MATLAB Online site or MATLAB Web App Server and run sound, regardless of your browser settings.

Version History

Introduced before R2006a