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.

Propriété Documentation

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 l'intermédiaire d'un port USB ou Bluetooth, par exemple.


audioOutputs : list<audioDevice> [read-only]

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

Ces dispositifs sont généralement des haut-parleurs ou des casques. Les périphériques peuvent être intégrés ou connectés par l'intermédiaire 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 pendant l'exécution de l'application. La valeur de cette propriété s'adaptera automatiquement à ces changements.


defaultVideoInput : cameraDevice [read-only]

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

Le dispositif 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.


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