PL/playSound: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Client function}}
{{PL/Client function}}
Tworzy element [[dźwięku]] i odtwarza go dla gracza lokalnego.<br />
Funkcja ta tworzy [[element]] [[sound|dźwięku]] oraz odtwarza go dla lokalnego gracza, od razu po wywołaniu funkcji.
<br />
Akutalnie wspierane formaty audio to MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M oraz PLS.
'''Note:''' Lista wspieranych formatów: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M and PLS(e.g. Webstream).
{{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 playSound ( string link/ścieżka do pliku, [ bool zapętlone = false ] )</syntaxhighlight>  
<syntaxhighlight lang="lua">element playSound ( string soundPath, [ bool looped = false, bool throttled = true ] )</syntaxhighlight>  
 
{{OOP||[[Sound]]}}
 
 
===Wymagane argumenty===  
===Wymagane argumenty===  
*'''soundPath:''' Czyli [[plik]] lub URL dźwięku który chcesz odtworzyć. (Dźwięki w pliku muszą być zdefiniowane w [[meta.xml]] pomiędzy tagiem <file /> .)
*'''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 />.
 


===Opcjonalne argumenty===  
===Opcjonalne argumenty===  
{{OptionalArg}}  
{{PL/OptionalArg}}  
*'''zapętlone:''' Wartość typu [[boolean]] reprezentująca, czy dźwięk ma być zapętlany. Aby zapętlać dźwięk użyj ''true''. Zapętlanie nie jest dostępne dla streamowanych dźwięków, tylko dla plików.
*'''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''.


===Zwracane argumenty===
==Przykłady==
Zwraca element [[dźwięku]] jeśli dźwięk zostanie poprawnie stworzony, ''false'' jeśli nie.
<section show="true" name="Przykład nr 1" class="client">
 
Ten przykład odtwarza graczowi po wejściu na serwer radio RMF MAXXX przez 30 sekund.
 
 
==Przykład==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function onWasted (killer, weapon, bodypart)  
function poWejsciuNaSerwer()
local dzwiek = playSound("dzwieki/wasted.mp3") -- uruchamiamy dźwięk z folderu "dzwieki"
  local radio = playSound( "http://files.kusmierz.be/rmf/rmfmaxxx.pls" ) -- odtwarzamy stream radia z adresu URL...
setSoundVolume(dzwiek, 0.5) -- ustawiamy glosnosc dzwieku na 0.5
  setSoundVolume( radio, 0.5 ) -- ...i ustawiamy mu głośność na 50%, żeby nikogo nie irytowało
  setTimer( destroyElement, 30*1000, 1, radio ) -- tworzymy również timer, który po 30 sekundach wyłączy radio
end
end
 
addEventHandler ( "onClientPlayerJoin", getRootElement(), poWejsciuNaSerwer ) -- a na koniec podłączamy funkcję pod eventHandler
addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) -- dodajemy event handler
</syntaxhighlight>
</syntaxhighlight>
</section>


<br/>
''Autor: [[User:GabWas|GabWas]]; utworzono: 23:32, 20 Lip 2016 (CEST); ostatnio edytowano: 11:37, 21 Lip 2016 (CEST)''
<br/>''Author: [[User:GabWas|GabWas]]; created: 21:32, 20 Jul 2016 (UTC); last edited: 09:37, 21 Jul 2016 (UTC)''


==Zobacz także==
==Zobacz również==
{{Client_audio_functions}}
{{Client_audio_functions}}
[[en:playSound]]
[[AR:playSound]]
[[AR:playSound]]
[[DE:playSound]]
[[DE:playSound]]

Latest revision as of 14:59, 14 August 2018

Funkcja ta tworzy element dźwięku oraz odtwarza go dla lokalnego gracza, od razu po wywołaniu funkcji. Akutalnie wspierane formaty audio to MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M oraz PLS.

[[{{{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 playSound ( string soundPath, [ bool looped = false, bool throttled = true ] )

OOP Syntax Help! I don't understand this!

Method: Sound(...)


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

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 graczowi po wejściu na serwer radio RMF MAXXX przez 30 sekund.

function poWejsciuNaSerwer()
   local radio = playSound( "http://files.kusmierz.be/rmf/rmfmaxxx.pls" ) -- odtwarzamy stream radia z adresu URL...
   setSoundVolume( radio, 0.5 ) -- ...i ustawiamy mu głośność na 50%, żeby nikogo nie irytowało
   setTimer( destroyElement, 30*1000, 1, radio ) -- tworzymy również timer, który po 30 sekundach wyłączy radio
end
addEventHandler ( "onClientPlayerJoin", getRootElement(), poWejsciuNaSerwer ) -- a na koniec podłączamy funkcję pod eventHandler


Autor: GabWas; utworzono: 23:32, 20 Lip 2016 (CEST); ostatnio edytowano: 11:37, 21 Lip 2016 (CEST)
Author: GabWas; created: 21:32, 20 Jul 2016 (UTC); last edited: 09:37, 21 Jul 2016 (UTC)

Zobacz również