Beranda>Terkait pemrograman>Kode Sumber AI
Unduh

Discord-Bot-FHDW-BG-Weather-thethingsstack-thethingsnetwork

Discord Bot ini menyediakan data cuaca dari Weatherstation FHDW. Bot dapat berlangganan dan berhenti berlangganan saluran untuk menerima pembaruan cuaca, daftar saluran yang saat ini berlangganan, dan berhenti berlangganan semua saluran sekaligus.

Tujuan repositori

Tujuan dari repositori ini adalah untuk memberikan contoh komprehensif tentang cara mengintegrasikan data dari perangkat akhir dalam hal -hal yang ditumpuk ke dalam bot perselisihan menggunakan protokol MQTT. Dengan melakukan itu, ia menjembatani kesenjangan antara perangkat IoT menggunakan teknologi Lorawan dan platform komunikasi populer, perselisihan. Ini memungkinkan pengguna dan masyarakat untuk menerima pembaruan waktu nyata dari perangkat IoT mereka, seperti data cuaca, langsung di saluran perselisihan mereka.

Melalui demonstrasi ini, repositori berupaya memberdayakan pengembang dan penggemar untuk mengeksplorasi potensi mengintegrasikan data IoT dengan perselisihan. Proyek ini berfungsi sebagai dasar untuk membuat aplikasi yang lebih canggih yang memanfaatkan data Lorawan dengan cara yang inovatif. Pada akhirnya, repositori ini bertujuan untuk menginspirasi masyarakat untuk menemukan cara -cara baru dan kreatif untuk memanfaatkan data IoT dan meningkatkan kemampuan bot perselisihan mereka.

Integrasi menggunakan MQTT

Integrasi data dari hal -hal yang ditumpuk ke dalam bot perselisihan dicapai dengan menggunakan protokol MQTT, protokol pesan yang ringan dan efisien yang dirancang untuk perangkat IoT. MQTT memungkinkan transfer data yang aman dan andal antara perangkat akhir dan bot Discord. Dengan berlangganan topik yang sesuai dalam hal -hal yang ditumpuk, bot Discord dapat menerima data yang dikirimkan oleh perangkat IoT.

Kode yang diperlukan diimpremakan dalam mqttHandler.js . Integrasi dicapai dengan mengikuti langkah -langkah ini:

  1. Impor fungsi createMqttClient dari file mqttHandler.js di index.js .
  2. Konfigurasikan pengaturan MQTT dengan memberikan kredensial yang diperlukan, seperti alamat MQTT, pengguna aplikasi, ID perangkat, dan kata sandi dalam file config.json .
  3. Buat klien MQTT dengan memanggil fungsi createMqttClient() dalam file index.js dan memberikan kredensial yang diperlukan dan fungsi panggilan balik untuk menangani pesan yang diterima.
    • Fungsi createMqttClient() mengatur klien MQTT dengan menghubungkan ke hal -hal yang ditumpuk dan berlangganan topik yang ditentukan.
    • Ini mengatur pendengar acara untuk berbagai acara MQTT seperti 'connect', 'berlangganan', 'kesalahan', dan 'pesan'.
    • Acara 'Connect' dipicu ketika klien MQTT terhubung ke tumpukan hal -hal.
    • Acara 'berlangganan' dipicu ketika klien MQTT berhasil berlangganan topik yang ditentukan.
    • Acara 'Kesalahan' dipicu ketika kesalahan terjadi pada klien MQTT.
    • Acara 'pesan' dipicu ketika pesan diterima dari topik yang ditentukan, yang kemudian memanggil fungsi panggilan balik yang disediakan.
  4. Dalam fungsi callback yang ditentukan dalam file index.js :
    • Dekode payload dan parse data yang relevan dari pesan yang diterima.
    • Buat embed perselisihan menggunakan data parsed dengan memanggil fungsi createWeatherEmbed() .
    • Kirim perselisihan yang disematkan ke saluran yang ditentukan dengan mengulangi ID saluran yang disimpan dalam modul dataStorage .
    • Jika terjadi kesalahan saat mengirim embed ke saluran, lepaskan ID saluran dari modul dataStorage .

Dengan memahami prosesnya, pengembang dapat membangun pengetahuan ini untuk proyek masa depan yang melibatkan perangkat IoT. Integrasi berfungsi sebagai templat untuk berbagai aplikasi, seperti menghubungkan perangkat IoT ke platform yang berbeda, mengubah dan memproses data, dan membuat peringatan atau pemberitahuan khusus. Contoh ini menunjukkan bagaimana MQTT dapat digunakan sebagai alat yang ampuh untuk menjembatani kesenjangan antara perangkat IoT dan aplikasi lainnya, menumbuhkan solusi yang lebih inovatif dan terintegrasi untuk Internet of Things.

Prasyarat

  • Node.js v14 atau lebih tinggi
  • NPM (biasanya dibundel dengan node.js)
  • Akun Perselisihan Aktif dengan akses administratif ke server
  • Bot dan token bot yang sesuai dari portal pengembang perselisihan
  • ID Aplikasi Jaringan/Tumpukan dan Kunci API

Membuat dan menyiapkan Bot Perselisihan

  1. Pergi ke Portal Pengembang Perselisihan dan masuk dengan akun Perselisihan Anda.

  2. Klik tombol "Aplikasi Baru", berikan nama aplikasi Anda, lalu klik "Buat".

  3. Di pengaturan aplikasi, klik pada tab "Bot", lalu klik tombol "Tambahkan Bot" untuk membuat bot untuk aplikasi Anda. Konfirmasi dengan mengklik "Ya, lakukan!".

  4. Di tab "bot" pastikan bahwa "niat konten pesan" diatur ke true .

  5. Di bawah bagian "Token", klik "Salin" untuk menyalin token bot Anda. Jaga agar token ini aman, karena akan digunakan untuk mengotentikasi bot Anda dengan perselisihan.

  6. (Opsional) Sesuaikan nama bot Anda, gambar profil, dan pengaturan lainnya seperti yang diinginkan. Membuka

Instalasi

  1. Klon Repositori: 
git clone https://github.com/yourusername/FHDW-Weatherstation-Discord-Bot.git
  1. Instal dependensi yang diperlukan: 
... 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. Buat file config.json di direktori bot dan tambahkan token bot discord Anda, ID klien, ID guild, dan detail yang diperlukan lainnya (ID guild adalah opsional, hanya diperlukan untuk perintah spesifik server): 
{
  "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 "
}

Contoh: 

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

Penggunaan

  1. Undang bot ke server Discord Anda menggunakan URL yang sesuai (ganti your_discord_bot_client_id dengan ID klien yang sebenarnya):

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

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

  1. Menyebarkan perintah slash ke server perselisihan Anda: 
... T heThingsNetwork-DiscordBot-FHDW-WeatherData B ot > node deploy-commands.js
 (You might have to restart your Discord-Client afterwards)
  1. Jalankan bot:

3.1. Untuk memulai bot, jalankan: 

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

3.2. Untuk menjalankan bot dalam mode pengembangan dengan nodemon, jalankan: 

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

Perintah

  • /subscribe [channel] : Berlangganan saluran ke Weatherstation FHDW. Jika tidak ada saluran yang disediakan, saluran saat ini akan berlangganan.
  • /unsubscribe [channel] : Berhenti berlangganan saluran dari Weatherstation FHDW. Jika tidak ada saluran yang disediakan, saluran saat ini tidak akan berlangganan.
  • /list : Sebutkan semua saluran yang saat ini berlangganan Weatherstation FHDW.
  • /unsubscribe_all : berhenti berlangganan semua saluran dari weatherstation fhdw.

Penempatan ke platform hosting

Untuk menggunakan bot pada platform hosting, ikuti instruksi khusus platform untuk aplikasi Node.js. Pastikan untuk memasukkan file config.json dengan kredensial Anda dalam paket penyebaran.

Pastikan file config.json termasuk dalam penyebaran Anda dan bahwa token bot Anda dan informasi sensitif lainnya tetap aman. Jika platform hosting mendukung variabel lingkungan, disarankan untuk menyimpan kredensial Anda sebagai variabel lingkungan daripada memasukkannya ke dalam file config.json.

Misalnya, Anda dapat menggunakan bot ke Heroku dengan mengikuti langkah -langkah ini:

  1. Buat aplikasi baru di Heroku dan hubungkan repositori GitHub Anda.
  2. Aktifkan penyebaran otomatis atau penyebaran manual dari repositori GitHub.
  3. Mengatur variabel lingkungan di pengaturan aplikasi Heroku untuk token bot Discord Anda, ID klien, ID guild, dan detail lain yang diperlukan.
  4. Menyebarkan bot ke Heroku. File package.json sudah berisi skrip yang diperlukan untuk memulai bot.

Untuk instruksi yang lebih rinci tentang menggunakan bot perselisihan ke Heroku, lihat panduan ini.

Lisensi

Proyek ini dilisensikan di bawah lisensi MIT.

Memperluas
Informasi Tambahan
Aplikasi Terkait
Direkomendasikan untuk Anda
Informasi Terkait Semua