En esta página

MediaDevices QML Type

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

Import Statement: import QtMultimedia
In C++: QMediaDevices

Propiedades

Descripción detallada

El tipo MediaDevices 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)

MediaDevices 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 notificando el cambio.

MediaDevices 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, MediaDevices actualizará la salida de audio predeterminada en consecuencia y emitirá una señal. Si el sistema no establece un valor predeterminado para una cámara o una entrada de audio, MediaDevices 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 la reproducción o la grabación de contenido multimedia, a menudo es necesario seleccionar explícitamente el dispositivo que se va a utilizar.

Por ejemplo, el fragmento de código siguiente garantizará que el reproductor multimedia utilice siempre el dispositivo de salida de audio predeterminado del sistema para la reproducción:

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

Véase también Camera, AudioInput y VideoOutput.

Documentación de propiedades

audioInputs : list<audioDevice> [read-only]

Contiene 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.

audioOutputs : list<audioDevice> [read-only]

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

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

defaultAudioInput : audioDevice [read-only]

Devuelve el dispositivo de entrada de audio predeterminado.

El dispositivo predeterminado puede cambiar durante la ejecución de la aplicación. El valor de esta propiedad se ajustará automáticamente a dichos cambios.

defaultAudioOutput : audioDevice [read-only]

Devuelve el dispositivo de salida de audio predeterminado.

El dispositivo predeterminado puede cambiar durante la ejecución de la aplicación. El valor de esta propiedad se ajustará automáticamente a dichos cambios.

defaultVideoInput : cameraDevice [read-only]

Devuelve la cámara predeterminada del sistema.

Nota: El objeto devuelto debe comprobarse mediante isNull() antes de utilizarlo, por si no hubiera ninguna cámara disponible.

El dispositivo predeterminado puede cambiar durante la ejecución de la aplicación. El valor de esta propiedad se ajustará automáticamente a dichos cambios.

videoInputs : list<cameraDevice> [read-only]

Contiene una lista de las cámaras del sistema.

© 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.