Discord
In Macro Deck enthaltenSchalte dich stumm oder taub, tritt Sprachkanälen bei, ändere Spracheinstellungen und poste Webhook-Nachrichten in Discord von deinem Deck aus.
Der Dialog Discord verbinden mit den Feldern Client-ID und Client-Secret
- Tasten für Stumm- und Taubschalten, die deinen echten Zustand zeigen
- Sprachkanälen beitreten oder sie verlassen und Textkanäle öffnen
- Mikrofon- und Ausgabelautstärke, Sprachmodus und Sprachverarbeitung einstellen
- Eine eigene Rich-Presence-Aktivität auf deinem Profil zeigen
- Nachrichten und Embeds über einen Webhook in einem Kanal posten
Die Discord-Integration verbindet Macro Deck mit der offiziellen Discord-Desktop-App auf demselben Computer. Sie nutzt die lokale RPC-Schnittstelle von Discord, dieselbe, die Discord Apps zum Steuern des Clients anbietet, sodass deine Tasten so wirken, als würdest du selbst in Discord klicken. Discord gewährt diesen Zugriff nur Anwendungen, die dir gehören, daher bittet dich die Einrichtung, im Discord Developer Portal eine kostenlose Anwendung zu erstellen und sie einmal zu autorisieren.
Was du damit machen kannst
- Dich mit Mikrofon stummschalten und Ton stummschalten stumm- oder taubschalten. Die Taste zeigt, ob du stummgeschaltet bist, auch wenn du dich direkt in Discord stummschaltest.
- Einem Sprachkanal auf einem deiner Server beitreten, den aktuellen verlassen oder einen Textkanal in der Discord-App öffnen.
- Deine Mikrofon- und Ausgabelautstärke festlegen, erhöhen oder verringern, zwischen Push-to-Talk und Sprachaktivierung wechseln und Standard-Rauschunterdrückung, Echounterdrückung und automatische Verstärkungsregelung ein- oder ausschalten.
- Mit Rich Presence festlegen eine eigene Aktivität auf deinem Profil zeigen und sie mit Rich Presence entfernen wieder entfernen.
- Mit Webhook ausführen eine Nachricht, optional mit Embed, über einen Webhook in einem beliebigen Kanal posten. Diese Aktion funktioniert, ohne die Integration einzurichten, solange die Integration eingeschaltet ist.
Einige Beispiele:
- Eine Taste Mikro mit Mikrofon stummschalten im Modus Umschalten, deren Farbe der Variable
discord_is_self_mutedfolgt. - Eine Taste, die dem Sprachkanal deines Teams beitritt und Mich verschieben, falls bereits verbunden aktiviert, damit sie auch funktioniert, während du in einem anderen Kanal bist.
- Ein Ablauf auf den Auslöser Mikrofon stumm, der ein rotes Licht einschaltet, und einer auf Mikrofon aktiv, der es wieder ausschaltet.
- Eine Taste, die über einen Webhook „Stream ist live“ mit einem Link zu deinem Kanal postet.
So verhält sich die Integration
Macro Deck verbindet sich beim Start mit Discord und verbindet sich von selbst neu, wenn du Discord schließt und wieder öffnest, und wartet nach jedem fehlgeschlagenen Versuch etwas länger, bis zu einer Minute. Dabei lösen die Auslöser Verbunden und Verbindung getrennt aus. Solange Discord nicht verbunden ist, gelten die Variablen als nicht verfügbar, außer discord_is_connected. Änderungen, die du in Discord vornimmst, und Stummschaltungen durch einen Moderator erscheinen sofort in den Variablen und Auslösern. Du kannst ein Discord-Konto einrichten.
Das brauchst du
- Die offizielle Discord-Desktop-App, die auf demselben Computer wie Macro Deck läuft. Unter Linux funktionieren auch die Flatpak- und Snap-Versionen.
- Ein Discord-Konto und eine kostenlose eigene Anwendung im Discord Developer Portal.
- Macro Deck und Discord mit denselben Rechten gestartet (keines von beiden als Administrator, oder beide).
- Nur für Webhook ausführen: eine Webhook-URL eines Kanals. Dafür muss die Integration eingeschaltet sein, eine Einrichtung ist nicht nötig.
So richtest du sie ein
Schritt 1: Discord-Anwendung erstellen
Öffne das Discord Developer Portal und erstelle eine neue Anwendung. Der Name spielt keine Rolle. Kopiere die Application ID unter General Information: Das ist die Client-ID.
Schritt 2: Redirect-URI hinzufügen und Secret kopieren
Öffne in deiner Anwendung OAuth2. Füge
http://localhost/als Redirect hinzu und speichere. Diese Adresse wird nie geöffnet, Discord prüft nur, ob sie registriert ist. Kopiere dann das Client Secret (setze es zurück, wenn Discord es nicht anzeigt).Schritt 3: Discord in Macro Deck öffnen
Stelle sicher, dass die Discord-Desktop-App läuft. Klicke in Macro Deck in der Seitenleiste auf Integrationen und dann auf Discord.
Schritt 4: Client-ID und Client-Secret eingeben
Klicke im Tab Übersicht im Abschnitt Konfiguration auf Einrichten. Der Schalter oben rechts öffnet denselben Dialog. Füge im Dialog Discord verbinden die Client-ID und das Client-Secret ein und klicke auf Fortfahren.
Schritt 5: In Discord autorisieren
Klicke beim Schritt In Discord autorisieren auf Fortfahren. Discord zeigt eine Autorisierungsabfrage für deine Anwendung: Akzeptiere sie. Macro Deck speichert die Verbindung als Discord mit deinem Benutzernamen in Klammern und schaltet die Integration ein.
Schritt 6: Aktion zu einer Taste hinzufügen
Klicke auf der Seite Deck auf eine Taste. Das Deck muss entsperrt sein: Das ist es, wenn oben rechts die Schaltfläche Sperren zu sehen ist. Der Editor öffnet sich mit ausgewähltem Kurzer Druck. Klicke auf + Aktion hinzufügen, wähle links im Dialog Aktion hinzufügen Discord, nimm Mikrofon stummschalten und setze Aktion auf Umschalten.
Schritt 7: Taste drücken
Drücke die Taste auf deinem Deck. Discord schaltet dein Mikrofon stumm, und die Taste zeigt den stummgeschalteten Zustand, bis du die Stummschaltung aufhebst, über das Deck oder in Discord.
Aktionen14
Lege sie auf eine Taste oder führe sie in einem Ablauf aus.
- Mikrofon stummschalten
- Schaltet dein Mikrofon stumm, hebt die Stummschaltung auf oder schaltet sie um.
- Ton stummschalten
- Schaltet dich taub, hebt die Taubschaltung auf oder schaltet sie um.
- Standard-Rauschunterdrückung
- Schaltet die Standard-Rauschunterdrückung von Discord ein oder aus. Krisp lässt sich damit nicht steuern.
- Echounterdrückung
- Schaltet die Echounterdrückung von Discord ein oder aus.
- Automatische Verstärkungsregelung
- Schaltet die automatische Verstärkungsregelung ein oder aus.
- Sprachmodus festlegen
- Wechselt zwischen Push-to-Talk und Sprachaktivierung oder schaltet zwischen beiden um.
- Mikrofonlautstärke festlegen
- Setzt, erhöht oder verringert die Mikrofonlautstärke von Discord.
- Ausgabelautstärke festlegen
- Setzt, erhöht oder verringert die Ausgabelautstärke von Discord, bis zu 200 %.
- Sprachkanal beitreten
- Verbindet dich mit einem Sprachkanal auf einem deiner Server und verschiebt dich auf Wunsch aus einem anderen Kanal.
- Sprachkanal verlassen
- Trennt dich vom aktuellen Sprachkanal.
- Textkanal öffnen
- Öffnet einen Textkanal in der Discord-App.
- Rich Presence festlegen
- Zeigt eine eigene Aktivität (spielt, hört, sieht oder tritt an in) mit Details, Bildern und verstrichener Zeit auf deinem Profil.
- Rich Presence entfernen
- Entfernt die Aktivität, die Macro Deck auf deinem Profil gesetzt hat.
- Webhook ausführen
- Sendet eine Nachricht, optional mit Embed, über eine Webhook-URL in einen Kanal. Funktioniert ohne Einrichtung.
Auslöser18
Eine Taste oder ein Ablauf kann auf diese Ereignisse reagieren.
- Verbunden
- Macro Deck hat sich mit der Discord-App verbunden.
- Verbindung getrennt
- Die Discord-App wurde geschlossen oder die Verbindung ist abgebrochen.
- Mikrofon stummgeschaltet
- Du hast dein eigenes Mikrofon stummgeschaltet.
- Stummschaltung aufgehoben
- Du hast die Stummschaltung deines eigenen Mikrofons aufgehoben.
- Taubgeschaltet
- Du hast dich taubgeschaltet.
- Taubschaltung aufgehoben
- Du hast deine Taubschaltung aufgehoben.
- Vom Server stummgeschaltet
- Ein Moderator hat dich stummgeschaltet.
- Stummschaltung vom Server aufgehoben
- Ein Moderator hat deine Stummschaltung aufgehoben.
- Vom Server taubgeschaltet
- Ein Moderator hat dich taubgeschaltet.
- Taubschaltung vom Server aufgehoben
- Ein Moderator hat deine Taubschaltung aufgehoben.
- Mikrofon stumm
- Dein Mikrofon überträgt aus irgendeinem Grund nicht mehr: eine Stumm- oder Taubschaltung durch dich oder einen Moderator.
- Mikrofon aktiv
- Dein Mikrofon kann wieder übertragen: Es gilt keine Stumm- und keine Taubschaltung.
- Sprachkanal beigetreten
- Du bist einem Sprachkanal beigetreten, auf Wunsch nur einem bestimmten.
- Sprachkanal verlassen
- Du hast einen Sprachkanal verlassen, auf Wunsch nur einen bestimmten.
- Sprachverbindungsstatus geändert
- Der Status der Sprachverbindung von Discord hat sich geändert, zum Beispiel zu
VOICE_CONNECTED, mit dem durchschnittlichen Ping. - Jemand hat zu sprechen begonnen
- Jemand in deinem aktuellen Sprachkanal hat zu sprechen begonnen, mit der Angabe, ob du es bist.
- Jemand hat aufgehört zu sprechen
- Jemand in deinem aktuellen Sprachkanal hat aufgehört zu sprechen, mit der Angabe, ob du es bist.
- Benachrichtigung erhalten
- Discord hat eine Desktop-Benachrichtigung gezeigt, mit Titel und Text.
Variablen11
Zeige diese Werte auf Tasten und Widgets an oder nutze sie in Bedingungen.
discord_is_connected- Ob Macro Deck mit der Discord-App verbunden ist.
discord_user_name- Der Name des verbundenen Kontos.
discord_is_self_muted,discord_is_self_deafened- Ob du dich selbst stumm- oder taubgeschaltet hast.
discord_is_server_muted,discord_is_server_deafened- Ob ein Moderator dich stumm- oder taubgeschaltet hat.
discord_is_muted,discord_is_deafened- Ob du aus irgendeinem Grund stumm- oder taubgeschaltet bist.
discord_is_speaking- Ob du gerade sprichst.
discord_is_in_voice_channel,discord_voice_channel,discord_voice_server- Ob du in einem Sprachkanal bist, und die Namen des Kanals und seines Servers.
discord_voice_connection_state,discord_voice_ping- Der Status der Sprachverbindung und ihr durchschnittlicher Ping in Millisekunden.
discord_input_volume,discord_output_volume- Eingabe- und Ausgabelautstärke von Discord in Prozent. Du kannst sie auch setzen, zum Beispiel mit einem Schieberegler.
discord_voice_mode- Ob Discord Push-to-Talk oder Sprachaktivierung verwendet.
discord_noise_suppression,discord_echo_cancellation,discord_automatic_gain_control- Ob Rauschunterdrückung, Echounterdrückung und automatische Verstärkungsregelung eingeschaltet sind.
Häufige Fragen
Warum brauche ich eine eigene Discord-Anwendung?
Discord gewährt die Berechtigungen zum Steuern des Clients nur Anwendungen, in deren Team du bist. Deine eigene Anwendung ist kostenlos, und Macro Deck verwendet ihre Client-ID und ihr Client-Secret nur, um sich bei Discord zu autorisieren.
Funktioniert das mit Vesktop, Legcord oder anderen Discord-Clients?
Nein. Drittanbieter-Clients können Spielaktivität teilen, aber Macro Deck kann sie nicht steuern. Starte die offizielle Discord-Desktop-App; der andere Client kann parallel weiterlaufen.
Funktioniert das, wenn Discord auf einem anderen Computer läuft?
Nein. Macro Deck spricht über eine lokale Verbindung mit Discord, daher muss Discord auf dem Computer laufen, auf dem Macro Deck läuft. Nur Webhook ausführen funktioniert ohne die Discord-App.
Die Einrichtung meldet, dass Discord die Verbindung abgelehnt hat. Was ist falsch?
Macro Deck und Discord laufen mit unterschiedlichen Rechten, zum Beispiel wurde eines von beiden mit Als Administrator ausführen gestartet. Starte beide auf dieselbe Weise und versuche es erneut.
Eine Spracheinstellung ändert sich nicht. Warum?
Eine andere mit Discord verbundene App hält möglicherweise die Spracheinstellungen, oder Discord ignoriert erweiterte Spracheinstellungen, solange Krisp aktiv ist. Schließe andere Apps, die Discord steuern, ändere die Einstellung einmal in den Discord-Einstellungen unter Sprache & Video und führe die Aktion dann erneut aus.
Wo werden meine Zugangsdaten gespeichert?
Das Client-Secret und die Tokens, die Discord zurückgibt, werden verschlüsselt auf deinem Computer gespeichert und nur an Discord gesendet. Akzeptiert Discord die gespeicherte Autorisierung nicht mehr, zeigt die Integration Discord-Autorisierung abgelaufen mit einer Schaltfläche Erneut verbinden.
Mehr in „Chat und Sprache“
Discord-Webhooks
In Macro Deck enthaltenPoste umfangreiche Nachrichten mit Embeds und Erwähnungen über Webhooks in Discord-Kanäle, mit Live-Vorschau.
SinusBot
In Macro Deck enthaltenSteuere die Musik deiner SinusBot-Instanzen und zeige auf deinem Deck, was sie spielen.