MediaDevices QML Type

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

• Liste de tous les membres, y compris les membres hérités

Propriétés

• audioInputs : list<audioDevice>
• audioOutputs : list<audioDevice>
• defaultAudioInput : audioDevice
• defaultAudioOutput : audioDevice
• defaultVideoInput : cameraDevice
• videoInputs : list<cameraDevice>

Description détaillée

Le type MediaDevices fournit des informations sur les périphériques multimédias disponibles et les paramètres 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 des périphériques correspondante et émet un signal signalant le changement.

MediaDevices surveille les paramètres par défaut du système pour chaque groupe de périphériques. Il signale toute modification effectuée via les paramètres système. Par exemple, si l’utilisateur sélectionne une nouvelle sortie audio par défaut dans les paramètres système, MediaDevices mettra à jour la sortie audio par défaut en conséquence et émettra 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 comme 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 la lecture ou l’enregistrement de contenu multimédia, il est souvent nécessaire de sélectionner explicitement le périphérique à utiliser.

Par exemple, l’extrait de code ci-dessous garantira 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 la liste des périphériques d'entrée audio disponibles sur le système.

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

audioOutputs : list<audioDevice> [read-only]

Contient la 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. Ils peuvent être intégrés au système ou connectés, par exemple via USB ou Bluetooth.

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 pendant 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'adapte automatiquement à ces changements.

defaultVideoInput : cameraDevice [read-only]

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

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.

videoInputs : list<cameraDevice> [read-only]

Contient la liste des caméras présentes sur le système.