Skip to content

Most visited

Recently visited

navigation

AudioDeviceInfo

public final class AudioDeviceInfo
extends Object

java.lang.Object
   ↳ android.media.AudioDeviceInfo


Class to provide information about the audio devices.

Summary

Constants

int TYPE_AUX_LINE

A device type describing the auxiliary line-level connectors.

int TYPE_BLUETOOTH_A2DP

A device type describing a Bluetooth device supporting the A2DP profile.

int TYPE_BLUETOOTH_SCO

A device type describing a Bluetooth device typically used for telephony.

int TYPE_BUILTIN_EARPIECE

A device type describing the attached earphone speaker.

int TYPE_BUILTIN_MIC

A device type describing the microphone(s) built in a device.

int TYPE_BUILTIN_SPEAKER

A device type describing the speaker system (i.e.

int TYPE_BUS

A type-agnostic device used for communication with external audio systems

int TYPE_DOCK

A device type describing the audio device associated with a dock.

int TYPE_FM

A device type associated with the transmission of audio signals over FM.

int TYPE_FM_TUNER

A device type for accessing the audio content transmitted over FM.

int TYPE_HDMI

A device type describing an HDMI connection .

int TYPE_HDMI_ARC

A device type describing the Audio Return Channel of an HDMI connection.

int TYPE_IP

A device type connected over IP.

int TYPE_LINE_ANALOG

A device type describing an analog line-level connection.

int TYPE_LINE_DIGITAL

A device type describing a digital line connection (e.g.

int TYPE_TELEPHONY

A device type describing the transmission of audio signals over the telephony network.

int TYPE_TV_TUNER

A device type for accessing the audio content transmitted over the TV tuner system.

int TYPE_UNKNOWN

A device type associated with an unknown or uninitialized device.

int TYPE_USB_ACCESSORY

A device type describing a USB audio device in accessory mode.

int TYPE_USB_DEVICE

A device type describing a USB audio device.

int TYPE_USB_HEADSET

A device type describing a USB audio headset.

int TYPE_WIRED_HEADPHONES

A device type describing a pair of wired headphones.

int TYPE_WIRED_HEADSET

A device type describing a headset, which is the combination of a headphones and microphone.

Public methods

int[] getChannelCounts()
int[] getChannelIndexMasks()
int[] getChannelMasks()
int[] getEncodings()
int getId()
CharSequence getProductName()
int[] getSampleRates()
int getType()
boolean isSink()
boolean isSource()

Inherited methods

From class java.lang.Object

Constants

TYPE_AUX_LINE

added in API level 23
int TYPE_AUX_LINE

A device type describing the auxiliary line-level connectors.

Constant Value: 19 (0x00000013)

TYPE_BLUETOOTH_A2DP

added in API level 23
int TYPE_BLUETOOTH_A2DP

A device type describing a Bluetooth device supporting the A2DP profile.

Constant Value: 8 (0x00000008)

TYPE_BLUETOOTH_SCO

added in API level 23
int TYPE_BLUETOOTH_SCO

A device type describing a Bluetooth device typically used for telephony.

Constant Value: 7 (0x00000007)

TYPE_BUILTIN_EARPIECE

added in API level 23
int TYPE_BUILTIN_EARPIECE

A device type describing the attached earphone speaker.

Constant Value: 1 (0x00000001)

TYPE_BUILTIN_MIC

added in API level 23
int TYPE_BUILTIN_MIC

A device type describing the microphone(s) built in a device.

Constant Value: 15 (0x0000000f)

TYPE_BUILTIN_SPEAKER

added in API level 23
int TYPE_BUILTIN_SPEAKER

A device type describing the speaker system (i.e. a mono speaker or stereo speakers) built in a device.

Constant Value: 2 (0x00000002)

TYPE_BUS

added in API level 24
int TYPE_BUS

A type-agnostic device used for communication with external audio systems

Constant Value: 21 (0x00000015)

TYPE_DOCK

added in API level 23
int TYPE_DOCK

A device type describing the audio device associated with a dock.

Constant Value: 13 (0x0000000d)

TYPE_FM

added in API level 23
int TYPE_FM

A device type associated with the transmission of audio signals over FM.

Constant Value: 14 (0x0000000e)

TYPE_FM_TUNER

added in API level 23
int TYPE_FM_TUNER

A device type for accessing the audio content transmitted over FM.

Constant Value: 16 (0x00000010)

TYPE_HDMI

added in API level 23
int TYPE_HDMI

A device type describing an HDMI connection .

Constant Value: 9 (0x00000009)

TYPE_HDMI_ARC

added in API level 23
int TYPE_HDMI_ARC

A device type describing the Audio Return Channel of an HDMI connection.

Constant Value: 10 (0x0000000a)

TYPE_IP

added in API level 23
int TYPE_IP

A device type connected over IP.

Constant Value: 20 (0x00000014)

TYPE_LINE_ANALOG

added in API level 23
int TYPE_LINE_ANALOG

A device type describing an analog line-level connection.

Constant Value: 5 (0x00000005)

TYPE_LINE_DIGITAL

added in API level 23
int TYPE_LINE_DIGITAL

A device type describing a digital line connection (e.g. SPDIF).

Constant Value: 6 (0x00000006)

TYPE_TELEPHONY

added in API level 23
int TYPE_TELEPHONY

A device type describing the transmission of audio signals over the telephony network.

Constant Value: 18 (0x00000012)

TYPE_TV_TUNER

added in API level 23
int TYPE_TV_TUNER

A device type for accessing the audio content transmitted over the TV tuner system.

Constant Value: 17 (0x00000011)

TYPE_UNKNOWN

added in API level 23
int TYPE_UNKNOWN

A device type associated with an unknown or uninitialized device.

Constant Value: 0 (0x00000000)

TYPE_USB_ACCESSORY

added in API level 23
int TYPE_USB_ACCESSORY

A device type describing a USB audio device in accessory mode.

Constant Value: 12 (0x0000000c)

TYPE_USB_DEVICE

added in API level 23
int TYPE_USB_DEVICE

A device type describing a USB audio device.

Constant Value: 11 (0x0000000b)

TYPE_USB_HEADSET

int TYPE_USB_HEADSET

A device type describing a USB audio headset.

Constant Value: 22 (0x00000016)

TYPE_WIRED_HEADPHONES

added in API level 23
int TYPE_WIRED_HEADPHONES

A device type describing a pair of wired headphones.

Constant Value: 4 (0x00000004)

TYPE_WIRED_HEADSET

added in API level 23
int TYPE_WIRED_HEADSET

A device type describing a headset, which is the combination of a headphones and microphone.

Constant Value: 3 (0x00000003)

Public methods

getChannelCounts

added in API level 23
int[] getChannelCounts ()

Returns
int[] An array of channel counts (1, 2, 4, ...) for which this audio device can be configured. Note: an empty array indicates that the device supports arbitrary channel counts.

getChannelIndexMasks

added in API level 23
int[] getChannelIndexMasks ()

Returns
int[] An array of channel index masks for which this audio device can be configured.

See also:

getChannelMasks

added in API level 23
int[] getChannelMasks ()

Returns
int[] An array of channel position masks (e.g. CHANNEL_IN_STEREO, CHANNEL_OUT_7POINT1) for which this audio device can be configured.

See also:

getEncodings

added in API level 23
int[] getEncodings ()

Returns
int[] An array of audio encodings (e.g. ENCODING_PCM_16BIT, ENCODING_PCM_FLOAT) supported by the audio device. ENCODING_PCM_FLOAT indicates the device supports more than 16 bits of integer precision. As there is no AudioFormat constant specifically defined for 24-bit PCM, the value ENCODING_PCM_FLOAT indicates that AudioTrack or AudioRecord can preserve at least 24 bits of integer precision to that device.

See also:

getId

added in API level 23
int getId ()

Returns
int The internal device ID.

getProductName

added in API level 23
CharSequence getProductName ()

Returns
CharSequence The human-readable name of the audio device.

getSampleRates

added in API level 23
int[] getSampleRates ()

Returns
int[] An array of sample rates supported by the audio device. Note: an empty array indicates that the device supports arbitrary rates.

getType

added in API level 23
int getType ()

Returns
int The device type identifier of the audio device (i.e. TYPE_BUILTIN_SPEAKER).

isSink

added in API level 23
boolean isSink ()

Returns
boolean true if the audio device is a sink for audio data (i.e. an output).

isSource

added in API level 23
boolean isSource ()

Returns
boolean true if the audio device is a source for audio data (e.e an input).
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.