HU/playSound

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

Egy hangelemet hoz létre, majd rögtön azután le is játsza azt a játékosnak.


[[{{{image}}}|link=|]] Note:
  • Támogatott audió formátumok: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M and PLS(e.g. Webstream).
  • Teljesítményi okokból, mikor a playSound-ot használjuk egy effekt többszöri lejátszásánál (pl. fegyver lövés), javasoljuk, hogy az audiófájlokat egycsatornás WaV-ba konvertálja (mono), 22050-Hz, vagy kisebb mintavételi frekvenciával. Valamint érdemes hozzáadni egy limitet, ami szabályozza az effekt lejátszási gyakoriságát.

Szintaxis

element playSound ( string soundPath, [ bool looped = false, bool throttled = true ] )

OOP Syntax Help! I don't understand this!

Method: Sound(...)


Kötelező argumentumok

  • soundPath: a lejátszani kívánt hang elérési helye vagy URL címe. (Az elérési hely által rendszerezett hangot elő kell definiálni a meta.xml fájlban, <file /> taggel)

Tetszőleges Argumentumok

Megjegyzés: Amikor tetszőleges paramétereket használ, előfordulhat, hogy az összes paramétert meg kell adnia, mielőtt egyet is használna. További információkért látogassa meg a tetszőleges paraméterek oldalt.

  • looped: A boolean visszadja, hogy a hang ismétlődni fog-e. A hang ismétlésére használja a true-t. Az ismétlés nem elérhető a streamelt hangoknál, csak hangfájlok esetén.
  • throttled: A boolean visszadja, hogy a hang szabályozva lesz-e (pl. csökkentett letöltési sávszélességgel). A hang szabályozásához használja a "true" parancsot. A hangok alapértelmezés szerint csak az URL-ekre korlátozódnak.

Visszaadott érték

Visszaad egy hangelemet, ha a hang sikeresen létre lett hozva, egyébként hamis.

Példa

function wasted (killer, weapon, bodypart) 
	local sound = playSound("sounds/wasted.mp3") --Lejátsza a 'wasted.mp3' fájlt a sounds mappából
	setSoundVolume(sound, 0.5) -- 50%-ra állítja a hangerőt
end

addEventHandler("onClientPlayerWasted", localPlayer, wasted) -- egy eseménykezelő hozzáadása

Lásd még

Fordította