AudioEngine QML Type

AudioEngine verwaltet Soundobjekte 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

Ausführliche Beschreibung

AudioEngine verwaltet Soundobjekte innerhalb einer 3D-Szene. Sie können der Szene „ SpatialSound “-Objekte hinzufügen, um Sounds zu definieren, die an einer bestimmten Position im 3D-Raum erklingen. Mit „ AmbientSound “ können Sie eine Stereo-Überlagerung hinzufügen (z. B. einen Voice-Over-Kommentar oder eine Tonspur).

Mit „ AudioListener “ können Sie die Position der Person, die das Klangfeld wahrnimmt, relativ zu den Schallquellen definieren. Schallquellen sind umso leiser, je weiter der Zuhörer von der Quelle entfernt ist. Sie werden zudem je nach Richtung zwischen Zuhörer und Quelle den entsprechenden Lautsprechern zugeordnet. In vielen Fällen kann das Objekt „ AudioListener “ einfach als untergeordnetes Objekt des Kameraobjekts „ QtQuick3D “ instanziiert werden.

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

AudioEngine bietet einen Modus, in dem Qt die Effekte des Ohrs mithilfe von Head-Related-Impulse-Response-Funktionen (siehe auch https://en.wikipedia.org/wiki/Sound_localization) simuliert, um den Klang im 3D-Raum bei Verwendung von Kopfhörern zu lokalisieren und einen räumlichen Audioeffekt über Kopfhörer zu erzeugen.

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

Dokumentation der Eigenschaften

distanceScale : real [since 6.11]

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

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

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

masterVolume : real

Legt das Gesamtvolumen fest, das für die Darstellung des Klangfeldes verwendet wird, bzw. gibt es zurück.

outputDevice : QtMultimedia.AudioDevice

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

outputMode : enumeration

Legt den aktuellen Ausgabemodus der Engine fest oder ruft ihn ab.