PL/playSound3D: Difference between revisions

Latest revision as of 11:14, 21 July 2016

Funkcja ta tworzy element dźwięku oraz odtwarza go dla lokalnego gracza, od razu po wywołaniu funkcji. Jeżeli po stworzeniu dźwięku chcesz zmienić jego pozycję, skorzystaj z funkcji setElementPosition. Akutalnie wspierane formaty audio to MP3, WAV, OGG, RIFF, MOD, XM, IT oraz S3M.

[[{{{image}}}\|link=\|]]	Notatka: Ze względu na wydajność, podczas korzystania z funkcji playSound do efektów (np. dźwięki strzelania), zalecana jest konwersja pliku audio z np. MP3 (stereo) do WAV (mono) z częstotliwością 22050 Hz lub niższą. Warto również dodać limit odtwarzania dźwięku np. raz na 50ms.

Składnia

element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false, bool throttled = true ] )

OOP Syntax Help! I don't understand this!

Method: Sound3D(...)

Wymagane argumenty

soundPath: Ścieżka lub adres URL do pliku dźwiękowego, który chcesz odtworzyć.

ⓘ Pliki odtwarzane ze ścieżki, muszą być wcześniej zapisane w pliku meta.xml korzystając z tagu <file />.

x: Liczba zmiennoprzecinkowa określająca współrzędną X dźwięku na mapie.
y: Liczba zmiennoprzecinkowa określająca współrzędną Y dźwięku na mapie.
z: Liczba zmiennoprzecinkowa określająca współrzędną Z dźwięku na mapie.

Opcjonalne argumenty

UWAGA: Kiedy korzystasz z opcjonalnych argumentów, musisz uzupełnić wszystkie argumenty przed tym, którego chcesz użyć. Aby uzyskać więcej informacji na ten temat, zajrzyj tutaj.

looped: Boolean decydujący o tym, czy dźwięk ma zostać zapętlony. Aby tak się stało, użyj true. Domyślnie false.

ⓘ Zapętlanie nie jest możliwe w przypadku stream'ów (np. radio).

throttled: Boolean decydujący o tym, czy dźwięk z adresu URL ma być odtwarzany z niską przepustowością łącza. Aby tak się stało, użyj true. Domyślnie true.

ⓘ Odtwarzanie z niską przepustowością łącza dotyczy tylko plików odtwarzanych z adresów URL.

Wynik

Zwraca element dźwięku jeżeli został on pomyślnie stworzony. W przeciwnym wypadku zwraca false.

Przykłady

Click to collapse [-]

Przykład nr 1

Ten przykład odtwarza radio RMF MAXXX w okolicach Grove Street.

function radioNaGrove ( ) -- tworzymy funkcję odpowiadającą za odtwarzanie się radia
   local radio = playSound3D( 'http://files.kusmierz.be/rmf/rmfmaxxx.pls', 2498, -1659, 12 ) -- tworzymy dźwięk...
   setSoundMaxDistance( radio, 100 ) -- ...oraz zmieniamy jego odległość, na którą można go będzie usłyszeć (opcjonalne)
end
addEventHandler ( "onClientResourceStart", getResourceRootElement(), radioNaGrove ) -- na koniec nie zapominamy o eventHandlerze

Autor: GabWas; utworzono: 12:16, 21 Lip 2016 (CEST)
Author: GabWas; created: 10:16, 21 Jul 2016 (UTC)

Zobacz również

@@ Line 1: / Line 1: @@
 __NOTOC__
-{{Client function}}
+{{PL/Client function}}
-Creates a [[sound]] [[element]] in the GTA world and plays it immediately after creation for the local player. [[setElementPosition]] can be used to move the [[sound]] element around after it has been created. Remember to use [[setElementDimension]] after creating the sound to play it outside of dimension 0.<br />
+Funkcja ta tworzy [[element]] [[sound|dźwięku]] oraz odtwarza go dla lokalnego gracza, od razu po wywołaniu funkcji. Jeżeli po stworzeniu dźwięku chcesz zmienić jego pozycję, skorzystaj z funkcji [[setElementPosition]].
-<br />
+Akutalnie wspierane formaty audio to MP3, WAV, OGG, RIFF, MOD, XM, IT oraz S3M.
-'''Note:''' The only supported audio formats are MP3, WAV, OGG, RIFF, MOD, XM, IT and S3M.
+{{PL/Note|Ze względu na wydajność, podczas korzystania z funkcji playSound do efektów (np. dźwięki strzelania), zalecana jest konwersja pliku audio z np. MP3 (stereo) do WAV (mono) z częstotliwością 22050 Hz lub niższą. Warto również dodać limit odtwarzania dźwięku np. raz na 50ms.}}
-{{Note|For performance reasons, when using playSound3D for effects that will be played lots (i.e. weapon fire), it is recommend that you convert your audio file to a one channel (mono) WAV with sample rate of 22050 Hz or less. Also consider adding a limit on how often the effect can be played e.g. once every 50ms.}}
+==Składnia==
-==Syntax==
 <syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false, bool throttled = true ] )</syntaxhighlight>
 {{OOP||[[Sound|Sound3D]]}}
-===Required Arguments===
+===Wymagane argumenty===
-*'''soundPath:''' the [[filepath]] to the sound file you want to play. (Sound file has to be predefined in the [[meta.xml]] file with <file /> tag. And also can use url instead of [[filepath]] )
+*'''soundPath:''' [[filepath|Ścieżka]] lub adres URL do pliku dźwiękowego, który chcesz odtworzyć.
-*'''x:''' a [[float]]ing point number representing the X coordinate on the map.
+ⓘ Pliki odtwarzane ze ścieżki, muszą być wcześniej zapisane w pliku [[PL/meta.xml|meta.xml]] korzystając z tagu <file />.
-*'''y:''' a [[float]]ing point number representing the Y coordinate on the map.
+*'''x:''' Liczba zmiennoprzecinkowa określająca współrzędną X dźwięku na mapie.
-*'''z:''' a [[float]]ing point number representing the Z coordinate on the map.
+*'''y:''' Liczba zmiennoprzecinkowa określająca współrzędną Y dźwięku na mapie.
+*'''z:''' Liczba zmiennoprzecinkowa określająca współrzędną Z dźwięku na mapie.
-===Optional Arguments===
+===Opcjonalne argumenty===
-{{OptionalArg}}
+{{PL/OptionalArg}}
-*'''looped:''' A [[boolean]] representing whether the sound will be looped. To loop the sound, use ''true''.
+*'''looped:''' [[Boolean]] decydujący o tym, czy dźwięk ma zostać zapętlony. Aby tak się stało, użyj ''true''. Domyślnie ''false''.
+ⓘ Zapętlanie nie jest możliwe w przypadku stream'ów (np. radio).
 {{New feature/item|3.0150|1.5||
-*'''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.
+*'''throttled:''' [[Boolean]] decydujący o tym, czy dźwięk z adresu URL ma być odtwarzany z niską przepustowością łącza. Aby tak się stało, użyj ''true''. Domyślnie ''true''.
+ⓘ Odtwarzanie z niską przepustowością łącza dotyczy tylko plików odtwarzanych z adresów URL.
 }}
-===Returns===
+===Wynik===
-Returns a [[sound]] [[element]] if the sound was successfully created, ''false'' otherwise.
+Zwraca [[element]] [[sound|dźwięku]] jeżeli został on pomyślnie stworzony. W przeciwnym wypadku zwraca ''false''.
-==Example==
+==Przykłady==
-This example creates a looping sound within a pizza shop. The pizza shop is in san fierro near pier 69
+<section name="Przykład nr 1" class="client" show="true" >
-<section name="Example" class="client" show="true">
+Ten przykład odtwarza radio RMF MAXXX w okolicach Grove Street.
 <syntaxhighlight lang="lua">
-function onResourceStart()
+function radioNaGrove ( ) -- tworzymy funkcję odpowiadającą za odtwarzanie się radia
-	local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)
+   local radio = playSound3D( 'http://files.kusmierz.be/rmf/rmfmaxxx.pls', 2498, -1659, 12 ) -- tworzymy dźwięk...
+   setSoundMaxDistance( radio, 100 ) -- ...oraz zmieniamy jego odległość, na którą można go będzie usłyszeć (opcjonalne)
 end
-addEventHandler("onClientResourceStart", resourceRoot, onResourceStart)
+addEventHandler ( "onClientResourceStart", getResourceRootElement(), radioNaGrove ) -- na koniec nie zapominamy o eventHandlerze
-</syntaxhighlight>
-</section>
-This example play internet radio in groove street.
-<section name="Example 2" class="client" show="true" >
-<syntaxhighlight lang="lua">
-addEventHandler( 'onClientResourceStart', resourceRoot,
-	function( )
-		local uSound = playSound3D( 'http://193.34.51.25:80', 2498, -1659, 12 )
-		setSoundMaxDistance( uSound, 100 )
-	end
-)
 </syntaxhighlight>
 </section>
-==See Also==
+<br/>
+''Autor: [[User:GabWas|GabWas]]; utworzono: 12:16, 21 Lip 2016 (CEST)''
+<br/>''Author: [[User:GabWas|GabWas]]; created: 10:16, 21 Jul 2016 (UTC)''
+==Zobacz również==
 {{Client_audio_functions}}
+[[en:playSound3D]]
 [[AR:playSound3D]]
 [[DE:playSound3D]]
 [[RU:playSound3D]]