AudioEngine QML Type

AudioEngine verwaltet Klangobjekte innerhalb einer 3D-Szene. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• distanceScale : real (since 6.11)
• masterVolume : real
• outputDevice : QtMultimedia.AudioDevice
• outputMode : enumeration

Detaillierte Beschreibung

AudioEngine verwaltet Klangobjekte in einer 3D-Szene. Sie können der Szene SpatialSound Objekte hinzufügen, um Klänge zu definieren, die an einer bestimmten Stelle im 3D-Raum auftreten. AmbientSound ermöglicht es Ihnen, ein Stereo-Overlay hinzuzufügen (z. B. Sprachausgabe oder eine Tonspur).

Mit AudioListener können Sie die Position der Person, die das Schallfeld hört, relativ zu den Schallquellen festlegen. Die Schallquellen sind weniger hörbar, wenn der Zuhörer weiter von der Quelle entfernt ist. Sie werden auch den entsprechenden Lautsprechern zugeordnet, abhängig von der Richtung zwischen Hörer und Quelle. In vielen Fällen kann das Objekt AudioListener einfach als Unterobjekt des Objekts QtQuick3D.camera instanziiert werden.

Erstellen Sie AudioRoom Objekte, um den Klang (Reflexionen und Nachhall) eines Raumes mit bestimmten Abmessungen und verschiedenen Wandtypen zu simulieren.

Die AudioEngine bietet einen Modus, in dem Qt die Auswirkungen des Ohrs mit Hilfe von kopfbezogenen Impulsreaktionsfunktionen simuliert (siehe auch https://en.wikipedia.org/wiki/Sound_localization), um den Klang im 3D-Raum zu lokalisieren, wenn Kopfhörer verwendet werden, und einen räumlichen Audioeffekt über Kopfhörer zu erzeugen.

Wie der Rest von Qt Quick 3D verwendet auch die Audio-Engine ein Koordinatensystem, das standardmäßig in Zentimetern angegeben ist. Die Achsen sind so definiert, dass positive x-Punkte nach rechts, positive y-Punkte nach oben und positive z-Punkte nach hinten zeigen.

Dokumentation der Eigenschaften

distanceScale : real [since 6.11]

Legt den Maßstab des Koordinatensystems fest, das von der räumlichen Audio-Engine verwendet wird. Standardmäßig sind alle Einheiten in Zentimetern, entsprechend den Standardeinheiten, die von Qt Quick 3D verwendet werden.

Setzen Sie den Abstandsmaßstab auf 100, um Einheiten in Metern zu erhalten.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

masterVolume : real

Legt die Gesamtlautstärke fest oder gibt sie zurück, die zum Rendern des Klangfelds verwendet wird.

outputDevice : QtMultimedia.AudioDevice

Legt das Gerät fest, das für die Ausgabe des Schallfelds verwendet wird, oder gibt es zurück.

outputMode : enumeration

Legt den aktuellen Ausgabemodus des Motors fest oder ruft ihn ab.