SpatialSound QML Type

Ein Klangobjekt im 3D-Raum. Mehr...

Import Statement: import QtQuick3D.SpatialAudio

Eigenschaften

Methoden

Detaillierte Beschreibung

Ein SpatialSound stellt ein hörbares Objekt im 3D-Raum dar. Sie können seine Position und Ausrichtung im Raum definieren, den Ton, den es abspielt, festlegen und eine Lautstärke für das Objekt definieren.

Das Objekt kann ein unterschiedliches Dämpfungsverhalten haben, Schall hauptsächlich in eine Richtung oder sphärisch abstrahlen und sich so verhalten, als ob es von einem anderen Objekt verdeckt wird.

Eigenschaft Dokumentation

autoPlay : bool

Legt fest, ob der Ton automatisch abgespielt werden soll, wenn eine Quelle angegeben wird.

Der Standardwert ist true.


directivity : real

Legt die Richtwirkung der Schallquelle fest. Ein Wert von 0 bedeutet, dass der Ton gleichmäßig in alle Richtungen abgestrahlt wird, während ein Wert von 1 bedeutet, dass die Quelle den Ton hauptsächlich in Vorwärtsrichtung abgibt.

Gültige Werte liegen zwischen 0 und 1, der Standardwert ist 0.


directivityOrder : real

Bestimmt die Ordnung der Richtwirkung der Schallquelle. Eine höhere Ordnung impliziert eine schärfere Lokalisierung des Schallkegels.

Der Mindestwert und Standardwert für diese Eigenschaft ist 1.


distanceCutoff : real

Legt eine Entfernung fest, ab der der von der Quelle kommende Schall abgeschnitten wird. Befindet sich der Zuhörer weiter vom Klangobjekt entfernt als die Abschneideentfernung, ist es nicht mehr hörbar.


distanceModel : enumeration

Legt fest, wie die Lautstärke des Klangs mit der Entfernung zum Hörer skaliert. Die Lautstärke sinkt von size auf distanceCutoff. Die Lautstärke ist konstant für Entfernungen kleiner als size und Null für Entfernungen größer als die Cutoff-Distanz.

Eigenschaft WertBeschreibung
LogarithmischDie Lautstärke nimmt logarithmisch mit der Entfernung ab.
LinearDas Volumen nimmt linear mit dem Abstand ab.
ManualAttenuationDie Dämpfung wird manuell über die Eigenschaft manualAttenuation definiert.

loops : int

Bestimmt, wie oft der Sound abgespielt wird, bevor der Player stoppt. Setzen Sie den Wert auf SpatialSound::Infinite, um den aktuellen Sound in einer Endlosschleife abzuspielen.

Der Standardwert ist 1.


manualAttenuation : real

Legt einen manuellen Dämpfungsfaktor fest, wenn distanceModel auf SpatialSound gesetzt ist. ManualAttenuation.


nearFieldGain : real

Legt die Nahfeldverstärkung für die Klangquelle fest. Gültige Werte liegen zwischen 0 und 1. Eine Nahfeldverstärkung von 1 erhöht die Lautstärke des Schallsignals um ca. 20 dB für Entfernungen in unmittelbarer Nähe des Zuhörers.


occlusionIntensity : real

Legt fest, wie stark das Objekt verdeckt ist. 0 bedeutet, dass das Objekt überhaupt nicht verdeckt ist, während eine große Zahl eine starke Verdeckung bedeutet.

Die Voreinstellung ist 0.


size : real

Legt die Größe der Schallquelle fest. Wenn sich der Zuhörer näher am Klangobjekt befindet als die Größe, bleibt die Lautstärke konstant. Die Größe wird auch für Verdeckungsberechnungen verwendet, bei denen große Quellen teilweise von einer Wand verdeckt werden können.


source : url

Die Quelldatei für den abzuspielenden Sound.


volume : real

Legt eine Gesamtlautstärke für diese Schallquelle fest.

Werte zwischen 0 und 1 schwächen den Klang ab, während Werte über 1 eine zusätzliche Verstärkung bewirken.


Methode Dokumentation

pause()

Hält die Tonwiedergabe an der aktuellen Position an. Durch den Aufruf von play() wird die Wiedergabe fortgesetzt.


play()

Startet die Wiedergabe des Tons. Führt nichts aus, wenn der Ton bereits abgespielt wird.


stop()

Stoppt die Tonwiedergabe und setzt die aktuelle Position und den Schleifenzähler auf 0 zurück. Durch den Aufruf von play() wird die Wiedergabe am Anfang der Tondatei begonnen.


© 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.