webchat-audio-notifications

Umożliwia dodanie powiadomień audio do webchat Moltbot/Clawdbot z pięcioma poziomami intensywności – od szeptu do niemożliwego do przeoczenia. Powiadomienia aktywują się tylko wtedy, gdy karta przeglądarki znajduje się w tle, dzięki czemu nie rozpraszają podczas aktywnej rozmowy. Obsługuje Chrome 92+, Firefox 90+, Safari 15+ i Edge 92+. Wykorzystuje bibliotekę Howler.js do niezawodnego odtwarzania dźwięków w przeglądarce.

1. Pobierz pliki umiejętności z repozytorium i skopiuj je do katalogu webchat: howler.min.js do folderu /webchat/js/, notification.js do /webchat/js/ oraz folder sounds/ z plikami notification.mp3 i alert.mp3 do /webchat/sounds/.

2. Otwórz plik HTML webchat i dodaj przed zamykającym tagiem trzy bloki skryptów: najpierw załaduj bibliotekę Howler.js, następnie notification.js, a na koniec zainicjuj obiekt WebchatNotifications z ścieżką do plików dźwiękowych (soundPath: '/sounds/notification').

3. Połącz powiadomienia z obsługą zdarzeń wiadomości – w kodzie obsługującym socket.on('message') dodaj wywołanie notifier.notify(), aby system odtwarzał dźwięk za każdym razem, gdy nadejdzie nowa wiadomość.

4. Przetestuj funkcjonalność przełączając się na inną kartę przeglądarki i wysyłając wiadomość – powiadomienie audio powinno się odtworzyć tylko wtedy, gdy karta webchat jest w tle.

5. W razie potrzeby dostosuj poziom głośności i typ dźwięku, edytując parametry inicjalizacji WebchatNotifications – dokumentacja pełna znajduje się w pliku docs/integration.md.