DE/playSound3D
Erstellt ein Sound Element in der GTA Welt spielt ihn sofort ab für den lokalen Spieler. setElementPosition kann genutzt werden zum Positionieren des Sound Elements nachdem es erstellt wurde. Vergiss nicht setElementDimension nach der Erstellung zu benutzen, um es außerhalb in der Dimension 0 zu spielen.
{{Bemerkung|
- Die unterstützten Audio-Formate sind MP3, WAV, OGG, RIFF, MOD, XM, IT und S3M.
- Aus Performance Gründen wird empfohlen, wenn playSound3D für Effekte genutzt wird, die Audio Datei in einen Kanal (Mono) WAV zu konvertieren mit einer Beispielrate von 22050 Hz oder weniger. Bedenke auch ein Limit hinzuzufügen wie oft der Effekt abgespielt werden kann, z.B. alle 50ms
Syntax
element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false ] )
element playSound3D ( string soundURL, float x, float y, float z, [ bool looped = false, bool throttled = true ] )
OOP Syntax Help! I don't understand this!
- Method: Sound3D(...)
Benötigte Argumente
- soundPath: der Dateipfad zur Datei, die du spielen möchtest. (Die Sounddatei muss in der meta.xml Datei definiert sein mit dem <file /> Tag. Du kannst auch URLs statt Pfade nehmen. )
- soundURL: die URL. (In dieser Version muss die Datei nicht in der meta.xml definiert sein )
- x: eine Fließkommazahl, welche die X-Koordinate auf der Map repräsentiert.
- y: eine Fließkommazahl, welche die Y-Koordinate auf der Map repräsentiert.
- z: eine Fließkommazahl, welche die Z-Koordinate auf der Map repräsentiert.
Optionale Argumente
HINWEIS: Bei der Verwendung von optionalen Argumenten, müssen alle Argumente vor dem gewünschten Argument bestimmt werden. Mehr Informationen unter Optionale Argumente.
- looped: Ein boolean Wert, der angibt ob der Sound wiederholt werden soll. Um den Sound in Dauerschleife zu wiederholen, nutze true.
- throttled: Ein boolean Wert, der angibt ob der Sound gedrosselt werden soll (z.B. bei geringer Download Bandbreite). Um den Sound zu drosseln, nutze true.
Rückgabe
Gibt ein Sound Element zurück wenn es erfolgreich erstellt wurde, false wenn nicht.
Beispiel
Dieses Beispiel erstellt ein Sound in Dauerschleife am Pizza Shop. Der Pizza Shop ist in San Fierro am Pier 69
function onResourceStart()
local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)
end
addEventHandler("onClientResourceStart", resourceRoot, onResourceStart)
Dieses Beispiel spielt ein Internet Radio in der Grove Street ab.
addEventHandler( 'onClientResourceStart', resourceRoot, function( ) local uSound = playSound3D( 'http://193.34.51.25:80', 2498, -1659, 12 ) setSoundMaxDistance( uSound, 100 ) end )