En esta página

QMediaDevices Class

La clase QMediaDevices proporciona información sobre los dispositivos multimedia de entrada y salida disponibles. Más información...

Encabezado: #include <QMediaDevices>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia
En QML: MediaDevices
Heredan de: QObject

Propiedades

Señales

Miembros públicos estáticos

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

Descripción detallada

La clase QMediaDevices proporciona información sobre los dispositivos multimedia disponibles y los valores predeterminados del sistema. Supervisa los tres grupos siguientes:

  • Dispositivos de entrada de audio (micrófonos)
  • Dispositivos de salida de audio (altavoces, auriculares)
  • Dispositivos de entrada de vídeo (cámaras)

QMediaDevices proporciona una lista independiente para cada grupo de dispositivos. Si detecta que se ha conectado un nuevo dispositivo al sistema o que un dispositivo conectado se ha desconectado del sistema, actualizará la lista de dispositivos correspondiente y emitirá una señal para notificar el cambio.

Las funciones ` QMediaDevices::audioInputs ` y ` QMediaDevices::audioOutputs ` se pueden utilizar para enumerar todos los micrófonos y altavoces/auriculares del sistema. En este ejemplo, primero se obtiene una lista de todos los micrófonos conectados y, a continuación, se muestran su identificador, su descripción y si se trata del dispositivo predeterminado o no.

const QList<QAudioDevice> audioDevices = QMediaDevices::audioInputs();
for (const QAudioDevice &device : audioDevices)
{
    out << "ID: " << device.id() << Qt::endl;
    out << "Description: " << device.description() << Qt::endl;
    out << "Is default: " << (device.isDefault() ? "Yes" : "No") << Qt::endl;
}

Del mismo modo, la función QMediaDevices::videoInputs devolverá una lista de todas las cámaras conectadas. En este ejemplo, enumeramos todas las cámaras conectadas junto con su identificador, descripción y si se trata de la cámara predeterminada o no.

const QList<QCameraDevice> videoDevices = QMediaDevices::videoInputs();
for (const QCameraDevice &device : videoDevices)
{
    out << "ID: " << device.id() << Qt::endl;
    out << "Description: " << device.description() << Qt::endl;
    out << "Is default: " << (device.isDefault() ? "Yes" : "No") << Qt::endl;
}

QMediaDevices supervisa los valores predeterminados del sistema para cada grupo de dispositivos. Notificará cualquier cambio realizado a través de la configuración del sistema. Por ejemplo, si el usuario selecciona una nueva salida de audio predeterminada en la configuración del sistema, QMediaDevices actualizará la salida de audio predeterminada en consecuencia y emitirá una señal. Si el sistema no proporciona un valor predeterminado para una cámara o una entrada de audio, QMediaDevices seleccionará el primer dispositivo de la lista como dispositivo predeterminado.

Aunque el uso de los dispositivos de entrada y salida predeterminados suele ser suficiente para reproducir o grabar contenido multimedia, a menudo es necesario seleccionar explícitamente el dispositivo que se va a utilizar.

Los métodos estáticos de QMediaDevices son seguros para subprocesos y hacen referencia a un objeto singleton subyacente.

Nota: En la plataforma WebAssembly, debido a su naturaleza asíncrona, las listas de dispositivos solo estarán disponibles tras recibir las notificaciones « audioInputsChanged », «audioOutputsChanged» o « videoInputsChanged ».

Documentación de propiedades

[read-only] audioInputs : QList<QAudioDevice>

Devuelve una lista de los dispositivos de entrada de audio disponibles en el sistema.

Estos dispositivos suelen ser micrófonos. Pueden ser dispositivos integrados o conectados, por ejemplo, a través de USB o Bluetooth.

Funciones de acceso:

QList<QAudioDevice> audioInputs()

Señal de notificación:

void audioInputsChanged()

[read-only] audioOutputs : QList<QAudioDevice>

Devuelve una lista de los dispositivos de salida de audio disponibles en el sistema.

Estos dispositivos suelen ser altavoces o auriculares. Los dispositivos pueden ser integrados o conectarse, por ejemplo, a través de USB o Bluetooth.

Funciones de acceso:

QList<QAudioDevice> audioOutputs()

Señal de notificación:

void audioOutputsChanged()

[read-only] defaultAudioInput : QAudioDevice

Devuelve el dispositivo de entrada de audio predeterminado.

El dispositivo predeterminado puede cambiar durante la ejecución de la aplicación. En ese caso, se emite la señal « audioInputsChanged()».

Funciones de acceso:

QAudioDevice defaultAudioInput()

Señal de notificación:

[read-only] defaultAudioOutput : QAudioDevice

Devuelve el dispositivo de salida de audio predeterminado.

El dispositivo predeterminado puede cambiar durante la ejecución de la aplicación. En este caso, se emite la señal « audioOutputsChanged()».

Funciones de acceso:

QAudioDevice defaultAudioOutput()

Señal de notificación:

[read-only] defaultVideoInput : QCameraDevice

Devuelve la cámara predeterminada del sistema.

Nota: Se debe comprobarel objeto devuelto mediante isNull() antes de utilizarlo, por si no hubiera ninguna cámara predeterminada o no hubiera ninguna cámara.

El dispositivo predeterminado puede cambiar durante la ejecución de la aplicación. En ese caso, se emite la señal ` videoInputsChanged()`.

Funciones de acceso:

QCameraDevice defaultVideoInput()

Señal de notificador:

Véase también videoInputs().

[read-only] videoInputs : QList<QCameraDevice>

Devuelve una lista de las cámaras disponibles en el sistema.

Funciones de acceso:

QList<QCameraDevice> videoInputs()

Señal de notificación:

void videoInputsChanged()

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.