Discord
Dołączona do Macro DeckWyciszaj się, ogłuszaj, dołączaj do kanałów głosowych, zmieniaj ustawienia głosu i publikuj wiadomości przez webhooki w Discordzie z decku.
Okno Połącz z Discordem z polami Identyfikator klienta i Sekret klienta
- Przyciski wyciszenia i ogłuszenia pokazujące rzeczywisty stan
- Dołączanie do kanałów głosowych, ich opuszczanie i otwieranie kanałów tekstowych
- Ustawianie głośności mikrofonu i wyjścia, trybu głosu i przetwarzania głosu
- Własna aktywność Rich Presence na profilu
- Publikowanie wiadomości i embedów na kanale przez webhook
Integracja Discord łączy Macro Deck z oficjalną aplikacją Discord na tym samym komputerze. Korzysta z lokalnego interfejsu RPC Discorda, tego samego, który Discord udostępnia aplikacjom sterującym klientem, więc przyciski działają tak, jakby kliknięcie nastąpiło w samym Discordzie. Discord daje taki dostęp tylko aplikacjom należącym do użytkownika, dlatego konfiguracja wymaga utworzenia bezpłatnej aplikacji w Discord Developer Portal i jednorazowej autoryzacji.
Możliwości
- Wyciszanie i ogłuszanie się akcjami Wyciszenie mikrofonu i Ogłuszenie. Przycisk pokazuje, czy wyciszenie jest aktywne, także gdy wyciszono się w samym Discordzie.
- Dołączanie do kanału głosowego na jednym z serwerów, opuszczanie bieżącego kanału oraz otwieranie kanału tekstowego w aplikacji Discord.
- Ustawianie, zwiększanie i zmniejszanie głośności mikrofonu i wyjścia, przełączanie między Naciśnij, aby mówić a Aktywacja głosem oraz włączanie i wyłączanie standardowej redukcji szumów, redukcji echa i automatycznej regulacji wzmocnienia.
- Wyświetlanie własnej aktywności na profilu akcją Ustaw Rich Presence i usuwanie jej akcją Wyczyść Rich Presence.
- Publikowanie wiadomości, opcjonalnie z embedem, na dowolnym kanale przez webhook akcją Wykonaj webhook. Ta akcja działa bez konfigurowania integracji, o ile integracja jest włączona.
Przykładowe zastosowania:
- Przycisk Mikrofon z akcją Wyciszenie mikrofonu w trybie Przełącz, którego kolor zależy od zmiennej
discord_is_self_muted. - Przycisk, który dołącza do kanału głosowego zespołu z włączoną opcją Przenieś mnie, jeśli jestem już połączony, więc działa też podczas pobytu na innym kanale.
- Przebieg na wyzwalaczu Mikrofon uciszony, który włącza czerwone światło, i drugi na Mikrofon aktywny, który je wyłącza.
- Przycisk, który przez webhook publikuje wiadomość „Stream is live” z linkiem do kanału.
Działanie
Macro Deck łączy się z Discordem przy uruchomieniu i sam łączy się ponownie po zamknięciu i ponownym otwarciu Discorda, czekając po każdej nieudanej próbie nieco dłużej, maksymalnie minutę. Wyzwalacze Połączono i Rozłączono uruchamiają się, gdy to nastąpi. Gdy Discord nie jest połączony, zmienne są niedostępne, z wyjątkiem discord_is_connected. Zmiany wprowadzone w Discordzie i wyciszenia przez moderatora od razu pojawiają się w zmiennych i wyzwalaczach. Można skonfigurować jedno konto Discord.
Czego potrzebujesz
- Oficjalna aplikacja Discord na komputer, uruchomiona na tym samym komputerze co Macro Deck. W systemie Linux działają też wersje Flatpak i Snap.
- Konto Discord i własna bezpłatna aplikacja w Discord Developer Portal.
- Macro Deck i Discord uruchomione z tymi samymi uprawnieniami (żaden z nich jako administrator albo oba).
- Tylko dla Wykonaj webhook: adres URL webhooka kanału. Wymaga włączonej integracji, ale nie wymaga konfiguracji.
Konfiguracja krok po kroku
Krok 1: Utwórz aplikację Discord
Otwórz Discord Developer Portal i utwórz nową aplikację. Nazwa nie ma znaczenia. Skopiuj Application ID z sekcji General Information: to jest Identyfikator klienta.
Krok 2: Dodaj URI przekierowania i skopiuj sekret
W aplikacji otwórz OAuth2. Dodaj
http://localhost/jako przekierowanie i zapisz. Ten adres nigdy nie jest otwierany, Discord sprawdza tylko, czy jest zarejestrowany. Następnie skopiuj Client Secret (zresetuj go, jeśli Discord go nie pokazuje).Krok 3: Otwórz Discorda w Macro Deck
Upewnij się, że aplikacja Discord jest uruchomiona. W Macro Deck kliknij Integracje na pasku bocznym, a następnie Discord.
Krok 4: Wprowadź identyfikator i sekret klienta
Na karcie Przegląd kliknij Skonfiguruj w sekcji Konfiguracja. Włączenie przełącznika w prawym górnym rogu otwiera to samo okno. W oknie Połącz z Discordem wklej Identyfikator klienta i Sekret klienta, a następnie kliknij Dalej.
Krok 5: Autoryzuj w Discordzie
W kroku Autoryzuj w Discordzie kliknij Dalej. Discord wyświetli monit o autoryzację aplikacji: zaakceptuj go. Macro Deck zapisze połączenie jako Discord z nazwą użytkownika w nawiasie i włączy integrację.
Krok 6: Dodaj akcję do przycisku
Na stronie Deck kliknij przycisk. Deck musi być odblokowany: jest odblokowany, gdy w prawym górnym rogu widać przycisk Zablokuj. Otworzy się edytor z zaznaczonym Krótkie naciśnięcie. Kliknij + Dodaj akcję, po lewej stronie okna Dodaj akcję wybierz Discord, wybierz Wyciszenie mikrofonu i ustaw Akcja na Przełącz.
Krok 7: Naciśnij przycisk
Naciśnij przycisk na decku. Discord wyciszy mikrofon, a przycisk będzie pokazywać stan wyciszenia do czasu jego wyłączenia z decku lub w Discordzie.
Akcje14
Przypisz je do przycisku lub uruchamiaj w przebiegu.
- Wyciszenie mikrofonu
- Wycisza mikrofon, wyłącza wyciszenie lub je przełącza.
- Ogłuszenie
- Włącza ogłuszenie, wyłącza je lub przełącza.
- Standardowa redukcja szumów
- Włącza lub wyłącza standardową redukcję szumów Discorda. Nie steruje Krisp.
- Redukcja echa
- Włącza lub wyłącza redukcję echa Discorda.
- Automatyczna regulacja wzmocnienia
- Włącza lub wyłącza automatyczną regulację wzmocnienia.
- Ustaw tryb głosu
- Przełącza między trybem naciśnij, aby mówić a aktywacją głosem albo przełącza je naprzemiennie.
- Ustaw głośność mikrofonu
- Ustawia, zwiększa lub zmniejsza głośność mikrofonu w Discordzie.
- Ustaw głośność wyjścia
- Ustawia, zwiększa lub zmniejsza głośność wyjścia w Discordzie, maksymalnie do 200%.
- Dołącz do kanału głosowego
- Łączy z kanałem głosowym na jednym z serwerów, opcjonalnie przenosząc z innego kanału.
- Opuść kanał głosowy
- Rozłącza z bieżącym kanałem głosowym.
- Otwórz kanał tekstowy
- Otwiera kanał tekstowy w aplikacji Discord.
- Ustaw Rich Presence
- Wyświetla na profilu własną aktywność (gra w, słucha, ogląda lub rywalizuje w) ze szczegółami, obrazami i upływającym czasem.
- Wyczyść Rich Presence
- Usuwa aktywność ustawioną na profilu przez Macro Deck.
- Wykonaj webhook
- Wysyła wiadomość, opcjonalnie z embedem, na kanał przez adres URL webhooka. Działa bez konfiguracji.
Wyzwalacze18
Przycisk lub przebieg może reagować na te zdarzenia.
- Połączono
- Macro Deck połączył się z aplikacją Discord.
- Rozłączono
- Aplikacja Discord została zamknięta lub połączenie zostało przerwane.
- Mikrofon wyciszony
- Własny mikrofon został wyciszony.
- Mikrofon niewyciszony
- Wyciszenie własnego mikrofonu zostało wyłączone.
- Ogłuszono
- Włączono własne ogłuszenie.
- Wyłączono ogłuszenie
- Wyłączono własne ogłuszenie.
- Wyciszono przez serwer
- Moderator wyciszył użytkownika.
- Wyłączono wyciszenie przez serwer
- Moderator wyłączył wyciszenie użytkownika.
- Ogłuszono przez serwer
- Moderator ogłuszył użytkownika.
- Wyłączono ogłuszenie przez serwer
- Moderator wyłączył ogłuszenie użytkownika.
- Mikrofon uciszony
- Mikrofon przestał nadawać z dowolnego powodu: wyciszenie lub ogłuszenie przez użytkownika albo moderatora.
- Mikrofon aktywny
- Mikrofon znów może nadawać: nie działa żadne wyciszenie ani ogłuszenie.
- Dołączono do kanału głosowego
- Dołączono do kanału głosowego, opcjonalnie tylko do określonego.
- Opuszczono kanał głosowy
- Opuszczono kanał głosowy, opcjonalnie tylko określony.
- Zmiana stanu połączenia głosowego
- Połączenie głosowe Discorda zmieniło stan, np. na
VOICE_CONNECTED, wraz ze średnim pingiem. - Ktoś zaczął mówić
- Ktoś na bieżącym kanale głosowym zaczął mówić, wraz z informacją, czy to bieżący użytkownik.
- Ktoś przestał mówić
- Ktoś na bieżącym kanale głosowym przestał mówić, wraz z informacją, czy to bieżący użytkownik.
- Otrzymano powiadomienie
- Discord wyświetlił powiadomienie na pulpicie, wraz z jego tytułem i treścią.
Zmienne11
Wyświetlaj te wartości na przyciskach i widżetach albo używaj ich w warunkach.
discord_is_connected- Czy Macro Deck jest połączony z aplikacją Discord.
discord_user_name- Nazwa połączonego konta.
discord_is_self_muted,discord_is_self_deafened- Czy użytkownik sam się wyciszył lub ogłuszył.
discord_is_server_muted,discord_is_server_deafened- Czy moderator wyciszył lub ogłuszył użytkownika.
discord_is_muted,discord_is_deafened- Czy użytkownik jest wyciszony lub ogłuszony z dowolnego powodu.
discord_is_speaking- Czy użytkownik właśnie mówi.
discord_is_in_voice_channel,discord_voice_channel,discord_voice_server- Czy użytkownik jest na kanale głosowym oraz nazwy kanału i jego serwera.
discord_voice_connection_state,discord_voice_ping- Stan połączenia głosowego i jego średni ping w milisekundach.
discord_input_volume,discord_output_volume- Głośność wejścia i wyjścia Discorda w procentach. Można je też ustawiać, np. suwakiem.
discord_voice_mode- Czy Discord używa trybu naciśnij, aby mówić, czy aktywacji głosem.
discord_noise_suppression,discord_echo_cancellation,discord_automatic_gain_control- Czy redukcja szumów, redukcja echa i automatyczna regulacja wzmocnienia są włączone.
Najczęściej zadawane pytania
Dlaczego potrzebuję własnej aplikacji Discord?
Discord przyznaje uprawnienia do sterowania klientem tylko aplikacjom, w których zespole jest użytkownik. Własna aplikacja jest bezpłatna, a Macro Deck używa jej wartości Identyfikator klienta i Sekret klienta wyłącznie do autoryzacji w Discordzie.
Czy to działa z Vesktop, Legcord lub innymi klientami Discorda?
Nie. Klienci innych firm mogą udostępniać aktywność w grach, ale Macro Deck nie może nimi sterować. Uruchom oficjalną aplikację Discord na komputer; drugi klient może działać obok niej.
Czy to działa, gdy Discord jest uruchomiony na innym komputerze?
Nie. Macro Deck komunikuje się z Discordem przez połączenie lokalne, więc Discord musi działać na komputerze, na którym działa Macro Deck. Bez aplikacji Discord działa tylko Wykonaj webhook.
Konfiguracja informuje, że Discord odmówił połączenia. Co jest nie tak?
Macro Deck i Discord działają z różnymi uprawnieniami, np. jeden z nich uruchomiono przez Uruchom jako administrator. Uruchom oba w ten sam sposób i spróbuj ponownie.
Ustawienie głosu się nie zmienia. Dlaczego?
Inna aplikacja połączona z Discordem może przejmować ustawienia głosu albo Discord ignoruje zaawansowane ustawienia głosu, gdy aktywny jest Krisp. Zamknij inne aplikacje sterujące Discordem, zmień ustawienie raz w ustawieniach Głos i wideo Discorda, a następnie uruchom akcję ponownie.
Gdzie są przechowywane moje dane uwierzytelniające?
Sekret klienta i tokeny zwracane przez Discorda są przechowywane w postaci zaszyfrowanej na komputerze i wysyłane tylko do Discorda. Gdy Discord przestanie akceptować zapisaną autoryzację, integracja pokaże Autoryzacja Discorda wygasła z przyciskiem Połącz ponownie.
Więcej w kategorii Czat i głos
Webhooki Discorda
Dołączona do Macro DeckPublikuj rozbudowane wiadomości z embedami i wzmiankami na kanałach Discorda przez webhooki, z podglądem na żywo.
SinusBot
Dołączona do Macro DeckSteruj muzyką instancji SinusBot i pokazuj na decku, co odtwarzają.