Inicio>Relacionado con la programación>Código Fuente de IA
Descargar

Discord-bot-fhdw-bg-weather-thethingsstack-thethingsnetwork

Este bot de discordia proporciona datos meteorológicos de la WeatherStation FHDW. El BOT puede suscribir y cancelar la suscripción de canales para recibir actualizaciones meteorológicas, enumerar los canales suscritos actualmente y cancelar la suscripción de todos los canales a la vez.

Objetivo del repositorio

El objetivo de este repositorio es proporcionar un ejemplo completo de cómo integrar los datos de un dispositivo final en la pila de cosas en un bot de discordia utilizando el protocolo MQTT. Al hacerlo, une la brecha entre los dispositivos IoT utilizando la tecnología Lorawan y la popular plataforma de comunicación, Discord. Esto permite a los usuarios y comunidades recibir actualizaciones en tiempo real de sus dispositivos IoT, como datos meteorológicos, directamente en sus canales de discordia.

A través de esta demostración, el repositorio busca capacitar a los desarrolladores y entusiastas para explorar el potencial de integrar los datos de IoT con Discord. El proyecto sirve como base para crear aplicaciones más sofisticadas que aprovechan los datos de Lorawan de manera innovadora. En última instancia, este repositorio tiene como objetivo inspirar a la comunidad a encontrar formas nuevas y creativas de utilizar datos de IoT y mejorar las capacidades de sus bots de discordia.

Integración utilizando MQTT

La integración de los datos de las cosas en un bot de discordia se logró utilizando el protocolo MQTT, un protocolo de mensajería liviano y eficiente diseñado para dispositivos IoT. MQTT permite una transferencia de datos segura y confiable entre el dispositivo final y el bot de discordia. Al suscribirse a los temas apropiados en la pila de cosas, el bot de discordia puede recibir los datos transmitidos por los dispositivos IoT.

El código necesario se implementa en mqttHandler.js . La integración se logró siguiendo estos pasos:

  1. Importe la función createMqttClient desde el archivo mqttHandler.js en el index.js .
  2. Configure la configuración de MQTT proporcionando las credenciales requeridas, como la dirección MQTT, el usuario de la aplicación, el ID de dispositivo y la contraseña en el archivo config.json .
  3. Cree un cliente MQTT llamando a la función createMqttClient() en el archivo index.js y proporcionando las credenciales necesarias y una función de devolución de llamada para manejar los mensajes recibidos.
    • La función createMqttClient() establece el cliente MQTT conectándose a la pila de cosas y suscribiéndose al tema especificado.
    • Establece los oyentes de eventos para varios eventos MQTT como 'Connect', 'Suscripción', 'Error' y 'Mensaje'.
    • El evento 'Connect' se activa cuando el cliente MQTT está conectado a la pila de cosas.
    • El evento 'suscripción' se activa cuando el cliente MQTT se suscribe con éxito al tema especificado.
    • El evento 'Error' se activa cuando ocurre un error en el cliente MQTT.
    • El evento 'Mensaje' se activa cuando se recibe un mensaje del tema especificado, que luego llama a la función de devolución de llamada proporcionada.
  4. En la función de devolución de llamada definida en el archivo index.js :
    • Decodifique la carga útil y analice los datos relevantes del mensaje recibido.
    • Cree una incrustación de discordia utilizando los datos analizados llamando a la función createWeatherEmbed() .
    • Envíe la inserción de discordia a los canales especificados iterando a través de las ID de canal almacenadas en el módulo dataStorage .
    • Si se produce un error al enviar la incrustación a un canal, elimine la ID del canal del módulo dataStorage .

Al comprender el proceso, los desarrolladores pueden construir sobre este conocimiento para futuros proyectos que involucran dispositivos IoT. La integración sirve como una plantilla para diversas aplicaciones, como conectar dispositivos IoT a diferentes plataformas, transformar y procesar los datos, y crear alertas o notificaciones personalizadas. Este ejemplo muestra cómo MQTT puede usarse como una herramienta poderosa para cerrar la brecha entre los dispositivos IoT y otras aplicaciones, fomentando soluciones más innovadoras e integradas para Internet de las cosas.

Requisitos previos

  • Node.js v14 o superior
  • NPM (generalmente incluido con node.js)
  • Una cuenta activa de Discord con acceso administrativo a un servidor
  • Un bot y el token de bot correspondiente del portal de desarrollador de discordias
  • La ID de aplicación de red/pila de cosas y la tecla API

Creación y configuración de un bot de discordia

  1. Vaya al portal del desarrollador de Discord e inicie sesión con su cuenta de Discord.

  2. Haga clic en el botón "Nueva aplicación", le dé un nombre a su aplicación y luego haga clic en "Crear".

  3. En la configuración de la aplicación, haga clic en la pestaña "Bot", luego haga clic en el botón "Agregar bot" para crear un bot para su aplicación. Confirme haciendo clic en "¡Sí, hazlo!".

  4. En la pestaña "Bot", asegúrese de que la "intención de contenido del mensaje" esté configurada en true .

  5. En la sección "Token", haga clic en "Copiar" para copiar su token Bot. Mantenga esta token segura, ya que se usará para autenticar su bot con Discord.

  6. (Opcional) Personalice el nombre de su bot, la foto de perfil y otras configuraciones que se desee. Abierto

Instalación

  1. Clon el repositorio: 
git clone https://github.com/yourusername/FHDW-Weatherstation-Discord-Bot.git
  1. Instale las dependencias requeridas: 
... T heThingsNetwork-DiscordBot-FHDW-WeatherData B ot > npm install
 You might have to navigate to the Bot directory before running `npm install`.
To navigate use `cd folder_name`
  1. Cree un archivo config.json en el directorio BOT y agregue su token BOT Discord, ID de cliente, ID del gremio y otros detalles requeridos (el ID del gremio es opcional, solo necesario para comandos específicos del servidor): 
{
  "token" : " your_discord_bot_token " ,
  "clientId" : " your_discord_bot_client_id " ,
  "guildId" : " your_discord_server_guild_id " ,
  
  "ttnAppUser" : " your_ttn_app_user " ,
  "ttnAppPw" : " your_ttn_app_pw " ,
  "ttnAdress" : " your_ttn_address " ,
  "ttnAppDevice" : " your_ttn_app_device "
}

Ejemplo: 

{
  "token" : " AAA0000aaa000AAAA000AA.AAA00AAA.aaa-AaaaaAA0000AAAAAAAAAAaaaAAAA00AAAAAA " ,
  "clientId" : " 1234567891234567891 " ,
  "guildId" : " 1234567891234567891 " ,
  
  "ttnAppUser" : " hello-world-weather " ,
  "ttnAppPw" : " NXYXX.0A0AAAAAAAA0AAAAAAA4AAA00AAAMAAAAAAAAA.AA0AAAAA0AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA " ,
  "ttnAdress" : " mqtts://eu1.cloud.thethings.network:8883 " ,
  "ttnAppDevice" : " eui-00a0000aa000a000 "
}

Uso

  1. Invite el bot a su servidor Discord utilizando la URL apropiada (reemplace su_discord_bot_client_id con la ID de cliente real):

https://discord.com/api/oauth2/authorize?client_id=your_discord_bot_client_id&permissions=8&scope=bot

Ejemplo fhdw weather-bot: https://discord.com/api/oauth2/authorize?client_id=10885556444333867069&permissions=8&scope=bot

  1. Implementar comandos de corte en su servidor Discord: 
... T heThingsNetwork-DiscordBot-FHDW-WeatherData B ot > node deploy-commands.js
 (You might have to restart your Discord-Client afterwards)
  1. Ejecute el bot:

3.1. Para comenzar el bot, ejecute: 

... T heThingsNetwork-DiscordBot-FHDW-WeatherData B ot > npm start

3.2. Para ejecutar el bot en el modo de desarrollo con Nodemon, ejecute: 

... T heThingsNetwork-DiscordBot-FHDW-WeatherData B ot > npm run dev

Comandos

  • /subscribe [channel] : suscribir un canal a la FHDW-WeatherStation. Si no se proporciona ningún canal, se suscribirá el canal actual.
  • /unsubscribe [channel] : cancele un canal de la fhdw-weatherstation. Si no se proporciona ningún canal, el canal actual se dejará de baja.
  • /list : enumere todos los canales actualmente suscritos a la FHDW-WeatherStation.
  • /unsubscribe_all : cancele todos los canales de FHDW-WeatherStation.

Implementación en una plataforma de alojamiento

Para implementar el bot en una plataforma de alojamiento, siga las instrucciones específicas de la plataforma para aplicaciones Node.js. Asegúrese de incluir el archivo config.json con sus credenciales en el paquete de implementación.

Asegúrese de que el archivo config.json esté incluido en su implementación y que su token BOT y otra información confidencial se mantengan seguros. Si la plataforma de alojamiento admite variables de entorno, se recomienda almacenar sus credenciales como variables de entorno en lugar de incluirlas en el archivo config.json.

Por ejemplo, puede implementar el bot a Heroku siguiendo estos pasos:

  1. Cree una nueva aplicación en Heroku y conecte su repositorio de GitHub.
  2. Habilite la implementación automática o la implementación manual desde el repositorio de GitHub.
  3. Configure las variables de entorno en la configuración de la aplicación Heroku para su token de botes de discordia, ID de cliente, ID del gremio y otros detalles requeridos.
  4. Despliegue el bot a Heroku. El archivo Packle.json ya contiene los scripts necesarios para iniciar el bot.

Para obtener instrucciones más detalladas sobre la implementación de un bot de discordia a Heroku, consulte esta guía.

Licencia

Este proyecto tiene licencia bajo la licencia MIT.

Expandir
Información adicional
Aplicaciones relacionadas
Recomendado para ti
Información relacionada Todo