PL/playSound3D: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{Client function}} Tworzy element dźwięku w świecie GTA i odtwarza go po stworzeniu go dla gracza lokalnego. Funkcja setElementPosition może być użyt...")
 
m (GabWas moved page PL/PlaySound3D to PL/playSound3D)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Client function}}
{{PL/Client function}}
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.<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]].
 
Akutalnie wspierane formaty audio to MP3, WAV, OGG, RIFF, MOD, XM, IT oraz S3M.
'''Note:''' Jedyne wspierane formaty to: MP3, WAV, OGG, RIFF, MOD, XM, IT i 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.}}
 
 
 
==Składnia==  
==Składnia==  
<syntaxhighlight lang="lua">element playSound3D ( string link/ścieżka do pliku, pozycja x, pozycja y, pozycja z, [ bool zapętlony = false ] )</syntaxhighlight>  
<syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false, bool throttled = true ] )</syntaxhighlight>  
 
{{OOP||[[Sound|Sound3D]]}}
 
===Wymagane argumenty===  
 
*'''soundPath:''' [[filepath|Ś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 [[PL/meta.xml|meta.xml]] korzystając z tagu <file />.
===Wymagane argumenty ===  
*'''x:''' Liczba zmiennoprzecinkowa określająca współrzędną X dźwięku na mapie.
*'''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. )
*'''y:''' Liczba zmiennoprzecinkowa określająca współrzędną Y dźwięku na mapie.
*'''x:''' Pozycja X na mapie na której ma grać dźwięk.
*'''z:''' Liczba zmiennoprzecinkowa określająca współrzędną Z dźwięku na mapie.
*'''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===  
===Opcjonalne argumenty===  
{{OptionalArg}}  
{{PL/OptionalArg}}  
*'''zapętlony:''' Wartość typu [[boolean]] reprezentująca, czy dźwięk ma być zapętlany. By zapętlić dźwięk, użyj ''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:''' [[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]] [[sound|dźwięku]] jeżeli został on pomyślnie stworzony. W przeciwnym wypadku zwraca ''false''.


 
==Przykłady==
===Zwracane argumenty===
<section name="Przykład nr 1" class="client" show="true" >
Zwraca element [[dźwięku]] jeśli zostanie on poprawnie stworzony, lub ''false'' jeśli nie zostanie on poprawnie stworzony.
Ten przykład odtwarza radio RMF MAXXX w okolicach Grove Street.
 
 
 
 
==Przykład==  
Ten przykład tworzy zapętlony dźwięk w pizzeri. Pizzeria jest umiejscowiona w San Fierro nie daleko Pier 69
<section name="Przykład" class="client" show="true">
<syntaxhighlight lang="lua">
<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
end
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()), onResourceStart)
addEventHandler ( "onClientResourceStart", getResourceRootElement(), radioNaGrove ) -- na koniec nie zapominamy o eventHandlerze
</syntaxhighlight>
</section>
 
 
 
 
Ten przykład odtwarza radio internetowe na Grove Street.
<section name="Przykład 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>
</syntaxhighlight>
</section>
</section>


<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 także==
==Zobacz również==
{{Client_audio_functions}}
{{Client_audio_functions}}
[[en:playSound3D]]
[[AR:playSound3D]]
[[AR:playSound3D]]
[[DE:playSound3D]]
[[DE:playSound3D]]
[[RU:playSound3D]]
[[RU:playSound3D]]

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ż

Retrieved from "https://wiki.multitheftauto.com/wiki/PL/playSound3D?oldid=48292"