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 оформлені повідомлення з вбудовуваннями та згадками через вебхуки, з живим попереднім переглядом.