View source for PL/playSound

__NOTOC__ 
{{PL/Client function}}
Funkcja ta tworzy [[element]] [[sound|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.
{{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== 
<syntaxhighlight lang="lua">element playSound ( string soundPath, [ bool looped = false, bool throttled = true ] )</syntaxhighlight> 
{{OOP||[[Sound]]}}
===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 />.

===Opcjonalne argumenty=== 
{{PL/OptionalArg}} 
*'''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==
<section show="true" name="Przykład nr 1: Klient" class="client">
Ten przykład odtwarza graczowi po wejściu na serwer radio RMF MAXXX przez 30 sekund.
<syntaxhighlight lang="lua">
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( function() destroyElement(radio) end, 30*1000, 1 ) -- 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
</syntaxhighlight>
</section>

<br/>
''Autor: [[User:GabWas|GabWas]]; utworzono: 23:32, 19 Lip 2016 (CEST)''
<br/>''Author: [[User:GabWas|GabWas]]; created: 21:32, 19 Jul 2016 (UTC)''

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