DE/playSound

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

Erstellt ein Sound Element und spielt es sofort ab für den lokalen Spieler.

[[{{{image}}}|link=|]] Bemerkung: * Die unterstützten Audio Formate sind MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M und PLS(z.b. Webstream).
  • 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 playSound ( string soundPath, [ bool looped = false, bool throttled = true ] )

OOP Syntax Hilfe! Ich verstehe das nicht!

Methode: Sound(...)

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

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. Wiederholungen gelten nicht für Streams, nur für Dateien.
  • 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. Drosseln funktioniert nur bei Streams und wird standardmäßig ausgeführt.

Rückgabe

Gibt ein Sound Element zurück wenn es erfolgreich erstell wurde, ansonsten false.

Beispiel

function wasted (killer, weapon, bodypart) 
	local sound = playSound("sounds/wasted.mp3") --Spielt wasted.mp3 vom sounds Ordner ab
	setSoundVolume(sound, 0.5) -- setzt die Lautstärke auf 50%
end

addEventHandler("onClientPlayerWasted", localPlayer, wasted)

Siehe auch