Discord
Incluse avec Macro DeckCoupez le micro et le son, rejoignez des canaux vocaux, modifiez vos réglages vocaux et publiez des messages par webhook dans Discord depuis votre deck.
La boîte de dialogue Connecter Discord avec les champs ID client et Secret client
- Des boutons de sourdine qui affichent votre état réel
- Rejoignez ou quittez des canaux vocaux et ouvrez des canaux textuels
- Réglez le volume du microphone et de sortie, le mode vocal et le traitement de la voix
- Affichez une activité personnalisée (statut enrichi) sur votre profil
- Publiez des messages et des embeds dans un canal via un webhook
L'intégration Discord relie Macro Deck à l'application de bureau officielle Discord sur le même ordinateur. Elle utilise l'interface RPC locale de Discord, celle que Discord propose aux applications qui pilotent le client : vos boutons agissent donc comme si vous cliquiez vous-même dans Discord. Discord ne donne cet accès qu'aux applications dont vous êtes propriétaire, c'est pourquoi la configuration vous demande de créer une application gratuite dans le Discord Developer Portal et de l'autoriser une fois.
Ce que vous pouvez faire
- Couper votre micro ou votre son avec Couper le microphone et Couper le son entrant. Le bouton indique si votre micro est coupé, même quand vous le coupez dans Discord.
- Rejoindre un canal vocal sur l'un de vos serveurs, quitter le canal actuel ou ouvrir un canal textuel dans l'application Discord.
- Définir, augmenter ou diminuer le volume de votre microphone et de sortie, basculer entre Appuyer pour parler et Détection vocale, et activer ou désactiver la suppression de bruit standard, la suppression d'écho et le contrôle automatique du gain.
- Afficher une activité personnalisée sur votre profil avec Définir le statut enrichi, et la retirer avec Effacer le statut enrichi.
- Publier un message, avec un embed facultatif, dans n'importe quel canal via un webhook avec Exécuter un webhook. Cette action fonctionne sans configurer l'intégration, à condition que l'intégration soit activée.
Quelques exemples de configuration :
- Un bouton Micro avec Couper le microphone en mode Basculer, dont la couleur suit la variable
discord_is_self_muted. - Un bouton qui rejoint le canal vocal de votre équipe avec Me déplacer si je suis déjà connecté activé, pour qu'il fonctionne aussi quand vous êtes dans un autre canal.
- Un flux sur le déclencheur Microphone coupé qui allume une lampe rouge, et un autre sur Microphone actif qui l'éteint.
- Un bouton qui publie « Le stream est en direct » avec un lien vers votre chaîne via un webhook.
Fonctionnement
Macro Deck se connecte à Discord au démarrage et se reconnecte tout seul quand vous fermez et rouvrez Discord, en attendant un peu plus après chaque échec, jusqu'à une minute. Les déclencheurs Connecté et Déconnecté se déclenchent à ce moment-là. Tant que Discord n'est pas connecté, les variables apparaissent comme indisponibles, sauf discord_is_connected. Les changements que vous faites dans Discord, et les mises en sourdine par un modérateur, apparaissent immédiatement dans les variables et les déclencheurs. Vous pouvez configurer un seul compte Discord.
Ce qu'il vous faut
- L'application de bureau officielle Discord, lancée sur le même ordinateur que Macro Deck. Sous Linux, les versions Flatpak et Snap fonctionnent aussi.
- Un compte Discord et votre propre application gratuite dans le Discord Developer Portal.
- Macro Deck et Discord lancés avec les mêmes privilèges (aucun des deux en tant qu'administrateur, ou les deux).
- Pour Exécuter un webhook uniquement : l'URL d'un webhook d'un canal. L'intégration doit être activée, mais aucune configuration n'est nécessaire.
Configuration
Étape 1: Créez une application Discord
Ouvrez le Discord Developer Portal et créez une nouvelle application. Le nom n'a pas d'importance. Copiez l'Application ID dans General Information : c'est l'ID client.
Étape 2: Ajoutez l'URI de redirection et copiez le secret
Dans votre application, ouvrez OAuth2. Ajoutez
http://localhost/comme redirection et enregistrez. Cette adresse n'est jamais ouverte, Discord vérifie seulement qu'elle est enregistrée. Copiez ensuite le Client Secret (réinitialisez-le si Discord ne l'affiche pas).Étape 3: Ouvrez Discord dans Macro Deck
Vérifiez que l'application de bureau Discord est lancée. Dans Macro Deck, cliquez sur Intégrations dans la barre latérale, puis sur Discord.
Étape 4: Saisissez l'ID client et le secret client
Dans l'onglet Aperçu, cliquez sur Configurer dans la section Configuration. Activer l'interrupteur en haut à droite ouvre la même boîte de dialogue. Dans la boîte de dialogue Connecter Discord, collez l'ID client et le Secret client, puis cliquez sur Continuer.
Étape 5: Autorisez dans Discord
À l'étape Autoriser dans Discord, cliquez sur Continuer. Discord affiche une demande d'autorisation pour votre application : acceptez-la. Macro Deck enregistre la connexion sous le nom Discord, avec votre nom d'utilisateur entre parenthèses, et active l'intégration.
Étape 6: Ajoutez une action à un bouton
Sur la page Deck, cliquez sur un bouton. Le deck doit être déverrouillé : c'est le cas lorsque le bouton Verrouiller s'affiche en haut à droite. L'éditeur s'ouvre avec Appui court sélectionné. Cliquez sur + Ajouter une action, sélectionnez Discord à gauche de la boîte de dialogue Ajouter une action, choisissez Couper le microphone et réglez Action sur Basculer.
Étape 7: Appuyez sur le bouton
Appuyez sur le bouton de votre deck. Discord coupe votre microphone, et le bouton affiche l'état en sourdine jusqu'à ce que vous rétablissiez le micro, depuis le deck ou dans Discord.
Actions14
Placez-les sur un bouton ou exécutez-les depuis un flux.
- Couper le microphone
- Coupe, rétablit ou bascule votre microphone.
- Couper le son entrant
- Coupe, rétablit ou bascule le son entrant.
- Suppression de bruit standard
- Active ou désactive la suppression de bruit standard de Discord. Elle ne peut pas piloter Krisp.
- Suppression d'écho
- Active ou désactive la suppression d'écho de Discord.
- Contrôle automatique du gain
- Active ou désactive le contrôle automatique du gain.
- Définir le mode vocal
- Passe à Appuyer pour parler ou à la détection vocale, ou bascule entre les deux.
- Définir le volume du microphone
- Définit, augmente ou diminue le volume du microphone dans Discord.
- Définir le volume de sortie
- Définit, augmente ou diminue le volume de sortie de Discord, jusqu'à 200 %.
- Rejoindre le canal vocal
- Vous connecte à un canal vocal sur l'un de vos serveurs, en vous déplaçant éventuellement depuis un autre canal.
- Quitter le canal vocal
- Vous déconnecte du canal vocal actuel.
- Ouvrir le canal textuel
- Ouvre un canal textuel dans l'application Discord.
- Définir le statut enrichi
- Affiche sur votre profil une activité personnalisée (joue à, écoute, regarde ou participe à) avec des détails, des images et le temps écoulé.
- Effacer le statut enrichi
- Retire de votre profil l'activité définie par Macro Deck.
- Exécuter un webhook
- Envoie un message, avec un embed facultatif, dans un canal via l'URL d'un webhook. Fonctionne sans configuration.
Déclencheurs18
Un bouton ou un flux peut réagir à ces événements.
- Connecté
- Macro Deck s'est connecté à l'application Discord.
- Déconnecté
- L'application Discord a été fermée ou la connexion a été perdue.
- Microphone coupé (manuel)
- Vous avez coupé votre propre microphone.
- Microphone rétabli
- Vous avez rétabli votre propre microphone.
- Son entrant coupé
- Vous avez coupé votre son entrant.
- Son entrant rétabli
- Vous avez rétabli votre son entrant.
- Mis en sourdine par le serveur
- Un modérateur vous a mis en sourdine.
- Sourdine retirée par le serveur
- Un modérateur a retiré votre sourdine.
- Son entrant coupé par le serveur
- Un modérateur a coupé votre son entrant.
- Son entrant rétabli par le serveur
- Un modérateur a rétabli votre son entrant.
- Microphone coupé
- Votre microphone a cessé de transmettre, quelle qu'en soit la raison : une sourdine ou une coupure du son par vous ou par un modérateur.
- Microphone actif
- Votre microphone peut de nouveau transmettre : aucune sourdine ni coupure du son n'est active.
- Canal vocal rejoint
- Vous avez rejoint un canal vocal, éventuellement un canal précis uniquement.
- Canal vocal quitté
- Vous avez quitté un canal vocal, éventuellement un canal précis uniquement.
- État de la connexion vocale modifié
- La connexion vocale de Discord a changé d'état, par exemple en
VOICE_CONNECTED, avec le ping moyen. - Quelqu'un a commencé à parler
- Quelqu'un dans votre canal vocal actuel a commencé à parler, en indiquant s'il s'agit de vous.
- Quelqu'un a arrêté de parler
- Quelqu'un dans votre canal vocal actuel a arrêté de parler, en indiquant s'il s'agit de vous.
- Notification reçue
- Discord a affiché une notification de bureau, avec son titre et son texte.
Variables11
Affichez ces valeurs sur des boutons et des widgets, ou utilisez-les dans des conditions.
discord_is_connected- Indique si Macro Deck est connecté à l'application Discord.
discord_user_name- Le nom du compte connecté.
discord_is_self_muted,discord_is_self_deafened- Indique si vous avez coupé vous-même votre micro ou votre son entrant.
discord_is_server_muted,discord_is_server_deafened- Indique si un modérateur a coupé votre micro ou votre son entrant.
discord_is_muted,discord_is_deafened- Indique si votre micro ou votre son entrant est coupé, quelle qu'en soit la raison.
discord_is_speaking- Indique si vous parlez en ce moment.
discord_is_in_voice_channel,discord_voice_channel,discord_voice_server- Indique si vous êtes dans un canal vocal, ainsi que les noms du canal et de son serveur.
discord_voice_connection_state,discord_voice_ping- L'état de la connexion vocale et son ping moyen en millisecondes.
discord_input_volume,discord_output_volume- Le volume d'entrée et de sortie de Discord en pourcentage. Vous pouvez aussi les modifier, par exemple avec un curseur.
discord_voice_mode- Indique si Discord utilise Appuyer pour parler ou la détection vocale.
discord_noise_suppression,discord_echo_cancellation,discord_automatic_gain_control- Indique si la suppression de bruit, la suppression d'écho et le contrôle automatique du gain sont activés.
Questions fréquentes
Pourquoi ai-je besoin de ma propre application Discord ?
Discord n'accorde les autorisations de pilotage du client qu'aux applications dont vous faites partie de l'équipe. Votre propre application est gratuite, et Macro Deck n'utilise son ID client et son Secret client que pour s'autoriser auprès de Discord.
Cela fonctionne-t-il avec Vesktop, Legcord ou d'autres clients Discord ?
Non. Les clients tiers peuvent partager l'activité de jeu, mais Macro Deck ne peut pas les piloter. Lancez l'application de bureau officielle Discord ; l'autre client peut continuer de tourner à côté.
Cela fonctionne-t-il quand Discord tourne sur un autre ordinateur ?
Non. Macro Deck communique avec Discord par une connexion locale : Discord doit donc tourner sur l'ordinateur qui exécute Macro Deck. Seule l'action Exécuter un webhook fonctionne sans l'application Discord.
La configuration indique que Discord a refusé la connexion. Qu'est-ce qui ne va pas ?
Macro Deck et Discord tournent avec des privilèges différents, par exemple l'un des deux a été lancé avec Exécuter en tant qu'administrateur. Lancez les deux de la même façon et réessayez.
Un réglage vocal ne change pas. Pourquoi ?
Une autre application connectée à Discord peut contrôler les réglages vocaux, ou Discord ignore les réglages vocaux avancés tant que Krisp est actif. Fermez les autres applications qui pilotent Discord, modifiez une fois le réglage dans les paramètres Voix et vidéo de Discord, puis relancez l'action.
Où mes identifiants sont-ils stockés ?
Le Secret client et les jetons renvoyés par Discord sont stockés chiffrés sur votre ordinateur et ne sont envoyés qu'à Discord. Quand Discord n'accepte plus l'autorisation enregistrée, l'intégration affiche L'autorisation Discord a expiré avec un bouton Reconnecter.
Plus dans Chat et voix
Webhooks Discord
Incluse avec Macro DeckPubliez des messages enrichis avec des embeds et des mentions dans des salons Discord via des webhooks, avec un aperçu en direct.
SinusBot
Incluse avec Macro DeckPilotez la musique de vos instances SinusBot et affichez sur votre deck ce qu'elles jouent.