SinusBot
Входит в Macro DeckУправляйте музыкой своих экземпляров SinusBot и показывайте на панели, что они играют.
Два виджета «Музыкальный проигрыватель», воспроизводящие трек, один в стиле «Полная обложка», другой в стиле «Маленькая обложка», оба с названием и логотипом SinusBot в заголовке
- Воспроизведение, пауза, переключение и перемотка на любом экземпляре SinusBot
- Громкость, перемешивание и повтор
- Воспроизведение трека из библиотеки бота
- Играющий трек в виджете «Музыкальный проигрыватель»
- Сколько угодно экземпляров бота
SinusBot представляет собой музыкального бота для TeamSpeak и Discord, которого вы запускаете на собственном сервере. Интеграция SinusBot подключает Macro Deck к веб-интерфейсу SinusBot, поэтому вы можете управлять тем, что играет экземпляр бота, и видеть текущий трек на панели. Она работает с любым SinusBot, доступным для Macro Deck по сети: на том же компьютере, в локальной сети или на сервере.
Что можно делать
- Воспроизводить, ставить на паузу, переключать воспроизведение, переходить к следующему или предыдущему треку и к позиции в текущем треке.
- Задавать громкость, повышать или понижать её, включать и выключать перемешивание и повтор.
- Воспроизводить определённый трек из библиотеки бота с помощью действия Play Track. Оставьте трек пустым, чтобы выбирать его при нажатии кнопки.
- Показывать играющий трек, исполнителя и обложку в виджете Macro Deck Музыкальный проигрыватель и использовать трек, позицию и громкость бота в подписях через переменные.
Несколько примеров:
- Ряд кнопок с действиями Previous Track, Toggle Play/Pause и Next Track для бота в вашем канале TeamSpeak. Кнопка воспроизведения показывает, играет ли бот.
- Ползунок, привязанный к переменной громкости бота
sinusbot_<instance>_volume, чтобы приглушать музыку, пока вы говорите. - Виджет Музыкальный проигрыватель для каждого бота рядом с кнопками, цвет которых следует за обложкой через переменную
music_player_<player>_album_color.
Несколько ботов и как это работает
Каждому экземпляру SinusBot, которым вы хотите управлять, соответствует одна настройка. Можно добавить сколько угодно, в том числе экземпляры на разных серверах, и выбирать экземпляр в поле Player каждого действия. Если оставить поле Player пустым, действие управляет первым экземпляром. Каждая настройка получает собственный набор переменных, названных по названию настройки, например sinusbot_<instance>_volume.
Macro Deck проверяет подключение при настройке и загружает экземпляры, которые есть у бота. Во время работы он регулярно считывает состояние воспроизведения. Если бот ненадолго недоступен, панель продолжает показывать последний трек, а если он остаётся недоступным, переменная sinusbot_<instance>_is_connected принимает значение false, и действия ничего не делают, пока бот снова не ответит.
Что понадобится
- Работающий SinusBot, веб-интерфейс которого доступен для Macro Deck, например
http://your-bot:8087. - Имя пользователя и пароль SinusBot.
- Хотя бы один экземпляр, созданный в веб-интерфейсе SinusBot.
Настройка
Шаг 1: Проверьте веб-интерфейс SinusBot
Откройте веб-интерфейс SinusBot в браузере и войдите. Запомните адрес вместе с портом, например
http://192.168.1.20:8087, и убедитесь, что есть хотя бы один экземпляр.Шаг 2: Откройте интеграцию SinusBot
В Macro Deck нажмите Интеграции на боковой панели и выберите SinusBot. На вкладке Обзор нажмите Добавить настройку в разделе Настройка. Если включить переключатель в правом верхнем углу, откроется тот же диалог, а интеграция включится после завершения настройки.
Шаг 3: Введите сервер и данные для входа
В диалоге Подключение SinusBot введите:
- URL сервера: адрес веб-интерфейса SinusBot вместе с портом.
- Имя пользователя и Пароль: аккаунт, с которым вы входите в SinusBot.
Когда вы нажмёте Продолжить, Macro Deck проверит подключение и загрузит экземпляры.
Шаг 4: Выберите экземпляр
На шаге Выбор экземпляра выберите экземпляр бота в поле Экземпляр и нажмите Продолжить. Настройка сохраняется под названием SinusBot с именем экземпляра в скобках. Повторите эти шаги для каждого другого экземпляра, которым хотите управлять.
Шаг 5: Добавьте действие на кнопку
На странице Панель нажмите на кнопку. Панель должна быть разблокирована: если в правом верхнем углу показана кнопка Заблокировать, так и есть. Откроется редактор, в котором выбран триггер Короткое нажатие. Нажмите + Добавить действие, слева в диалоге Добавить действие выберите SinusBot, затем действие Toggle Play/Pause и укажите экземпляр в поле Player.
Шаг 6: Нажмите кнопку
Нажмите кнопку на панели. Бот начнёт или приостановит воспроизведение, а кнопка покажет текущее состояние. Виджет Музыкальный проигрыватель, настроенный на этот экземпляр, показывает играющий трек.
Действия13
Назначьте их на кнопку или запускайте из цепочки действий.
- Play
- Продолжает воспроизведение.
- Pause
- Ставит воспроизведение на паузу.
- Toggle Play/Pause
- Переключает между воспроизведением и паузой и показывает текущее состояние на кнопке.
- Next Track
- Переходит к следующему треку.
- Previous Track
- Переходит к предыдущему треку.
- Refresh State
- Сразу заново считывает, что сейчас играет.
- Set Volume
- Задаёт громкость воспроизведения (от 0 до 100%).
- Volume Up
- Повышает громкость воспроизведения на 10%.
- Volume Down
- Понижает громкость воспроизведения на 10%.
- Seek
- Переходит к позиции в текущем треке, в секундах.
- Toggle Shuffle
- Переключает перемешивание или включает и выключает его.
- Set Repeat Mode
- Включает или выключает повтор. У SinusBot один режим повтора, поэтому оба варианта повтора включают его.
- Play Track
- Воспроизводит трек из библиотеки бота. Оставьте поле пустым, чтобы выбирать трек при нажатии кнопки.
Триггеры7
Кнопка или цепочка действий может реагировать на эти события.
- Трек изменён
- Начал играть другой трек (в разделе Музыкальный проигрыватель).
- Воспроизведение начато
- Воспроизведение началось или продолжилось (в разделе Музыкальный проигрыватель).
- Воспроизведение приостановлено
- Воспроизведение поставлено на паузу (в разделе Музыкальный проигрыватель).
- Воспроизведение остановлено
- Воспроизведение остановлено (в разделе Музыкальный проигрыватель).
- Громкость изменена
- Громкость бота изменилась, с новым и предыдущим значением (в разделе Музыкальный проигрыватель).
- Проигрыватель подключён
- Экземпляр бота стал доступен (в разделе Музыкальный проигрыватель).
- Проигрыватель отключён
- Экземпляр бота больше недоступен (в разделе Музыкальный проигрыватель).
Переменные8
Показывайте эти значения на кнопках и виджетах или используйте их в условиях.
sinusbot_<instance>_current_track_name,sinusbot_<instance>_current_artist,sinusbot_<instance>_current_album- Текущий трек и его исполнитель. SinusBot не сообщает альбом, поэтому
sinusbot_<instance>_current_albumостаётся пустой. sinusbot_<instance>_playback_state,sinusbot_<instance>_is_playing- Играет ли бот, стоит ли на паузе или остановлен.
sinusbot_<instance>_volume- Громкость воспроизведения в процентах. Её также можно задавать, например ползунком.
sinusbot_<instance>_track_duration,sinusbot_<instance>_current_position,sinusbot_<instance>_progress_percentage- Длина трека и позиция в секундах, а также прогресс в процентах. Позицию можно задать, чтобы перемотать.
sinusbot_<instance>_album_art_url- Адрес текущей обложки.
sinusbot_<instance>_device_name- Имя экземпляра бота.
sinusbot_<instance>_shuffle_enabled,sinusbot_<instance>_repeat_mode- Включены ли перемешивание и повтор.
sinusbot_<instance>_is_connected- Доступен ли экземпляр бота для Macro Deck.
Часто задаваемые вопросы
Можно ли управлять несколькими ботами?
Да. Добавьте по одной настройке на каждый экземпляр SinusBot, в том числе на разных серверах. У каждого действия есть поле Player для экземпляра, которым оно управляет, а у каждой настройки свои переменные.
Должен ли SinusBot работать на том же компьютере?
Нет. Macro Deck общается с веб-интерфейсом SinusBot по сети, поэтому бот может работать на сервере или другом компьютере, если Macro Deck может достучаться до его адреса.
При настройке сообщается, что экземпляры не найдены. Что делать?
У аккаунта нет экземпляра, который он может использовать. Сначала создайте экземпляр в веб-интерфейсе SinusBot, затем снова пройдите настройку.
Что происходит, когда бот уходит в офлайн?
Короткий перерыв не очищает панель: она какое-то время показывает последний трек. Если бот остаётся недоступным, переменная sinusbot_<instance>_is_connected принимает значение false, а Macro Deck продолжает попытки до него достучаться.
Где хранится мой пароль?
Пароль хранится в зашифрованном виде на вашем компьютере и используется только для входа в ваш SinusBot.
Ещё в группе «Чат и голосовое общение»
Discord
Входит в Macro DeckВыключайте микрофон и звук, входите в голосовые каналы, меняйте настройки голоса и отправляйте сообщения через вебхуки Discord прямо с панели.
Вебхуки Discord
Входит в Macro DeckПубликуйте в каналах Discord оформленные сообщения с embed-блоками и упоминаниями через вебхуки, с живым предпросмотром.