MediaDevices QML Type
MediaDevices liefert Informationen über verfügbare Multimedia-Eingabe- und Ausgabegeräte. Mehr...
| Import Statement: | import QtMultimedia |
| In C++: | QMediaDevices |
Eigenschaften
- audioInputs : list<audioDevice>
- audioOutputs : list<audioDevice>
- defaultAudioInput : audioDevice
- defaultAudioOutput : audioDevice
- defaultVideoInput : cameraDevice
- videoInputs : list<cameraDevice>
Detaillierte Beschreibung
Der Typ MediaDevices liefert Informationen über die verfügbaren Multimedia-Geräte und die Systemvorgaben. Er überwacht die folgenden drei Gruppen:
- Audio-Eingabegeräte (Mikrofone)
- Audio-Ausgabegeräte (Lautsprecher, Headsets)
- Video-Eingabegeräte (Kameras)
MediaDevices stellt für jede Gerätegruppe eine eigene Liste bereit. Wenn es 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 die Änderung meldet.
MediaDevices ü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 MediaDevices den Standard-Audioausgang entsprechend und gibt ein Signal aus. Wenn das System keinen Standard für eine Kamera oder einen Audioeingang vorsieht, wählt MediaDevices das erste Gerät aus der Liste als Standardgerät aus.
Während die Verwendung der Standardeingabe- und -ausgabegeräte für die Wiedergabe oder Aufzeichnung von Multimedia-Inhalten oft ausreicht, ist es oft notwendig, das zu verwendende Gerät explizit auszuwählen.
Der folgende Ausschnitt stellt zum Beispiel sicher, dass der Media Player immer das Standard-Audioausgabegerät des Systems für die Wiedergabe verwendet:
MediaDevices {
id: devices
}
MediaPlayer {
...
audioOutput: AudioOutput {
device: devices.defaultAudioOutput
}
}Siehe auch Camera, AudioInput, und VideoOutput.
Eigenschaft Dokumentation
audioInputs : list<audioDevice> |
Enthält eine Liste der verfügbaren Audio-Eingabegeräte auf dem System.
Diese Geräte sind normalerweise Mikrofone. Die Geräte können entweder eingebaut oder z. B. über USB oder Bluetooth angeschlossen sein.
audioOutputs : list<audioDevice> |
Enthält eine Liste der auf dem System verfügbaren Audioausgabegeräte.
Bei diesen Geräten handelt es sich in der Regel um Lautsprecher oder Kopfhörer. Die Geräte können entweder eingebaut oder z. B. über USB oder Bluetooth angeschlossen sein.
defaultAudioInput : audioDevice |
Gibt das Standard-Audioeingabegerät zurück.
Das Standardgerät kann sich während der Laufzeit der Anwendung ändern. Der Wert dieser Eigenschaft passt sich automatisch an solche Änderungen an.
defaultAudioOutput : audioDevice |
Gibt das Standard-Audioausgabegerät zurück.
Das Standardgerät kann sich während der Laufzeit der Anwendung ändern. Der Wert dieser Eigenschaft passt sich automatisch an solche Änderungen an.
defaultVideoInput : cameraDevice |
Gibt die Standardkamera des Systems zurück.
Hinweis: Das zurückgegebene Objekt sollte mit isNull() überprüft werden, bevor es verwendet wird, falls keine Kamera vorhanden ist.
Das Standardgerät kann sich während der Laufzeit der Anwendung ändern. Der Wert dieser Eigenschaft wird sich automatisch an solche Änderungen anpassen.
videoInputs : list<cameraDevice> |
Enthält eine Liste der Kameras auf dem System.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
