Discord Bot FHDW BG Weather TheThingsStack TheThingsNetwork

discord-bot-fhdw-bg-weather-weather-weather

บอท Discord นี้ให้ข้อมูลสภาพอากาศจาก FHDW Weatherstation บอทสามารถสมัครรับข้อมูลและยกเลิกการสมัครรับข้อมูลเพื่อรับการอัปเดตสภาพอากาศแสดงรายการช่องที่สมัครสมาชิกปัจจุบันและยกเลิกการสมัครทุกช่องทางพร้อมกัน

จุดมุ่งหมายของที่เก็บข้อมูล

จุดมุ่งหมายของที่เก็บนี้คือการให้ตัวอย่างที่ครอบคลุมเกี่ยวกับวิธีการรวมข้อมูลจากอุปกรณ์ปลายทางในสิ่งที่สแต็กลงในบอทแบบ discord โดยใช้โปรโตคอล MQTT ด้วยการทำเช่นนั้นจะเชื่อมช่องว่างระหว่างอุปกรณ์ IoT โดยใช้เทคโนโลยี Lorawan และแพลตฟอร์มการสื่อสารยอดนิยม Discord สิ่งนี้ช่วยให้ผู้ใช้และชุมชนได้รับการอัปเดตแบบเรียลไทม์จากอุปกรณ์ IoT ของพวกเขาเช่นข้อมูลสภาพอากาศโดยตรงในช่องสัญญาณ Discord ของพวกเขาโดยตรง

จากการสาธิตนี้ที่เก็บจะพยายามเพิ่มขีดความสามารถให้กับนักพัฒนาและผู้ที่ชื่นชอบในการสำรวจศักยภาพของการรวมข้อมูล IoT เข้ากับ Discord โครงการนี้ทำหน้าที่เป็นรากฐานสำหรับการสร้างแอพพลิเคชั่นที่ซับซ้อนยิ่งขึ้นซึ่งใช้ประโยชน์จากข้อมูล Lorawan ในรูปแบบที่เป็นนวัตกรรม ในที่สุดพื้นที่เก็บข้อมูลนี้มีวัตถุประสงค์เพื่อสร้างแรงบันดาลใจให้ชุมชนค้นหาวิธีการใหม่และสร้างสรรค์ในการใช้ข้อมูล IoT และเพิ่มขีดความสามารถของบอทที่ไม่ลงรอยกัน

การรวมโดยใช้ MQTT

การรวมข้อมูลจากสิ่งต่าง ๆ สแต็กลงในบอทแบบไม่ลงรอยกันนั้นทำได้โดยใช้โปรโตคอล MQTT ซึ่งเป็นโปรโตคอลการส่งข้อความที่มีน้ำหนักเบาและมีประสิทธิภาพที่ออกแบบมาสำหรับอุปกรณ์ IoT MQTT ช่วยให้การถ่ายโอนข้อมูลที่ปลอดภัยและเชื่อถือได้ระหว่างอุปกรณ์ปลายทางและบอท Discord ด้วยการสมัครรับหัวข้อที่เหมาะสมในสิ่งที่สแต็ก Discord Bot สามารถรับข้อมูลที่ส่งโดยอุปกรณ์ IoT

รหัสที่จำเป็นถูกฝังอยู่ใน mqttHandler.js การบูรณาการทำได้โดยทำตามขั้นตอนเหล่านี้:

1. นำเข้าฟังก์ชั่น createMqttClient จากไฟล์ mqttHandler.js ใน index.js
2. กำหนดค่าการตั้งค่า MQTT โดยให้ข้อมูลรับรองที่จำเป็นเช่นที่อยู่ MQTT ผู้ใช้แอปพลิเคชันรหัสอุปกรณ์และรหัสผ่านในไฟล์ config.json
3. สร้างไคลเอนต์ MQTT โดยเรียกฟังก์ชัน createMqttClient() ในไฟล์ index.js และให้ข้อมูลรับรองที่จำเป็นและฟังก์ชั่นการโทรกลับเพื่อจัดการข้อความที่ได้รับ
   • ฟังก์ชั่น createMqttClient() ตั้งค่าไคลเอนต์ MQTT โดยเชื่อมต่อกับสิ่งต่าง ๆ สแต็กและสมัครรับหัวข้อที่ระบุ
   • มันตั้งค่าผู้ฟังเหตุการณ์สำหรับเหตุการณ์ MQTT ต่างๆเช่น 'เชื่อมต่อ', 'สมัครสมาชิก', 'ข้อผิดพลาด' และ 'ข้อความ'
   • เหตุการณ์ 'เชื่อมต่อ' จะถูกทริกเกอร์เมื่อไคลเอนต์ MQTT เชื่อมต่อกับสิ่งที่สแต็ก
   • เหตุการณ์ 'สมัครสมาชิก' จะถูกทริกเกอร์เมื่อไคลเอนต์ MQTT สมัครสมาชิกได้สำเร็จในหัวข้อที่ระบุ
   • เหตุการณ์ 'ข้อผิดพลาด' จะถูกทริกเกอร์เมื่อเกิดข้อผิดพลาดในไคลเอนต์ MQTT
   • เหตุการณ์ 'ข้อความ' จะถูกทริกเกอร์เมื่อได้รับข้อความจากหัวข้อที่ระบุซึ่งจะเรียกฟังก์ชันการโทรกลับที่ให้ไว้
4. ในฟังก์ชั่นการโทรกลับที่กำหนดไว้ในไฟล์ index.js :
   • ถอดรหัสเพย์โหลดและแยกวิเคราะห์ข้อมูลที่เกี่ยวข้องจากข้อความที่ได้รับ
   • สร้างความไม่ลงรอยกันที่ฝังโดยใช้ข้อมูลที่แยกวิเคราะห์โดยเรียกฟังก์ชัน createWeatherEmbed()
   • ส่งความไม่ลงรอยกันที่ฝังไว้ในช่องที่ระบุโดยการวนซ้ำผ่านรหัสช่องที่เก็บไว้ในโมดูล dataStorage
   • หากเกิดข้อผิดพลาดในขณะที่ส่งช่องคลอดไปยังช่องให้ลบ ID ช่องสัญญาณออกจากโมดูล dataStorage

โดยการทำความเข้าใจกระบวนการนักพัฒนาสามารถสร้างความรู้นี้สำหรับโครงการในอนาคตที่เกี่ยวข้องกับอุปกรณ์ IoT การรวมทำหน้าที่เป็นเทมเพลตสำหรับแอปพลิเคชันต่าง ๆ เช่นการเชื่อมต่ออุปกรณ์ IoT กับแพลตฟอร์มที่แตกต่างกันการแปลงและการประมวลผลข้อมูลและการสร้างการแจ้งเตือนที่กำหนดเองหรือการแจ้งเตือน ตัวอย่างนี้แสดงให้เห็นว่า MQTT สามารถใช้เป็นเครื่องมือที่ทรงพลังในการเชื่อมช่องว่างระหว่างอุปกรณ์ IoT และแอพพลิเคชั่นอื่น ๆ ส่งเสริมโซลูชั่นที่เป็นนวัตกรรมและบูรณาการมากขึ้นสำหรับอินเทอร์เน็ตของสิ่งต่าง ๆ

ข้อกำหนดเบื้องต้น

• node.js v14 หรือสูงกว่า
• NPM (มักจะรวมกับ node.js)
• บัญชี Discord ที่ใช้งานอยู่พร้อมการเข้าถึงผู้ดูแลระบบไปยังเซิร์ฟเวอร์
• บอทและโทเค็นบอทที่สอดคล้องกันจากพอร์ทัลนักพัฒนา Discord
• รหัสแอปพลิเคชันเครือข่าย/สแต็คและรหัส API

การสร้างและการตั้งค่าบอท Discord

1. ไปที่พอร์ทัลนักพัฒนา Discord และลงชื่อเข้าใช้กับบัญชี Discord ของคุณ

2. คลิกที่ปุ่ม "แอปพลิเคชันใหม่" ให้ชื่อแอปพลิเคชันของคุณแล้วคลิก "สร้าง"

3. ในการตั้งค่าของแอปพลิเคชันคลิกที่แท็บ "บอท" จากนั้นคลิกที่ปุ่ม "เพิ่มบอท" เพื่อสร้างบอทสำหรับแอปพลิเคชันของคุณ ยืนยันโดยคลิก "ใช่ทำ!"

4. ในแท็บ "บอท" ตรวจสอบให้แน่ใจว่า "ความตั้งใจเนื้อหาข้อความ" ถูกตั้งค่าเป็น true

5. ภายใต้ส่วน "โทเค็น" คลิก "คัดลอก" เพื่อคัดลอกโทเค็นบอทของคุณ รักษาโทเค็นนี้ให้ปลอดภัยเนื่องจากจะใช้เพื่อตรวจสอบความถูกต้องของบอทของคุณด้วยความไม่ลงรอยกัน

6. (ไม่บังคับ) ปรับแต่งชื่อบอทรูปโปรไฟล์และการตั้งค่าอื่น ๆ ตามที่ต้องการ เปิด

การติดตั้ง

1. โคลนที่เก็บ:

git clone https://github.com/yourusername/FHDW-Weatherstation-Discord-Bot.git

2. ติดตั้งการพึ่งพาที่ต้องการ:

... 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`

3. สร้างไฟล์ config.json ในไดเรกทอรี Bot และเพิ่มโทเค็นบอท Discord ของคุณรหัสไคลเอนต์รหัสกิลด์และรายละเอียดอื่น ๆ ที่จำเป็น (ID กิลด์เป็นทางเลือกจำเป็นสำหรับคำสั่งเฉพาะเซิร์ฟเวอร์เท่านั้น):

{
  "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 "
}

ตัวอย่าง:

{
  "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 "
}

การใช้งาน

1. เชิญบอทไปยังเซิร์ฟเวอร์ Discord ของคุณโดยใช้ URL ที่เหมาะสม (แทนที่ our_discord_bot_client_id ด้วยรหัสไคลเอนต์จริง):

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

ตัวอย่าง fhdw-weather-bot: https://discord.com/api/oauth2/authorize?client_id=10885556443333867069&permissions=8&scope=bot

2. ปรับใช้คำสั่ง Slash ไปยังเซิร์ฟเวอร์ Discord ของคุณ:

... T heThingsNetwork-DiscordBot-FHDW-WeatherData B ot > node deploy-commands.js

 (You might have to restart your Discord-Client afterwards)

3. เรียกใช้บอท:

3.1. ในการเริ่มต้นบอท Run:

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

3.2. ในการเรียกใช้บอทในโหมดการพัฒนาด้วย Nodemon ให้เรียกใช้:

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

คำสั่ง

• /subscribe [channel] : สมัครสมาชิกช่องไปยัง FHDW-Weatherstation หากไม่มีช่องสัญญาณจะมีการสมัครรับช่องทางปัจจุบัน
• /unsubscribe [channel] : ยกเลิกการสมัครช่องจาก FHDW-Weatherstation หากไม่มีช่องทางช่องทางปัจจุบันจะถูกยกเลิกการสมัคร
• /list : แสดงรายการทั้งหมดที่สมัครสมาชิก FHDW-Weatherstation
• /unsubscribe_all : ยกเลิกการสมัครทุกช่องทางจาก FHDW-Weatherstation

การปรับใช้กับแพลตฟอร์มโฮสติ้ง

ในการปรับใช้บอทบนแพลตฟอร์มโฮสติ้งให้ทำตามคำแนะนำเฉพาะแพลตฟอร์มสำหรับแอปพลิเคชัน Node.js ตรวจสอบให้แน่ใจว่าได้รวมไฟล์ config.json ด้วยข้อมูลรับรองของคุณในแพ็คเกจการปรับใช้

ตรวจสอบให้แน่ใจว่าไฟล์ config.json รวมอยู่ในการปรับใช้ของคุณและโทเค็นบอทของคุณและข้อมูลที่ละเอียดอ่อนอื่น ๆ นั้นปลอดภัย หากแพลตฟอร์มโฮสติ้งรองรับตัวแปรสภาพแวดล้อมขอแนะนำให้จัดเก็บข้อมูลประจำตัวของคุณเป็นตัวแปรสภาพแวดล้อมแทนที่จะรวมไว้ในไฟล์ config.json

ตัวอย่างเช่นคุณสามารถปรับใช้บอทไปยัง Heroku โดยทำตามขั้นตอนเหล่านี้:

1. สร้างแอพใหม่บน Heroku และเชื่อมต่อที่เก็บ GitHub ของคุณ
2. เปิดใช้งานการปรับใช้อัตโนมัติหรือการปรับใช้ด้วยตนเองจากที่เก็บ GitHub
3. ตั้งค่าตัวแปรสภาพแวดล้อมในการตั้งค่าแอป Heroku สำหรับโทเค็นบอท Discord ของคุณรหัสลูกค้ารหัสกิลด์และรายละเอียดอื่น ๆ ที่จำเป็น
4. ปรับใช้บอทไปที่ Heroku ไฟล์ package.json มีสคริปต์ที่จำเป็นสำหรับการเริ่มต้นบอท

สำหรับคำแนะนำโดยละเอียดเพิ่มเติมเกี่ยวกับการปรับใช้บอท Discord กับ Heroku ลองดูคู่มือนี้

ใบอนุญาต

โครงการนี้ได้รับใบอนุญาตภายใต้ใบอนุญาต MIT