Promotic
WikipediaLinkedInYoutubeTwitterFacebook

PlaySound - metoda obiektu Pm

Opis:
Odtworzenie pliku dźwiękowego *.wav przy pomocy serwera dźwiękowego systemu Promotic. System umożliwia w jednej chwili odtworzenie tylko jednego pliku dźwiękowego. Dlatego wymagania na odtworzenie pliku dźwiękowego są zaszeregowane do wewnętrznej kolejki serwera dźwiękowego. Zaszeregowanie jest wykonane według priorytetu i czasu wytworzenia zapotrzebowania na odtworzenie.
Składnia:
Empty PlaySound(String sSound)
Wołanie:
Pm.PlaySound sSound
Parametry:
sSound(String) Parametry dźwięku określające, w jaki sposób dźwięk ma zostać odtworzony. Na przykład: "file:#pmres:Sound/hoot01.wav;repeat:5;".
file:xx; - Plik dźwiękowy WAV. Jeżeli plik zacznie być odtwarzany, to musi zostać odtworzony do końca, dlatego zalecamy stosowanie raczej krótszych czasowo plików z ustawionym powtarzaniem niż odtwarzanie czasowo długich plików.
repeat:nn; - Ilość powtórzeń dźwięku (1 = domyślnie, -1 = nieograniczone).
stop:nn; - Umożliwia usunąć z kolejki serwera dźwiękowego wymogi wytworzone przy pomocy metody PlaySound.
0 (domyślnie) - Nie robi niczego
1 - Usunie z kolejki serwera dźwiękowego wszystkie wymogi wytworzone przy pomocy metody PlaySound. Jeżeli dowolny z usuwanych wymogów jest aktualnie odtwarzany, wtedy odtwarzanie zostanie natychmiast zakończone. Pozostałe opcje (file oraz repeat) są w tym przypadku ignorowane.
Notatka:
Uwaga:
- Metoda jest metodą asynchroniczną, tzn. że tylko inicjuje odtworzenie dźwięku lecz nie czeka na jego rzeczywiste uruchomienie czy zakończenie (dlatego metoda nie zwraca znacznika o powodzeniu).
- Do odtworzenia pliku dźwiękowego jest konieczne, żeby w komputerze była zainstalowana karta dźwiękowa.
 
Metoda ta działa także w Web panelach. W takim przypadku metoda posiada ograniczenie:
- Każde nowe uruchomienie dźwięku w Web panelu zakończy odtwarzanie poprzedniego dźwięku (w Web panelach nie jest dostępny serwer dźwięku).
- Przeglądarka InternetExplorer nie wspiera odtwarzania plików wav (Chrome, Firefox, Edge format wspierają). Metoda ta w Webie wspiera odtwarzanie również plików mp3 (format ten jest wspierany przez wszystkie przeglądarki), ale nie jest on wspierany w aplikacji lokalnej. Jeżeli metoda powinna działać w InternetExplorerze oraz lokalnie w aplikacji, wtedy jest konieczne wytworzyć pliki dźwiękowe w obu formatach a później lokalnie wołać inny plik niż w Webie. Patrz Przykład3
 
Stara składnia opisywanej metody zwracała 0 (przebiegła z powodzeniem) lub 1 (przebiegła z błędem) i posiadala trzy parametry:
sFile (String) - Nazwa pliku ze ścieżką. Jeżeli wartością jest pusty łańcuch, wtedy zostanie zakończone odtwarzanie bieżąco odtwarzanego pliku dźwiękowego.
nPriority (Long) - Priorytet (zarezerwowane, ustaw na 0).
nFlags (Long) - Znaczniki określające sposób odtworzenia dźwięku (mogą być zliczane).
1 - (NoStop) - Znacznik spowoduje, że bieżąco odtwarzany plik dźwiękowy nie zostanie przerwany a metoda zostanie bezpośrednio zakończona ze znacznikiem błędu (zwraca 1) (można zastosować do sprawdzenia, czy jest lub nie jest odtwarzany plik dźwiękowy).
2 - (Loop) - Znacznik spowoduje, że plik będzie odtwarzany nieustannie. Odtwarzanie zakończy dopiero uruchomienie następnego pliku dźwiękowego.
Przykład1:
Odtworzenie (zaszeregowanie do kolejki serwera dźwiękowego) pliku dźwiękowego
JavaScriptVBScriptWybierz oraz skopiuj do schowka

Pm.PlaySound("file:#pmres:Sound/hoot01.wav;");
Przykład2:
Usunięcie wszystkich wymogów z kolejki serwera dźwiękowego, które zostały wytworzone przy pomocy metody PlaySound.
JavaScriptVBScriptWybierz oraz skopiuj do schowka

Pm.PlaySound("stop:1;");
Przykład3:
Wołanie metody w panelu, które działa w aplikacji lokalnej oraz w Webie (Chrome, Firefox, Edge, InternetExplorer ..). Projektant powinien zkonwertować plik wav do formatu mp3 oraz zapisać go katalogu #appres:.
JavaScriptWybierz oraz skopiuj do schowka

if (1 == pMe.Root.ClientType)
Pm.PlaySound("file:#pmres:Sound/hoot01.wav;");
else
Pm.PlaySound("file:#appres:hoot01.mp3;");
Navigacja:
 
- Pm
 
- Abs
- Cos
- E
- Exp
- LN2
- PI
- PlaySound
 
 
- Pow
- Sin
- Tan
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice