PL/playSound3D

From Multi Theft Auto: Wiki
Revision as of 18:39, 25 July 2014 by ThePiotrek (talk | contribs)
Jump to navigation Jump to search

Tworzy element dźwięku w świecie GTA i odtwarza go po stworzeniu go dla gracza lokalnego. Funkcja setElementPosition może być użyta by przenieść dźwięk po tym, jak został on stworzony. Zapamiętaj by użyć setElementDimension jeśli chcesz by dźwięk grał w innym wymiarze niż 0.

Notatka: Jedyne wspierane formaty to: MP3, WAV, OGG, RIFF, MOD, XM, IT i S3M.


Składnia

element playSound3D ( string link/ścieżka do pliku, pozycja x, pozycja y, pozycja z, [ bool zapętlony = false ] )



Wymagane argumenty

  • link/ścieżka do pliku: Link lub ścieżka do pliku który chcesz odtwarzać. (Pliki muszą być zdefiniowane w meta.xml pomiędzy tagami <file />. Możesz użyć także URL. )
  • x: Pozycja X na mapie na której ma grać dźwięk.
  • y: Pozycja Y na mapie na której ma grać dźwięk.
  • z: Pozycja Z na mapie na której ma grać dźwięk.


Opcjonalne argumenty

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.

  • zapętlony: Wartość typu boolean reprezentująca, czy dźwięk ma być zapętlany. By zapętlić dźwięk, użyj true.


Zwracane argumenty

Zwraca element dźwięku jeśli zostanie on poprawnie stworzony, lub false jeśli nie zostanie on poprawnie stworzony.



Przykład

Ten przykład tworzy zapętlony dźwięk w pizzeri. Pizzeria jest umiejscowiona w San Fierro nie daleko Pier 69

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



Ten przykład odtwarza radio internetowe na Grove Street.

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


Zobacz także