- Qt 6.8
- Qt Multimedia
- QML Types
- audioDevice
- Qt 6.8.3 Reference Documentation

# audioDevice QML Value Type

Describes an audio device. More...

Import Statement: | `import QtMultimedia`

## Properties

- description : string
- id : string
- isDefault : bool
- mode : enumeration

## Detailed Description

The audioDevice value type describes the properties of an audio device that is connected to the system.

The audioDevice instance retains its properties throughout its lifetime, even if the corresponding physical device is disconnected or its settings are modified. To keep track of updated properties, the user should load new instances of audioDevice from MediaDevices when the relevant signals are fired.

The list of audio input or output devices can be queried from the MediaDevices type. To select a certain audio device for input or output set it as the device on AudioInput or AudioOutput.

     MediaPlayer {
         audioOutput: AudioOutput {
             device: mediaDevices.defaultAudioOutput
         }
     }
     MediaDevices {
         id: mediaDevices
     }

## Property Documentation

description : string

Holds a human readable name of the audio device.

Use this string to present the device to the user.

id : string

Holds an identifier for the audio device.

Device names vary depending on the platform/audio plugin being used.

They are a unique identifier for the audio device.

isDefault : bool

Is true if this is the default audio device.

mode : enumeration

Holds whether this device is an input or output device.

The returned value can be one of the following:

Constant | Description
--- | ---
`audioDevice.Null` | A null device.
`audioDevice.Input` | input device.
`audioDevice.Output` | An output device.