HU/playSound

From Multi Theft Auto: Wiki
Revision as of 16:40, 21 July 2018 by Surge (talk | contribs)
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.

Note: Támogatott audió formátumok: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M and PLS(e.g. Webstream).

[[{{{image}}}|link=|]] Note: Teljesítményi okbó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.

Syntax

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

OOP Syntax Help! I don't understand this!

Method: Sound(...)


Required Arguments

  • soundPath: the filepath or URL of the sound file you want to play. (Sound specified by filepath has to be predefined in the meta.xml file with <file /> tag.)

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • looped: a boolean representing whether the sound will be looped. To loop the sound, use true. Loop is not available for streaming sounds, only for sound files.
  • throttled: a boolean representing whether the sound will be throttled (i.e. given reduced download bandwidth). To throttle the sound, use true. Sounds will be throttled per default and only for URLs.

Returns

Returns a sound element if the sound was successfully created, false otherwise.

Example

function wasted (killer, weapon, bodypart) 
	local sound = playSound("sounds/wasted.mp3") --Play wasted.mp3 from the sounds folder
	setSoundVolume(sound, 0.5) -- set the sound volume to 50%
end

addEventHandler("onClientPlayerWasted", localPlayer, wasted) --add the event handler

See Also