QMediaDevices Class

Detaillierte Beschreibung

Die Klasse QMediaDevices liefert Informationen über die verfügbaren Multimedia-Geräte und die Systemvorgaben. Sie überwacht die folgenden drei Gruppen:

• Audio-Eingabegeräte (Mikrofone)
• Audio-Ausgabegeräte (Lautsprecher, Headsets)
• Video-Eingabegeräte (Kameras)

QMediaDevices stellt für jede Gerätegruppe eine eigene Liste bereit. Wenn QMediaDevices feststellt, dass ein neues Gerät an das System angeschlossen oder ein angeschlossenes Gerät vom System getrennt wurde, aktualisiert es die entsprechende Geräteliste und gibt ein Signal aus, das über die Änderung informiert.

Die Funktionen QMediaDevices::audioInputs und QMediaDevices::audioOutputs können verwendet werden, um alle Mikrofone und Lautsprecher/Headsets im System aufzulisten. Dieses Beispiel ruft zunächst eine Liste aller angeschlossenen Mikrofone ab und gibt dann deren Kennung und Beschreibung aus sowie die Angabe, ob es sich um das Standardgerät handelt oder nicht.

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;
}

In ähnlicher Weise gibt QMediaDevices::videoInputs eine Liste aller angeschlossenen Kameras aus. In diesem Beispiel werden alle angeschlossenen Kameras mit ihrer Kennung und Beschreibung aufgelistet, und es wird angegeben, ob es sich um die Standardkamera handelt oder nicht.

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 überwacht die Systemvorgaben für jede Gerätegruppe. Es benachrichtigt über alle Änderungen, die über die Systemeinstellungen vorgenommen werden. Wenn der Benutzer beispielsweise in den Systemeinstellungen einen neuen Standard-Audioausgang auswählt, aktualisiert QMediaDevices den Standard-Audioausgang entsprechend und gibt ein Signal aus. Wenn das System keinen Standard für eine Kamera oder einen Audioeingang vorsieht, wählt QMediaDevices das erste Gerät aus der Liste als Standardgerät aus.

Obwohl die Verwendung der Standard-Eingabe- und -Ausgabegeräte für die Wiedergabe oder Aufzeichnung von Multimedia-Inhalten oft ausreicht, besteht oft die Notwendigkeit, das zu verwendende Gerät explizit auszuwählen.

QMediaDevices ist ein Singleton-Objekt und alle Getter sind thread-sicher.