DE/playSound3D

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

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.

[[{{{image}}}|link=|]] 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

Click to collapse [-]
Beispiel
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.

Click to collapse [-]
Beispiel 2
addEventHandler( 'onClientResourceStart', resourceRoot,
	function( )
		local uSound = playSound3D( 'http://193.34.51.25:80', 2498, -1659, 12 ) 
		setSoundMaxDistance( uSound, 100 )
	end
)

Siehe auch