Описание

Наш модуль уведомлений Twitch разработан для того, чтобы предоставить участникам вашего сообщества продвинутый, интерактивный и автоматизированный опыт отслеживания стримов в Discord!

🔄 Работа в три этапа

1. Определение начала стрима

Как только начинается стрим, модуль автоматически создает уведомление на сервере Discord, получая предварительно настроенное изображение начала стрима и создавая пинг для настроенной роли, отображая динамический предпросмотр и всю полезную информацию о стриме (количество зрителей 👀 и время начала ⏰).


2. Автоматическое обновление данных

Каждую минуту ⏱️ модуль анализирует развитие стрима в реальном времени: обновляет сообщение в Discord с новой статистикой 📈 (количество зрителей 🎉 и скриншот стрима 📸).

Таким образом, участники получают свежую информацию, если просматривают уведомление позже. Это позволяет убедиться, что стример все еще в эфире, если уведомление читается позже!


3. Управление прерываниями и окончанием стрима

Если стрим прерывается 🔌, модуль проверяет в течение 10 минут ⏳, является ли прерывание временным (потеря соединения, перезапуск…).

• 🟢 Если стрим перезапускается, уведомление снова становится зеленым (активный стрим) ✅
• 🔴 В противном случае, по истечении этого времени, сообщение становится красным, считается окончанием стрима, и отображается вся итоговая статистика: время начала, время окончания, продолжительность стрима, пиковое количество зрителей и количество новых подписчиков (Отображается предварительно настроенное изображение окончания стрима) 📋

• 🟠 Во время прерывания статус отображается оранжевым цветом в сообщении для предупреждения о возможных аномалиях ⚠️

✨ Преимущества системы

• 👁️ Видимость активности стримера в реальном времени прямо в Discord
• 🎨 Усиленное взаимодействие сообщества благодаря динамическим и иллюстрированным уведомлениям
• 📚 Автоматическая история: весь ход стрима (статистика, развитие) архивируется в одном сообщении Discord для каждого стрима 🗂️
• 🔄 Обновление голосового чата для отображения количества подписчиков канала Twitch при запуске и закрытии прямой трансляции

С этим модулем каждый стрим Twitch становится интерактивным событием 🎊, идеально интегрированным в ваш Discord-сервер, без ручного управления 🤖, для более живой атмосферы и полной отчетности по каждой трансляции! 🎉🔥

❗ Важно

• Модуль не будет работать при простом скачивании файлов; он должен быть интегрирован в уже работающего Discord-бота
• Мы используем Prisma в качестве ORM для управления базой данных; убедитесь, что ваш проект также использует Prisma или адаптируйте код соответственно

⚠️ Требования

• Рабочий Discord-бот с необходимыми разрешениями для регистрации slash-команд
• Вам необходимы знания в разработке Discord-ботов (Javascript) и управлении базами данных для использования этого скрипта и его адаптации под ваши нужды

Файлы/папки

• Каталогimages

  • Каталогscreen-live/ Содержит временные изображения стрима

    • …
  • offline.png
  • online.png
• Каталогprisma

  • schema.prisma Модель данных для модуля (Prisma)
• Каталогutils

  • Каталогnotification

    • twitch.js Функции для управления уведомлениями модуля
  • environment.js Утилитарная функция для записи переменной в файл .env
  • utils.js Повторно используемые функции
• .env Необходимые переменные окружения
• index.js Точка входа скрипта
• package.json Необходимые зависимости

Зависимости и версии

Вот версии, использованные при разработке и тестировании скрипта:

• @prisma/client@6.18.0
• discord.js@14.24.0
• dotenv@16.6.1
• moment@2.30.1
• fs@0.0.2
• axios@0.26.1
• uuid-js@0.7.5
• utf8@3.0.0