PL/playSound: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (przestańcie podpisywać te artykuły!)
 
(One intermediate revision by one other user not shown)
Line 9: Line 9:
===Wymagane argumenty===  
===Wymagane argumenty===  
*'''soundPath:''' [[filepath|Ścieżka]] lub adres URL do pliku dźwiękowego, który chcesz odtworzyć.
*'''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 />.
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===  
{{PL/OptionalArg}}  
{{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''.
*'''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).
Zapętlanie nie jest możliwe w przypadku stream'ów (np. radio).
{{New feature/item|3.0150|1.5||
{{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''.
*'''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.
Odtwarzanie z niską przepustowością łącza dotyczy tylko plików odtwarzanych z adresów URL.
}}
}}


Line 30: Line 30:
   local radio = playSound( "http://files.kusmierz.be/rmf/rmfmaxxx.pls" ) -- odtwarzamy stream radia z adresu URL...
   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
   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
   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 ( "onClientPlayerJoin", getRootElement(), poWejsciuNaSerwer ) -- a na koniec podłączamy funkcję pod eventHandler
Line 37: Line 37:


<br/>
<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 również==
==Zobacz również==

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ż