QMediaDevices Class

Ausführliche Beschreibung

Die Klasse „QMediaDevices“ liefert Informationen zu den verfügbaren Multimedia-Geräten und den Systemstandardwerten. Sie überwacht die folgenden drei Gruppen:

• Audio-Eingabegeräte (Mikrofone)
• Audioausgabegeräte (Lautsprecher, Kopfhörer)
• Video-Eingabegeräte (Kameras)

QMediaDevices stellt für jede Gerätegruppe eine separate Liste bereit. Wenn festgestellt wird, dass ein neues Gerät an das System angeschlossen oder ein angeschlossenes Gerät vom System getrennt wurde, aktualisiert die Klasse die entsprechende Geräteliste und sendet ein Signal, das über die Änderung informiert.

Mit den Funktionen „ QMediaDevices::audioInputs “ und „ QMediaDevices::audioOutputs “ lassen sich alle Mikrofone und Lautsprecher/Headsets im System auflisten. In diesem Beispiel wird zunächst eine Liste aller angeschlossenen Mikrofone abgerufen und anschließend deren Kennung, Beschreibung sowie die Angabe, ob es sich um das Standardgerät handelt, ausgegeben.

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

Ebenso gibt die Funktion ` QMediaDevices::videoInputs ` eine Liste aller angeschlossenen Kameras zurück. In diesem Beispiel listen wir alle angeschlossenen Kameras auf und geben deren Kennung, Beschreibung sowie die Angabe an, 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 Systemstandardwerte für jede Gerätegruppe. Es benachrichtigt über alle Änderungen, die über die Systemeinstellungen vorgenommen werden. Wählt der Benutzer beispielsweise in den Systemeinstellungen einen neuen Standard-Audioausgang aus, aktualisiert QMediaDevices den Standard-Audioausgang entsprechend und gibt ein Signal aus. Wenn das System keinen Standard für eine Kamera oder einen Audioeingang bereitstellt, wählt QMediaDevices das erste Gerät aus der Liste als Standardgerät aus.

Zwar reicht die Verwendung der Standard-Ein- und -Ausgabegeräte für die Wiedergabe oder Aufnahme von Multimedia-Inhalten oft aus, doch besteht häufig die Notwendigkeit, das zu verwendende Gerät explizit auszuwählen.

Die statischen Methoden von QMediaDevices sind threadsicher und beziehen sich auf ein zugrunde liegendes Singleton-Objekt.