Discord
Входит в Macro DeckВыключайте микрофон и звук, входите в голосовые каналы, меняйте настройки голоса и отправляйте сообщения через вебхуки Discord прямо с панели.
Диалог «Подключение Discord» с полями Client ID и Client Secret
- Кнопки выключения микрофона и звука, которые показывают реальное состояние
- Вход в голосовые каналы, выход из них и открытие текстовых каналов
- Громкость микрофона и вывода, режим голоса и обработка голоса
- Собственная активность Rich Presence в вашем профиле
- Сообщения и embed-блоки в канал через вебхук
Интеграция Discord подключает Macro Deck к официальному приложению Discord для компьютера на том же компьютере. Она использует локальный интерфейс RPC Discord, тот самый, который Discord предлагает программам для управления клиентом, поэтому ваши кнопки действуют так, будто вы сами нажимаете в Discord. Discord даёт такой доступ только приложениям, которые принадлежат вам, поэтому при настройке нужно создать бесплатное приложение в Discord Developer Portal и один раз его авторизовать.
Что можно делать
- Выключать микрофон или звук с помощью действий Выключение микрофона и Отключить звук в наушниках. Кнопка показывает, выключен ли микрофон, даже если вы выключили его в самом Discord.
- Входить в голосовой канал на одном из своих серверов, выходить из текущего или открывать текстовый канал в приложении Discord.
- Задавать, повышать или понижать громкость микрофона и вывода, переключаться между режимами По нажатию и По голосу и включать или выключать стандартное подавление шума, подавление эха и автоматическую регулировку усиления.
- Показывать собственную активность в профиле с помощью действия Задать Rich Presence и убирать её с помощью Очистить Rich Presence.
- Отправлять сообщение, при желании с embed-блоком, в любой канал через вебхук с помощью действия Отправить вебхук. Это действие работает без настройки интеграции, если она включена.
Несколько примеров:
- Кнопка Микрофон с действием Выключение микрофона в режиме Переключить, цвет которой следует за переменной
discord_is_self_muted. - Кнопка, которая подключает к голосовому каналу команды с включённым параметром Переместить меня, если я уже подключён, поэтому она работает, даже когда вы в другом канале.
- Цепочка действий по триггеру Микрофон заглушён, которая включает красную лампу, и ещё одна по триггеру Микрофон снова активен, которая её выключает.
- Кнопка, которая через вебхук отправляет «Мы в эфире» со ссылкой на ваш канал.
Как это работает
Macro Deck подключается к Discord при запуске и сам переподключается, когда вы закрываете и снова открываете Discord, после каждой неудачной попытки ожидая немного дольше, но не более минуты. При этом срабатывают триггеры Подключено и Отключено. Пока Discord не подключён, переменные считаются недоступными, кроме discord_is_connected. Изменения, сделанные в Discord, а также выключение микрофона модератором сразу отражаются в переменных и триггерах. Настроить можно один аккаунт Discord.
Что понадобится
- Официальное приложение Discord для компьютера, запущенное на том же компьютере, что и Macro Deck. В Linux также работают версии Flatpak и Snap.
- Аккаунт Discord и собственное бесплатное приложение в Discord Developer Portal.
- Macro Deck и Discord, запущенные с одинаковыми правами (оба не от имени администратора или оба от его имени).
- Только для действия Отправить вебхук: URL вебхука из канала. Интеграция должна быть включена, но настраивать её не нужно.
Настройка
Шаг 1: Создайте приложение Discord
Откройте Discord Developer Portal и создайте новое приложение. Название не важно. Скопируйте Application ID в разделе General Information: это и есть Client ID.
Шаг 2: Добавьте Redirect URI и скопируйте секрет
В вашем приложении откройте OAuth2. Добавьте
http://localhost/в качестве redirect и сохраните. Этот адрес никогда не открывается, Discord только проверяет, что он зарегистрирован. Затем скопируйте Client Secret (сбросьте его, если Discord его не показывает).Шаг 3: Откройте Discord в Macro Deck
Убедитесь, что приложение Discord для компьютера запущено. В Macro Deck нажмите Интеграции на боковой панели и выберите Discord.
Шаг 4: Введите Client ID и Client Secret
На вкладке Обзор нажмите Настроить в разделе Настройка. Если включить переключатель в правом верхнем углу, откроется тот же диалог. В диалоге Подключение Discord вставьте Client ID и Client Secret и нажмите Продолжить.
Шаг 5: Авторизуйтесь в Discord
На шаге Авторизация в Discord нажмите Продолжить. Discord покажет запрос авторизации для вашего приложения: примите его. Macro Deck сохранит подключение под названием Discord с вашим именем пользователя в скобках и включит интеграцию.
Шаг 6: Добавьте действие на кнопку
На странице Панель нажмите на кнопку. Панель должна быть разблокирована: если в правом верхнем углу показана кнопка Заблокировать, так и есть. Откроется редактор, в котором выбран триггер Короткое нажатие. Нажмите + Добавить действие, слева в диалоге Добавить действие выберите Discord, затем действие Выключение микрофона и в поле Действие выберите Переключить.
Шаг 7: Нажмите кнопку
Нажмите кнопку на панели. Discord выключит микрофон, а кнопка будет показывать это состояние, пока вы не включите его снова с панели или в Discord.
Действия14
Назначьте их на кнопку или запускайте из цепочки действий.
- Выключение микрофона
- Выключает, включает или переключает микрофон.
- Отключить звук в наушниках
- Отключает, включает или переключает звук в наушниках.
- Стандартное подавление шума
- Включает или выключает стандартное подавление шума Discord. Krisp этим действием не управляется.
- Подавление эха
- Включает или выключает подавление эха Discord.
- Автоматическая регулировка усиления
- Включает или выключает автоматическую регулировку усиления.
- Задать режим голоса
- Переключает между режимами «по нажатию» и «по голосу» или чередует их.
- Задать громкость микрофона
- Задаёт, повышает или понижает громкость микрофона в Discord.
- Задать громкость вывода
- Задаёт, повышает или понижает громкость вывода в Discord, до 200%.
- Войти в голосовой канал
- Подключает вас к голосовому каналу на одном из ваших серверов, при желании перемещая из другого канала.
- Покинуть голосовой канал
- Отключает вас от текущего голосового канала.
- Открыть текстовый канал
- Открывает текстовый канал в приложении Discord.
- Задать Rich Presence
- Показывает в профиле собственную активность (играет, слушает, смотрит или соревнуется) с подробностями, изображениями и прошедшим временем.
- Очистить Rich Presence
- Убирает из профиля активность, заданную Macro Deck.
- Отправить вебхук
- Отправляет сообщение, при желании с embed-блоком, в канал через URL вебхука. Работает без настройки.
Триггеры18
Кнопка или цепочка действий может реагировать на эти события.
- Подключено
- Macro Deck подключился к приложению Discord.
- Отключено
- Приложение Discord закрыто или подключение оборвалось.
- Микрофон выключен
- Вы выключили свой микрофон.
- Микрофон включён
- Вы включили свой микрофон.
- Звук в наушниках отключён
- Вы отключили себе звук.
- Звук в наушниках включён
- Вы включили себе звук.
- Микрофон выключен модератором
- Модератор выключил ваш микрофон.
- Микрофон включён модератором
- Модератор включил ваш микрофон.
- Звук отключён модератором
- Модератор отключил вам звук.
- Звук включён модератором
- Модератор включил вам звук.
- Микрофон заглушён
- Микрофон перестал передавать звук по любой причине: из-за выключения микрофона или звука вами или модератором.
- Микрофон снова активен
- Микрофон снова может передавать звук: ни микрофон, ни звук не выключены.
- Подключение к голосовому каналу
- Вы вошли в голосовой канал, при желании только в определённый.
- Выход из голосового канала
- Вы вышли из голосового канала, при желании только из определённого.
- Изменилось состояние голосового подключения
- Голосовое подключение Discord сменило состояние, например на
VOICE_CONNECTED, со средней задержкой. - Кто-то начал говорить
- Кто-то в вашем текущем голосовом канале начал говорить, с указанием, вы ли это.
- Кто-то перестал говорить
- Кто-то в вашем текущем голосовом канале перестал говорить, с указанием, вы ли это.
- Получено уведомление
- Discord показал уведомление на рабочем столе, с его заголовком и текстом.
Переменные11
Показывайте эти значения на кнопках и виджетах или используйте их в условиях.
discord_is_connected- Подключён ли Macro Deck к приложению Discord.
discord_user_name- Имя подключённого аккаунта.
discord_is_self_muted,discord_is_self_deafened- Выключили ли вы себе микрофон или звук.
discord_is_server_muted,discord_is_server_deafened- Выключил ли вам модератор микрофон или звук.
discord_is_muted,discord_is_deafened- Выключен ли у вас микрофон или звук по любой причине.
discord_is_speaking- Говорите ли вы прямо сейчас.
discord_is_in_voice_channel,discord_voice_channel,discord_voice_server- Находитесь ли вы в голосовом канале, а также названия канала и его сервера.
discord_voice_connection_state,discord_voice_ping- Состояние голосового подключения и его средняя задержка в миллисекундах.
discord_input_volume,discord_output_volume- Громкость ввода и вывода Discord в процентах. Их также можно задавать, например ползунком.
discord_voice_mode- Использует ли Discord режим «по нажатию» или «по голосу».
discord_noise_suppression,discord_echo_cancellation,discord_automatic_gain_control- Включены ли подавление шума, подавление эха и автоматическая регулировка усиления.
Часто задаваемые вопросы
Зачем нужно собственное приложение Discord?
Discord выдаёт разрешения на управление клиентом только приложениям, в команде которых вы состоите. Собственное приложение бесплатно, а Macro Deck использует его Client ID и Client Secret только для авторизации в Discord.
Работает ли это с Vesktop, Legcord или другими клиентами Discord?
Нет. Сторонние клиенты могут передавать игровую активность, но Macro Deck не может ими управлять. Запустите официальное приложение Discord для компьютера: другой клиент может продолжать работать параллельно.
Работает ли это, если Discord запущен на другом компьютере?
Нет. Macro Deck общается с Discord через локальное подключение, поэтому Discord должен работать на том же компьютере, что и Macro Deck. Без приложения Discord работает только действие Отправить вебхук.
При настройке сообщается, что Discord отклонил подключение. В чём дело?
Macro Deck и Discord работают с разными правами, например одна из программ была запущена командой Запуск от имени администратора. Запустите обе одинаково и попробуйте снова.
Параметр голоса не меняется. Почему?
Возможно, параметрами голоса управляет другая программа, подключённая к Discord, или Discord игнорирует расширенные параметры голоса, пока активен Krisp. Закройте другие программы, которые управляют Discord, один раз измените параметр в настройках Discord Голос и видео и снова запустите действие.
Где хранятся мои данные для входа?
Client Secret и токены, которые возвращает Discord, хранятся в зашифрованном виде на вашем компьютере и отправляются только в Discord. Когда Discord перестаёт принимать сохранённую авторизацию, интеграция показывает Срок разрешения Discord истёк с кнопкой Подключить снова.
Ещё в группе «Чат и голосовое общение»
Вебхуки Discord
Входит в Macro DeckПубликуйте в каналах Discord оформленные сообщения с embed-блоками и упоминаниями через вебхуки, с живым предпросмотром.
SinusBot
Входит в Macro DeckУправляйте музыкой своих экземпляров SinusBot и показывайте на панели, что они играют.