MediaDevices QML Type

MediaDevices liefert Informationen zu den verfügbaren Multimedia-Ein- und Ausgabegeräten. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• audioInputs : list<audioDevice>
• audioOutputs : list<audioDevice>
• defaultAudioInput : audioDevice
• defaultAudioOutput : audioDevice
• defaultVideoInput : cameraDevice
• videoInputs : list<cameraDevice>

Ausführliche Beschreibung

Der Typ „MediaDevices“ liefert Informationen zu den verfügbaren Multimedia-Geräten und den Systemstandardwerten. Er überwacht die folgenden drei Gruppen:

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

„MediaDevices“ stellt für jede Gerätegruppe eine separate Liste bereit. Wenn erkannt wird, 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 sendet ein Signal, das über die Änderung informiert.

MediaDevices ü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 MediaDevices den Standard-Audioausgang entsprechend und sendet ein Signal. Wenn das System keinen Standard für eine Kamera oder einen Audioeingang bereitstellt, wählt MediaDevices 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.

Das folgende Code-Schnipsel stellt beispielsweise sicher, dass der Media-Player für die Wiedergabe stets das standardmäßige Audioausgabegerät des Systems verwendet:

MediaDevices {
    id: devices
}
MediaPlayer {
    ...
    audioOutput: AudioOutput {
        device: devices.defaultAudioOutput
    }
}

Siehe auch Camera, AudioInput und VideoOutput.

Dokumentation zu Eigenschaften

audioInputs : list<audioDevice> [read-only]

Enthält eine Liste der auf dem System verfügbaren Audio-Eingabegeräte.

Bei diesen Geräten handelt es sich in der Regel um Mikrofone. Die Geräte können entweder integriert sein oder beispielsweise über USB oder Bluetooth angeschlossen werden.

audioOutputs : list<audioDevice> [read-only]

Enthält eine Liste der im 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 fest eingebaut sein oder beispielsweise über USB oder Bluetooth angeschlossen werden.

defaultAudioInput : audioDevice [read-only]

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 [read-only]

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 [read-only]

Gibt die Standardkamera des Systems 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.

videoInputs : list<cameraDevice> [read-only]

Enthält eine Liste der Kameras im System.