This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

getAudioDevices

List available audio devices

Syntax

devices = getAudioDevices(obj)

Description

example

devices = getAudioDevices(obj) returns a list of audio devices that are available and compatible with your audio I/O object, obj.

Examples

collapse all

Create an audioDeviceReader System object™, and then call getAudioDevices on your object.

deviceReader = audioDeviceReader;
devices = getAudioDevices(deviceReader)

Create an audioDeviceWriter System object™, and then call getAudioDevices on your object.

deviceWriter = audioDeviceWriter;
devices = getAudioDevices(deviceWriter)

Create an audioPlayerRecorder System object™, and then call getAudioDevices on your object.

playRec = audioPlayerRecorder;
devices = getAudioDevices(playRec)

Input Arguments

collapse all

Audio I/O object, specified as an object of audioDeviceReader, audioDeviceWriter, or audioPlayerRecorder.

Data Types: object

Output Arguments

collapse all

List of available and compatible devices.

For audioDeviceReader and audioDeviceWriter, the list of audio devices depends on the specified Driver property of your object.

For audioPlayerRecorder, the audio devices listed support full-duplex mode and have a platform-appropriate driver:

  • Windows® –– ASIO™

  • Mac –– CoreAudio

  • Linux® –– ALSA

Data Types: cell

Tips

Devices are persistent within a MATLAB® session. To recognize new devices within your MATLAB session, clear device data within your session using the command line. As an example, if you have created an audioDeviceReader System object™, you can type the following into your command line:

>> deviceReader = audioDeviceReader;
>> devices = getAudioDevices(deviceReader)
devices =

  1×1 cell array

    {'No audio input device detected'}

This displays a list of the devices connected to your computer. To add more devices, connect the additional devices to your computer. Then, type the following into your command line:

>> clear deviceReader dspAudioDeviceInfo
>> deviceReader = audioDeviceReader;
>> devices = getAudioDevices(deviceReader)
devices =

  1×3 cell array

    {'Default'}    {'Primary Sound Capture Driver'}    {'Headset Microphone (Plantro…'}

This displays an updated list of the devices connected to your computer, including the devices you added during your current session. This process also works with the audioDeviceWriter and audioPlayerRecorder System objects.

Introduced in R2016a