QMediaDevices Class

Description détaillée

La classe QMediaDevices fournit des informations sur les périphériques multimédias disponibles et les paramètres par défaut du système. Elle 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)

QMediaDevices fournit une liste distincte pour chaque groupe de périphériques. Si elle 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é, elle met à jour la liste des périphériques correspondante et émet un signal signalant ce changement.

Les fonctions ` QMediaDevices::audioInputs ` et ` QMediaDevices::audioOutputs ` permettent de répertorier tous les microphones et haut-parleurs/casques présents sur le système. Cet exemple récupère d’abord la liste de tous les microphones connectés, puis affiche leur identifiant, leur description et indique s’il s’agit ou non du périphérique par défaut.

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, la fonction ` QMediaDevices::videoInputs ` renvoie une liste de toutes les caméras connectées. Dans cet exemple, nous répertorions toutes les caméras connectées ainsi que leur identifiant, leur description et si elles sont ou non la caméra par défaut.

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 signalera 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, 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 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.

Les méthodes statiques de QMediaDevices sont thread-safe et font référence à un objet singleton sous-jacent.