Descripción

¡Nuestro módulo de notificación de Twitch está diseñado para ofrecer a los miembros de tu comunidad una experiencia de seguimiento de streams avanzada, interactiva y automatizada en Discord!

🔄 Funcionamiento en tres etapas

1. Detección del inicio del directo

En cuanto comienza el directo, el módulo crea automáticamente una notificación en el servidor de Discord recuperando la imagen de inicio del directo configurada previamente y creando un ping al rol configurado, mostrando una vista previa dinámica y toda la información útil del stream (número de espectadores 👀 y hora de inicio ⏰).


2. Actualización automática de datos

Cada minuto ⏱️, el módulo analiza en tiempo real la evolución del directo: actualiza el mensaje de Discord con las nuevas estadísticas 📈 (número de espectadores 🎉 y una captura de pantalla del stream 📸).

¡Los miembros tienen así información actualizada si vienen más tarde a ver la notificación. Esto permite asegurarse de que el streamer sigue en directo si la notificación se lee más tarde!


3. Gestión de cortes y fin del directo

Si el directo sufre un corte 🔌, el módulo verifica durante 10 minutos ⏳ si el corte es temporal (pérdida de conexión, reinicio…).

• 🟢 Si el directo se reinicia, la notificación vuelve a verde (directo activo) ✅
• 🔴 Si no, después de este tiempo, el mensaje pasa a rojo, considerado como fin del directo, y se muestran todas las estadísticas finales: hora de inicio, hora de fin, duración del stream, pico de espectadores y número de nuevos seguidores (Se mostrará la imagen de fin de directo configurada previamente) 📋

• 🟠 Durante el corte, el estado se indica en naranja en el mensaje para advertir de cualquier anomalía ⚠️

✨ Ventajas del sistema

• 👁️ Visibilidad en tiempo real de la actividad del streamer directamente en Discord
• 🎨 Mayor participación de la comunidad gracias a notificaciones dinámicas e ilustradas
• 📚 Historial automático: todo el desarrollo de un directo (estadísticas, evolución) se archiva en un solo mensaje de Discord, en cada stream 🗂️
• 🔄 Actualización de una sala de voz para mostrar el número de seguidores del canal Twitch al iniciar la transmisión en directo y al cerrarla

¡Con este módulo, cada directo de Twitch se convierte en un evento interactivo 🎊 perfectamente integrado en tu servidor de Discord, sin gestión manual 🤖, para un ambiente más animado y un informe completo en cada transmisión! 🎉🔥

❗ Importante

• El módulo no es funcional descargando únicamente los archivos, debe integrarse en un bot de Discord ya funcional
• Utilizamos Prisma como ORM para la gestión de la base de datos, asegúrate de que tu proyecto también utiliza Prisma o adapta el código en consecuencia

⚠️ Requisitos

• Un bot de Discord funcional con los permisos necesarios para registrar comandos slash
• Debes tener conocimientos en desarrollo de bots de Discord (Javascript) y en gestión de bases de datos para utilizar este script y poder adaptarlo a tus necesidades

Archivos/carpetas

• Directorioimages

  • Directorioscreen-live/ Contiene las imágenes temporales del stream

    • …
  • offline.png
  • online.png
• Directorioprisma

  • schema.prisma Modelo de datos para el módulo (Prisma)
• Directorioutils

  • Directorionotification

    • twitch.js Las funciones utilizadas para gestionar las notificaciones del módulo
  • environment.js Función utilitaria para escribir una variable en el archivo .env
  • utils.js Funciones reutilizables
• .env Variables de entorno necesarias
• index.js Punto de entrada del script
• package.json Dependencias necesarias

Dependencias y Versiones

Aquí están las versiones utilizadas para el desarrollo y prueba del script:

• @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