Discord
Incluída no Macro DeckSilencie, ensurdeça, entre em canais de voz, ajuste as configurações de voz e publique mensagens por webhook no Discord pelo seu deck.
A caixa de diálogo Conectar o Discord com os campos Client ID e Client Secret
- Botões de silenciar e ensurdecer que mostram o seu estado real
- Entre ou saia de canais de voz e abra canais de texto
- Ajuste o volume do microfone e de saída, o modo de voz e o processamento de voz
- Mostre uma atividade Rich Presence personalizada no seu perfil
- Publique mensagens e embeds em um canal por webhook
A integração Discord conecta o Macro Deck ao app oficial de desktop do Discord no mesmo computador. Ela usa a interface RPC local do Discord, a mesma que o Discord oferece a apps que controlam o cliente, então os botões agem como se o clique fosse feito no próprio Discord. O Discord só dá esse acesso a aplicações que pertencem a você, por isso a configuração pede para criar uma aplicação gratuita no Discord Developer Portal e autorizá-la uma vez.
O que dá para fazer
- Silencie ou ensurdeça a si mesmo com Silenciar microfone e Ensurdecer. O botão mostra se o microfone está silenciado, também quando isso é feito no próprio Discord.
- Entre em um canal de voz de um dos seus servidores, saia do canal atual ou abra um canal de texto no app do Discord.
- Defina, aumente ou diminua o volume do microfone e de saída, alterne entre Pressionar para falar e Atividade de voz e ative ou desative a supressão de ruído padrão, o cancelamento de eco e o controle automático de ganho.
- Mostre uma atividade personalizada no seu perfil com Definir Rich Presence e remova-a com Limpar Rich Presence.
- Publique uma mensagem, com um embed opcional, em qualquer canal por webhook com Executar webhook. Esta ação funciona sem configurar a integração, desde que ela esteja ativada.
Alguns exemplos de uso:
- Um botão Microfone com Silenciar microfone no modo Alternar, cuja cor acompanha a variável
discord_is_self_muted. - Um botão que entra no canal de voz da sua equipe com Mover se já estiver conectado ativado, para que funcione mesmo quando você estiver em outro canal.
- Um fluxo no gatilho Microfone sem transmissão que acende uma luz vermelha, e outro em Microfone ativo que a apaga de novo.
- Um botão que publica "A live começou" com um link para o seu canal por webhook.
Como funciona
O Macro Deck se conecta ao Discord ao iniciar e se reconecta sozinho quando o Discord é fechado e aberto de novo, esperando um pouco mais após cada tentativa malsucedida, até um minuto. Os gatilhos Conectado e Desconectado disparam quando isso acontece. Enquanto o Discord não estiver conectado, as variáveis ficam indisponíveis, exceto discord_is_connected. Mudanças feitas no Discord, e silenciamentos por um moderador, aparecem nas variáveis e nos gatilhos na hora. É possível configurar uma conta do Discord.
O que é necessário
- O app oficial de desktop do Discord, rodando no mesmo computador que o Macro Deck. No Linux, as versões Flatpak e Snap também funcionam.
- Uma conta do Discord e uma aplicação gratuita sua no Discord Developer Portal.
- Macro Deck e Discord iniciados com os mesmos privilégios (nenhum deles como administrador, ou os dois).
- Só para Executar webhook: uma URL de webhook de um canal. A integração precisa estar ativada, mas não é preciso configurá-la.
Configuração
Passo 1: Crie uma aplicação no Discord
Abra o Discord Developer Portal e crie uma nova aplicação. O nome não importa. Copie o Application ID em General Information: esse é o Client ID.
Passo 2: Adicione o URI de redirecionamento e copie o segredo
Na sua aplicação, abra OAuth2. Adicione
http://localhost/como redirecionamento e salve. Nada nunca abre esse endereço, o Discord só confere se ele está registrado. Depois copie o Client Secret (redefina-o se o Discord não o mostrar).Passo 3: Abra o Discord no Macro Deck
Verifique se o app de desktop do Discord está aberto. No Macro Deck, clique em Integrações na barra lateral e depois em Discord.
Passo 4: Informe o Client ID e o Client Secret
Na aba Visão geral, clique em Configurar na seção Configuração. Ativar a chave no canto superior direito abre a mesma caixa de diálogo. Na caixa de diálogo Conectar o Discord, cole o Client ID e o Client Secret e clique em Continuar.
Passo 5: Autorize no Discord
Na etapa Autorizar no Discord, clique em Continuar. O Discord mostra uma solicitação de autorização para a sua aplicação: aceite. O Macro Deck salva a conexão como Discord com o seu nome de usuário entre parênteses e ativa a integração.
Passo 6: Adicione uma ação a um botão
Na página Deck, clique em um botão. O deck precisa estar desbloqueado: se o botão Bloquear aparece no canto superior direito, ele está. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, selecione Discord à esquerda da caixa de diálogo Adicionar ação, escolha Silenciar microfone e defina Ação como Alternar.
Passo 7: Pressione o botão
Pressione o botão no seu deck. O Discord silencia o microfone, e o botão mostra o estado silenciado até que o microfone seja reativado, pelo deck ou no Discord.
Ações14
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Silenciar microfone
- Silencia, reativa ou alterna o microfone.
- Ensurdecer
- Ensurdece, desensurdece ou alterna o ensurdecimento.
- Supressão de ruído padrão
- Ativa ou desativa a supressão de ruído padrão do Discord. Não controla o Krisp.
- Cancelamento de eco
- Ativa ou desativa o cancelamento de eco do Discord.
- Controle automático de ganho
- Ativa ou desativa o controle automático de ganho.
- Definir modo de voz
- Muda entre pressionar para falar e atividade de voz, ou alterna entre os dois.
- Definir volume do microfone
- Define, aumenta ou diminui o volume do microfone do Discord.
- Definir volume de saída
- Define, aumenta ou diminui o volume de saída do Discord, até 200%.
- Entrar em canal de voz
- Conecta você a um canal de voz de um dos seus servidores, com a opção de mover você de outro canal.
- Sair do canal de voz
- Desconecta você do canal de voz atual.
- Abrir canal de texto
- Abre um canal de texto no app do Discord.
- Definir Rich Presence
- Mostra no seu perfil uma atividade personalizada (jogando, ouvindo, assistindo ou competindo) com detalhes, imagens e tempo decorrido.
- Limpar Rich Presence
- Remove a atividade que o Macro Deck definiu no seu perfil.
- Executar webhook
- Envia uma mensagem, com um embed opcional, para um canal por uma URL de webhook. Funciona sem configuração.
Gatilhos18
Um botão ou fluxo pode reagir a estes eventos.
- Conectado
- O Macro Deck se conectou ao app do Discord.
- Desconectado
- O app do Discord foi fechado ou a conexão caiu.
- Microfone silenciado
- Você silenciou o próprio microfone.
- Microfone reativado
- Você reativou o próprio microfone.
- Ensurdecido
- Você se ensurdeceu.
- Desensurdecido
- Você se desensurdeceu.
- Silenciado pelo servidor
- Um moderador silenciou você.
- Microfone reativado pelo servidor
- Um moderador reativou o seu microfone.
- Ensurdecido pelo servidor
- Um moderador ensurdeceu você.
- Desensurdecido pelo servidor
- Um moderador desensurdeceu você.
- Microfone sem transmissão
- O microfone parou de transmitir por qualquer motivo: silenciamento ou ensurdecimento feito por você ou por um moderador.
- Microfone ativo
- O microfone pode transmitir de novo: não há silenciamento nem ensurdecimento em vigor.
- Entrou em canal de voz
- Você entrou em um canal de voz, opcionalmente só em um específico.
- Saiu de canal de voz
- Você saiu de um canal de voz, opcionalmente só de um específico.
- Estado da conexão de voz alterado
- A conexão de voz do Discord mudou de estado, por exemplo para
VOICE_CONNECTED, com o ping médio. - Alguém começou a falar
- Alguém no seu canal de voz atual começou a falar, informando se é você.
- Alguém parou de falar
- Alguém no seu canal de voz atual parou de falar, informando se é você.
- Notificação recebida
- O Discord mostrou uma notificação na área de trabalho, com título e texto.
Variáveis11
Mostre estes valores em botões e widgets ou use-os em condições.
discord_is_connected- Se o Macro Deck está conectado ao app do Discord.
discord_user_name- O nome da conta conectada.
discord_is_self_muted,discord_is_self_deafened- Se você se silenciou ou se ensurdeceu.
discord_is_server_muted,discord_is_server_deafened- Se um moderador silenciou ou ensurdeceu você.
discord_is_muted,discord_is_deafened- Se você está silenciado ou ensurdecido por qualquer motivo.
discord_is_speaking- Se você está falando agora.
discord_is_in_voice_channel,discord_voice_channel,discord_voice_server- Se você está em um canal de voz, e os nomes do canal e do servidor dele.
discord_voice_connection_state,discord_voice_ping- O estado da conexão de voz e o ping médio dela em milissegundos.
discord_input_volume,discord_output_volume- O volume de entrada e de saída do Discord em porcentagem. Também é possível defini-los, por exemplo com um controle deslizante.
discord_voice_mode- Se o Discord usa pressionar para falar ou atividade de voz.
discord_noise_suppression,discord_echo_cancellation,discord_automatic_gain_control- Se a supressão de ruído, o cancelamento de eco e o controle automático de ganho estão ativados.
Perguntas frequentes
Por que preciso de uma aplicação própria no Discord?
O Discord só concede as permissões para controlar o cliente a aplicações de cuja equipe você faz parte. A sua aplicação é gratuita, e o Macro Deck usa o Client ID e o Client Secret dela só para se autorizar no Discord.
Funciona com Vesktop, Legcord ou outros clientes do Discord?
Não. Clientes de terceiros podem compartilhar a atividade de jogo, mas o Macro Deck não consegue controlá-los. Abra o app oficial de desktop do Discord; o outro cliente pode continuar rodando ao lado dele.
Funciona quando o Discord roda em outro computador?
Não. O Macro Deck se comunica com o Discord por uma conexão local, então o Discord precisa rodar no computador em que o Macro Deck está. Só Executar webhook funciona sem o app do Discord.
A configuração diz que o Discord recusou a conexão. O que está errado?
O Macro Deck e o Discord estão rodando com privilégios diferentes, por exemplo um deles foi iniciado com Executar como administrador. Inicie os dois do mesmo jeito e tente de novo.
Uma configuração de voz não muda. Por quê?
Outro app conectado ao Discord pode estar controlando as configurações de voz, ou o Discord ignora as configurações avançadas de voz enquanto o Krisp está ativo. Feche outros apps que controlam o Discord, mude a configuração uma vez nas configurações de Voz e vídeo do Discord e execute a ação de novo.
Onde minhas credenciais ficam armazenadas?
O Client Secret e os tokens que o Discord devolve ficam armazenados criptografados no seu computador e só são enviados ao Discord. Quando o Discord não aceita mais a autorização armazenada, a integração mostra A autorização do Discord expirou com um botão Reconectar.
Mais em Chat e voz
Webhooks do Discord
Incluída no Macro DeckPublique mensagens ricas com embeds e menções em canais do Discord por webhooks, com uma prévia ao vivo.
SinusBot
Incluída no Macro DeckControle a música das suas instâncias do SinusBot e mostre no deck o que elas estão tocando.