Discord
Meegeleverd met Macro DeckDemp je microfoon en geluid, neem deel aan spraakkanalen, wijzig spraakinstellingen en plaats webhookberichten in Discord vanaf je deck.
Het dialoogvenster Discord verbinden met de velden Client-ID en Clientgeheim
- Knoppen voor microfoon en geluid die je echte status tonen
- Neem deel aan spraakkanalen, verlaat ze en open tekstkanalen
- Stel microfoon- en uitvoervolume, spraakmodus en spraakverwerking in
- Toon een eigen Rich Presence-activiteit op je profiel
- Plaats berichten en embeds in een kanaal via een webhook
De integratie Discord verbindt Macro Deck met de officiële Discord-desktopapp op dezelfde computer. Ze gebruikt de lokale RPC-interface van Discord, dezelfde die Discord aanbiedt aan apps die de client bedienen, dus je knoppen werken alsof je zelf in Discord klikt. Discord geeft deze toegang alleen aan applicaties die van jou zijn, daarom vraagt het instellen je om een gratis applicatie aan te maken in het Discord Developer Portal en die één keer te autoriseren.
Wat je kunt doen
- Demp je microfoon of schakel je geluid uit met Microfoon dempen en Geluid uitschakelen. De knop toont of je gedempt bent, ook wanneer je in Discord zelf dempt.
- Neem deel aan een spraakkanaal op een van je servers, verlaat het huidige of open een tekstkanaal in de Discord-app.
- Stel je microfoon- en uitvoervolume in, verhoog of verlaag ze, wissel tussen Push-to-talk en Spraakactiviteit, en zet standaard ruisonderdrukking, echo-onderdrukking en automatische versterkingsregeling aan of uit.
- Toon een eigen activiteit op je profiel met Rich Presence instellen en verwijder die weer met Rich Presence wissen.
- Plaats een bericht, eventueel met een embed, in elk kanaal via een webhook met Webhook uitvoeren. Deze actie werkt zonder dat je de integratie instelt, zolang de integratie is ingeschakeld.
Een paar voorbeelden:
- Een knop Mic met Microfoon dempen in de modus Schakelen, waarvan de kleur de variabele
discord_is_self_mutedvolgt. - Een knop die deelneemt aan het spraakkanaal van je team en Verplaats me als ik al verbonden ben aanzet, zodat hij ook werkt terwijl je in een ander kanaal zit.
- Een actiestroom op de trigger Microfoon stilgelegd die een rood lampje aanzet, en een op Microfoon actief die het weer uitzet.
- Een knop die via een webhook "Stream is live" plaatst met een link naar je kanaal.
Hoe het werkt
Macro Deck maakt verbinding met Discord wanneer het start en maakt vanzelf opnieuw verbinding wanneer je Discord sluit en weer opent, waarbij het na elke mislukte poging iets langer wacht, tot maximaal een minuut. De triggers Verbonden en Niet verbonden worden dan geactiveerd. Zolang Discord niet verbonden is, worden de variabelen als niet beschikbaar weergegeven, behalve discord_is_connected. Wijzigingen die je in Discord maakt, en demping door een moderator, verschijnen meteen in de variabelen en triggers. Je kunt één Discord-account instellen.
Wat je nodig hebt
- De officiële Discord-desktopapp, draaiend op dezelfde computer als Macro Deck. Op Linux werken ook de Flatpak- en Snap-versies.
- Een Discord-account en een gratis eigen applicatie in het Discord Developer Portal.
- Macro Deck en Discord gestart met dezelfde rechten (geen van beide als administrator, of allebei).
- Alleen voor Webhook uitvoeren: een webhook-URL van een kanaal. Daarvoor moet de integratie ingeschakeld zijn, maar hoef je niets in te stellen.
Instellen
Stap 1: Maak een Discord-applicatie aan
Open het Discord Developer Portal en maak een nieuwe applicatie aan. De naam maakt niet uit. Kopieer de Application ID uit General Information: dat is de Client-ID.
Stap 2: Voeg de redirect-URI toe en kopieer het geheim
Open in je applicatie OAuth2. Voeg
http://localhost/toe als redirect en sla op. Dit adres wordt nooit geopend, Discord controleert alleen of het geregistreerd is. Kopieer daarna het Client Secret (reset het als Discord het niet toont).Stap 3: Open Discord in Macro Deck
Zorg dat de Discord-desktopapp draait. Klik in Macro Deck in de zijbalk op Integraties en daarna op Discord.
Stap 4: Vul de Client-ID en het clientgeheim in
Klik op het tabblad Overzicht in de sectie Configuratie op Instellen. De schakelaar rechtsboven aanzetten opent hetzelfde dialoogvenster. Plak in het dialoogvenster Discord verbinden de Client-ID en het Clientgeheim en klik op Doorgaan.
Stap 5: Autoriseer in Discord
Klik bij de stap Autoriseren in Discord op Doorgaan. Discord toont een autorisatievraag voor je applicatie: accepteer die. Macro Deck slaat de verbinding op als Discord met je gebruikersnaam tussen haakjes en schakelt de integratie in.
Stap 6: Voeg een actie aan een knop toe
Klik op de pagina Deck op een knop. Het deck moet ontgrendeld zijn: dat is zo wanneer rechtsboven de knop Vergrendelen staat. De editor opent met Kort indrukken geselecteerd. Klik op + Actie toevoegen, selecteer links in het dialoogvenster Actie toevoegen Discord, kies Microfoon dempen en zet Actie op Schakelen.
Stap 7: Druk op de knop
Druk op de knop op je deck. Discord dempt je microfoon, en de knop toont de gedempte status totdat je de demping opheft, vanaf het deck of in Discord.
Acties14
Zet deze op een knop of voer ze uit vanuit een actiestroom.
- Microfoon dempen
- Dempt je microfoon, heft de demping op of wisselt die.
- Geluid uitschakelen
- Schakelt je geluid uit, weer in of wisselt het.
- Standaard ruisonderdrukking
- Zet de standaard ruisonderdrukking van Discord aan of uit. Krisp kan hiermee niet worden bediend.
- Echo-onderdrukking
- Zet de echo-onderdrukking van Discord aan of uit.
- Automatische versterkingsregeling
- Zet de automatische versterkingsregeling aan of uit.
- Spraakmodus instellen
- Schakelt tussen push-to-talk en spraakactiviteit, of wisselt ertussen.
- Microfoonvolume instellen
- Stelt het microfoonvolume van Discord in, of verhoogt of verlaagt het.
- Uitvoervolume instellen
- Stelt het uitvoervolume van Discord in, of verhoogt of verlaagt het, tot 200%.
- Deelnemen aan spraakkanaal
- Verbindt je met een spraakkanaal op een van je servers en verplaatst je eventueel uit een ander kanaal.
- Spraakkanaal verlaten
- Verbreekt je verbinding met het huidige spraakkanaal.
- Tekstkanaal openen
- Opent een tekstkanaal in de Discord-app.
- Rich Presence instellen
- Toont een eigen activiteit (speelt, luistert naar, kijkt naar of doet mee aan) met details, afbeeldingen en verstreken tijd op je profiel.
- Rich Presence wissen
- Verwijdert de activiteit die Macro Deck op je profiel heeft ingesteld.
- Webhook uitvoeren
- Stuurt een bericht, eventueel met een embed, naar een kanaal via een webhook-URL. Werkt zonder instellen.
Triggers18
Een knop of actiestroom kan op deze gebeurtenissen reageren.
- Verbonden
- Macro Deck heeft verbinding gemaakt met de Discord-app.
- Niet verbonden
- De Discord-app is gesloten of de verbinding is verbroken.
- Microfoon gedempt
- Je hebt je eigen microfoon gedempt.
- Demping opgeheven
- Je hebt de demping van je eigen microfoon opgeheven.
- Geluid uitgeschakeld
- Je hebt je geluid uitgeschakeld.
- Geluid ingeschakeld
- Je hebt je geluid weer ingeschakeld.
- Server: gedempt
- Een moderator heeft je gedempt.
- Server: demping opgeheven
- Een moderator heeft je demping opgeheven.
- Server: geluid uitgeschakeld
- Een moderator heeft je geluid uitgeschakeld.
- Server: geluid ingeschakeld
- Een moderator heeft je geluid weer ingeschakeld.
- Microfoon stilgelegd
- Je microfoon zendt om welke reden dan ook niet meer uit: demping of uitgeschakeld geluid door jou of een moderator.
- Microfoon actief
- Je microfoon kan weer uitzenden: er is geen demping en geen uitgeschakeld geluid actief.
- Spraakkanaal betreden
- Je bent een spraakkanaal binnengegaan, optioneel alleen een bepaald kanaal.
- Spraakkanaal verlaten
- Je hebt een spraakkanaal verlaten, optioneel alleen een bepaald kanaal.
- Status van spraakverbinding gewijzigd
- De status van de spraakverbinding van Discord is gewijzigd, bijvoorbeeld naar
VOICE_CONNECTED, met de gemiddelde ping. - Iemand begint te spreken
- Iemand in je huidige spraakkanaal begint te spreken, met de informatie of jij het bent.
- Iemand stopt met spreken
- Iemand in je huidige spraakkanaal is gestopt met spreken, met de informatie of jij het bent.
- Melding ontvangen
- Discord heeft een bureaubladmelding getoond, met de titel en tekst.
Variabelen11
Toon deze waarden op knoppen en widgets, of gebruik ze in voorwaarden.
discord_is_connected- Of Macro Deck met de Discord-app verbonden is.
discord_user_name- De naam van het verbonden account.
discord_is_self_muted,discord_is_self_deafened- Of je jezelf hebt gedempt of je eigen geluid hebt uitgeschakeld.
discord_is_server_muted,discord_is_server_deafened- Of een moderator je heeft gedempt of je geluid heeft uitgeschakeld.
discord_is_muted,discord_is_deafened- Of je om welke reden dan ook gedempt bent of je geluid uit staat.
discord_is_speaking- Of je op dit moment spreekt.
discord_is_in_voice_channel,discord_voice_channel,discord_voice_server- Of je in een spraakkanaal zit, en de namen van het kanaal en de server.
discord_voice_connection_state,discord_voice_ping- De status van de spraakverbinding en de gemiddelde ping in milliseconden.
discord_input_volume,discord_output_volume- Het invoer- en uitvoervolume van Discord in procent. Je kunt ze ook instellen, bijvoorbeeld met een schuifregelaar.
discord_voice_mode- Of Discord push-to-talk of spraakactiviteit gebruikt.
discord_noise_suppression,discord_echo_cancellation,discord_automatic_gain_control- Of ruisonderdrukking, echo-onderdrukking en automatische versterkingsregeling aan staan.
Veelgestelde vragen
Waarom heb ik een eigen Discord-applicatie nodig?
Discord geeft de rechten om de client te bedienen alleen aan applicaties waarvan je in het team zit. Je eigen applicatie is gratis, en Macro Deck gebruikt de Client-ID en het Clientgeheim alleen om bij Discord te autoriseren.
Werkt het met Vesktop, Legcord of andere Discord-clients?
Nee. Clients van derden kunnen game-activiteit delen, maar Macro Deck kan ze niet bedienen. Start de officiële Discord-desktopapp; de andere client kan ernaast blijven draaien.
Werkt het als Discord op een andere computer draait?
Nee. Macro Deck praat met Discord via een lokale verbinding, dus Discord moet draaien op de computer waarop Macro Deck draait. Alleen Webhook uitvoeren werkt zonder de Discord-app.
Het instellen meldt dat Discord de verbinding heeft geweigerd. Wat is er mis?
Macro Deck en Discord draaien met verschillende rechten, bijvoorbeeld omdat een van beide is gestart met Als administrator uitvoeren. Start ze allebei op dezelfde manier en probeer het opnieuw.
Een spraakinstelling verandert niet. Waarom?
Een andere app die met Discord verbonden is, kan de spraakinstellingen vasthouden, of Discord negeert geavanceerde spraakinstellingen terwijl Krisp actief is. Sluit andere apps die Discord bedienen, wijzig de instelling één keer in de Discord-instellingen Spraak en video en voer de actie daarna opnieuw uit.
Waar worden mijn inloggegevens opgeslagen?
Het Clientgeheim en de tokens die Discord teruggeeft, worden versleuteld op je computer opgeslagen en alleen naar Discord gestuurd. Wanneer Discord de opgeslagen autorisatie niet meer accepteert, toont de integratie Discord-autorisatie verlopen met een knop Opnieuw verbinden.
Meer in Chat en spraak
Discord-webhooks
Meegeleverd met Macro DeckPlaats uitgebreide berichten met embeds en vermeldingen via webhooks in Discord-kanalen, met een live voorbeeld.
SinusBot
Meegeleverd met Macro DeckBedien de muziek van je SinusBot-instanties en toon op je deck wat ze afspelen.