QMediaDevices Class

Description détaillée

La classe QMediaDevices fournit des informations sur les périphériques multimédias disponibles et les valeurs par défaut du système. Elle surveille les trois groupes suivants :

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

QMediaDevices 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 mettra à jour la liste de périphériques correspondante et émettra un signal notifiant le changement.

Les fonctions QMediaDevices::audioInputs et QMediaDevices::audioOutputs peuvent être utilisées pour énumérer tous les microphones et haut-parleurs/casques du système. Cet exemple commence par obtenir une liste de tous les microphones connectés, puis affiche leur identifiant, leur description et indique s'il s'agit du périphérique par défaut ou non.

const QList<QAudioDevice> audioDevices = QMediaDevices::audioInputs();
for (const QAudioDevice &device : audioDevices)
{
    out << "ID: " << device.id() << Qt::endl;
    out << "Description: " << device.description() << Qt::endl;
    out << "Is default: " << (device.isDefault() ? "Yes" : "No") << Qt::endl;
}

De même, le site QMediaDevices::videoInputs renvoie une liste de toutes les caméras connectées. Dans cet exemple, nous listons toutes les caméras connectées, leur identifiant, leur description et nous indiquons s'il s'agit de la caméra par défaut ou non.

const QList<QCameraDevice> videoDevices = QMediaDevices::videoInputs();
for (const QCameraDevice &device : videoDevices)
{
    out << "ID: " << device.id() << Qt::endl;
    out << "Description: " << device.description() << Qt::endl;
    out << "Is default: " << (device.isDefault() ? "Yes" : "No") << Qt::endl;
}

QMediaDevices surveille les paramètres par défaut du système pour chaque groupe de périphériques. Il notifie tout changement effectué dans les 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, QMediaDevices 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, QMediaDevices 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.

QMediaDevices est un objet singleton et toutes les fonctions d'acquisition sont sûres pour les threads.