QMediaDevices Class

The QMediaDevices class provides information about available multimedia input and output devices. More...

Header: #include <QMediaDevices>
CMake: find_package(Qt6 COMPONENTS Multimedia REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia
Inherits: QObject

Signals

Static Public Members

QList<QAudioDevice> audioInputs()
QList<QAudioDevice> audioOutputs()
QAudioDevice defaultAudioInput()
QAudioDevice defaultAudioOutput()
QCameraDevice defaultVideoInput()
QList<QCameraDevice> videoInputs()

Detailed Description

The QMediaDevices class helps in managing the available multimedia input and output devices. It manages three types of devices:

  • Audio input devices (Microphones)
  • Audio output devices (Speakers, Headsets)
  • Video input devices (Cameras)

QMediaDevices allows listing all available devices and will emit signals when the list of available devices has changed.

While using the default input and output devices is often sufficient for playing back or recording multimedia, there is often a need to explicitly select the device to be used.

QMediaDevices is a singleton object and all getters are thread-safe.

Member Function Documentation

[static] QList<QAudioDevice> QMediaDevices::audioInputs()

Returns a list of available audio input devices on the system.

Those devices are usually microphones, either built-in, or connected to the device through e.g. USB or Bluetooth.

Note: Getter function for property audioInputs.

[static] QList<QAudioDevice> QMediaDevices::audioOutputs()

Returns a list of available audio input devices on the system.

Those devices are usually loudspeakers or head sets, either built-in, or connected to the device through e.g. USB or Bluetooth.

Note: Getter function for property audioOutputs.

[static] QAudioDevice QMediaDevices::defaultAudioInput()

Returns the default audio input device.

The default device can change during the runtime of the application. The audioInputsChanged() signal will get emitted in that case.

Note: Getter function for property defaultAudioInput.

[static] QAudioDevice QMediaDevices::defaultAudioOutput()

Returns the default audio output device.

The default device can change during the runtime of the application. The audioOutputsChanged() signal will get emitted in that case.

Note: Getter function for property defaultAudioOutput.

[static] QCameraDevice QMediaDevices::defaultVideoInput()

Returns the default camera on the system.

The returned object should be checked using isNull() before being used, in case there is no default camera or no cameras at all.

The default device can change during the runtime of the application. The videoInputsChanged() signal will get emitted in that case.

Note: Getter function for property defaultVideoInput.

See also availableCameras().

[static] QList<QCameraDevice> QMediaDevices::videoInputs()

Returns a list of available cameras on the system.

Note: Getter function for property videoInputs.