HU/playSound3D

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

Egy hangelemet hoz létre a GTA világban, majd rögtön azután le is játsza azt a játékosnak. A setElementPosition a hangelem mozgatásához használható a létrehozás után. Ne felejtse el használni a setElementDimension-t, miután létrehozta a hangot a lejátszáshoz a 0-ik dimenzión kívül.

[[{{{image}}}|link=]] Megjegyzés:
  • Támogatott audió formátumok: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M and PLS.
  • 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 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(...)

Kötelező argumentumok

  • soundPath: a lejátszani kívánt hang elérési helye. (A hangfájlt elő kell definiálni a meta.xml fájlban, <file /> taggel. És az elérési hely helyett az URL cím is használható )
  • soundURL: az URL. (Ebben a verzióban a fájlt nem kell elő definiálni a meta.xml-ben )
  • x: A térképen az X koordinátát ábrázoló lebegőpontos szám.
  • y: A térképen az Y koordinátát ábrázoló lebegőpontos szám.
  • z: A térképen a Z koordinátát ábrázoló lebegőpontos szám.

Tetszőleges paraméterek

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

Visszaadott értéks

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

Példa

Ez a példa egy ismétlődő hangot hoz létre a pizza boltban.

Click to collapse [-]
Example
function onResourceStart()
	local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true) 
end
addEventHandler("onClientResourceStart", resourceRoot, onResourceStart)

Ez a példa egy internetes rádiót játszik le a groove utcán.

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

Lásd még

Fordította