QMediaDevices Class

Descripción Detallada

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

• 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 separada para cada grupo de dispositivos. Si detecta que un nuevo dispositivo se ha conectado al sistema o que un dispositivo conectado se ha desconectado del sistema, actualizará la lista de dispositivos correspondiente y emitirá una señal notificando el cambio.

Las funciones QMediaDevices::audioInputs y QMediaDevices::audioOutputs pueden utilizarse para enumerar todos los micrófonos y altavoces/auriculares del sistema. Este ejemplo primero obtiene una lista de todos los micrófonos conectados, y luego imprime su identificador, descripción, y si es el dispositivo por defecto 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;
}

De forma similar, QMediaDevices::videoInputs devolverá una lista de todas las cámaras conectadas. En este ejemplo listamos todas las cámaras conectadas y su identificador, descripción, y si es la cámara por defecto 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 monitoriza los valores por defecto del sistema para cada grupo de dispositivos. Se notificará acerca de cualquier cambio realizado a través de la configuración del sistema. Por ejemplo, si el usuario selecciona una nueva salida de audio por defecto en la configuración del sistema, QMediaDevices actualizará la salida de audio por defecto 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 el dispositivo predeterminado.

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

QMediaDevices es un objeto singleton y todos los getters son thread-safe.