Sur cette page

MediaDevices QML Type

MediaDevices fournit des informations sur les périphériques d'entrée et de sortie multimédia disponibles. Plus d'informations...

Import Statement: import QtMultimedia
In C++: QMediaDevices

Propriétés

Description détaillée

Le type MediaDevices fournit des informations sur les périphériques multimédias disponibles et les valeurs par défaut du système. Il surveille les trois groupes suivants :

  • Périphériques d'entrée audio (microphones)
  • Périphériques de sortie audio (haut-parleurs, casques)
  • Périphériques d'entrée vidéo (caméras)

MediaDevices fournit une liste distincte pour chaque groupe de périphériques. S'il détecte qu'un nouveau périphérique a été connecté au système ou qu'un périphérique connecté a été déconnecté du système, il met à jour la liste de périphériques correspondante et émet un signal notifiant le changement.

MediaDevices surveille les valeurs par défaut du système pour chaque groupe de périphériques. Il notifie toute modification apportée aux paramètres du système. Par exemple, si l'utilisateur sélectionne une nouvelle sortie audio par défaut dans les paramètres du système, MediaDevices met à jour la sortie audio par défaut en conséquence et émet un signal. Si le système ne fournit pas de valeur par défaut pour une caméra ou une entrée audio, MediaDevices sélectionnera le premier périphérique de la liste en tant que périphérique par défaut.

Bien que l'utilisation des périphériques d'entrée et de sortie par défaut soit souvent suffisante pour lire ou enregistrer des données multimédias, il est souvent nécessaire de sélectionner explicitement le périphérique à utiliser.

Par exemple, l'extrait ci-dessous garantit que le lecteur multimédia utilise toujours le périphérique de sortie audio par défaut du système pour la lecture :

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

Voir également Camera, AudioInput, et VideoOutput.

Documentation sur les propriétés

audioInputs : list<audioDevice> [read-only]

Contient une liste des périphériques d'entrée audio disponibles sur le système.

Ces périphériques sont généralement des microphones. Les périphériques peuvent être soit intégrés, soit connectés par exemple via USB ou Bluetooth.

audioOutputs : list<audioDevice> [read-only]

Contient une liste des périphériques de sortie audio disponibles sur le système.

Ces périphériques sont généralement des haut-parleurs ou des casques. Les périphériques peuvent être intégrés ou connectés par le biais d'un port USB ou Bluetooth, par exemple.

defaultAudioInput : audioDevice [read-only]

Renvoie le périphérique d'entrée audio par défaut.

Le périphérique par défaut peut changer au cours de l'exécution de l'application. La valeur de cette propriété s'adaptera automatiquement à ces changements.

defaultAudioOutput : audioDevice [read-only]

Renvoie le périphérique de sortie audio par défaut.

Le périphérique par défaut peut changer au cours de l'exécution de l'application. La valeur de cette propriété s'adaptera automatiquement à ces changements.

defaultVideoInput : cameraDevice [read-only]

Renvoie la caméra par défaut du système.

Remarque : l'objet renvoyé doit être vérifié à l'aide de la fonction isNull() avant d'être utilisé, au cas où il n'y aurait pas de caméra disponible.

L'appareil par défaut peut changer au cours de l'exécution de l'application. La valeur de cette propriété s'adaptera automatiquement à ces changements.

videoInputs : list<cameraDevice> [read-only]

Contient une liste des caméras du système.

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