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
- audioInputs : list<audioDevice>
- audioOutputs : list<audioDevice>
- defaultAudioInput : audioDevice
- defaultAudioOutput : audioDevice
- defaultVideoInput : cameraDevice
- videoInputs : list<cameraDevice>
Descripción detallada
El tipo MediaDevices proporciona información sobre los dispositivos multimedia disponibles y los 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 separada 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 monitoriza los valores por defecto 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 proporciona un valor predeterminado para una cámara o una entrada de audio, MediaDevices seleccionará el primer dispositivo de la lista como el dispositivo predeterminado.
Aunque utilizar los dispositivos de entrada y salida predeterminados suele ser suficiente para reproducir o grabar multimedia, a menudo es necesario seleccionar explícitamente el dispositivo que se va a utilizar.
Por ejemplo, el siguiente fragmento de código 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. Los dispositivos pueden estar incorporados o conectados a través de, por ejemplo, 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 a través de, por ejemplo, USB o Bluetooth.
defaultAudioInput : audioDevice [read-only]
Devuelve el dispositivo de entrada de audio por defecto.
El dispositivo por defecto puede cambiar durante el tiempo de 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 por defecto.
El dispositivo por defecto puede cambiar durante el tiempo de 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 por defecto del sistema.
Nota: El objeto devuelto debe comprobarse mediante isNull() antes de ser utilizado, en caso de que no haya ninguna cámara disponible.
El dispositivo por defecto puede cambiar durante el tiempo de 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.
