SpatialSound QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• autoPlay : bool
• directivity : real
• directivityOrder : real
• distanceCutoff : real
• distanceModel : enumeration
• loops : int
• manualAttenuation : real
• nearFieldGain : real
• occlusionIntensity : real
• size : real
• source : url
• volume : real

Methoden

• void pause()
• void play()
• void stop()

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.

Dokumentation der Eigenschaft

autoPlay : bool

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

Der Standardwert ist true.

directivity : real

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

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 bedeutet 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. Wenn der Zuhörer weiter vom Klangobjekt entfernt ist als die Abschaltdistanz, ist der Klang nicht mehr hörbar.

distanceModel : enumeration

Legt fest, wie die Lautstärke des Tons mit der Entfernung zum Hörer skaliert. Die Lautstärke verringert sich von size auf distanceCutoff. Die Lautstärke ist konstant für Entfernungen, die kleiner als die Größe sind, und null für Entfernungen, die größer als die Grenzentfernung sind.

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.ManualAttenuation eingestellt ist.

nearFieldGain : real

Bestimmt die Nahfeldverstärkung für die Schallquelle. 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.

Der Standardwert ist 0.

size : real

Bestimmt die Größe der Schallquelle. Wenn der Zuhörer näher am Schallobjekt ist 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 Ton.

volume : real

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

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

Dokumentation zur Methode

void pause()

Hält die Tonwiedergabe an der aktuellen Position an. Wenn Sie play() aufrufen, wird die Wiedergabe fortgesetzt.

void play()

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

void stop()

Stoppt die Tonwiedergabe und setzt die aktuelle Position und Schleifenanzahl auf 0 zurück. Der Aufruf von play() beginnt die Wiedergabe am Anfang der Tondatei.