الصفحة الرئيسية>المتعلقة بالبرمجة>كود الذكاء الاصطناعي
تنزيل

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

يوفر Bot Discord بيانات الطقس من FHDW Weatherstation. يمكن لـ BOT الاشتراك وإلغاء الاشتراك لتلقي تحديثات الطقس ، وسرد القنوات المشتركة حاليًا ، وإلغاء الاشتراك في جميع القنوات في وقت واحد.

هدف المستودع

الهدف من هذا المستودع هو توفير مثال شامل لكيفية دمج البيانات من جهاز نهائي في الأشياء في روبوت Discord باستخدام بروتوكول MQTT. من خلال القيام بذلك ، فإنه يسد الفجوة بين أجهزة إنترنت الأشياء باستخدام تقنية Lorawan ومنصة الاتصالات الشهيرة ، Discord. يمكّن ذلك المستخدمين والمجتمعات من تلقي التحديثات في الوقت الفعلي من أجهزة إنترنت الأشياء الخاصة بهم ، مثل بيانات الطقس ، مباشرة في قنوات الخلاف الخاصة بهم.

من خلال هذا العرض التوضيحي ، يسعى المستودع إلى تمكين المطورين والعشاق لاستكشاف إمكانات دمج بيانات إنترنت الأشياء مع Discord. يعمل المشروع كأساس لإنشاء تطبيقات أكثر تطوراً تستفيد من بيانات Lorawan بطرق مبتكرة. في نهاية المطاف ، يهدف هذا المستودع إلى إلهام المجتمع لإيجاد طرق جديدة وخلاقة لاستخدام بيانات إنترنت الأشياء وتعزيز قدرات روبوتات الخلاف.

التكامل باستخدام MQTT

تم تحقيق تكامل البيانات من الأشياء في روبوت Discord باستخدام بروتوكول MQTT ، وهو بروتوكول مراسلة خفيف الوزن وفعال مصمم لأجهزة إنترنت الأشياء. يسمح MQTT بنقل بيانات آمن وموثوق به بين الجهاز النهائي وروبوت Discord. من خلال الاشتراك في المواضيع المناسبة في مكدس الأشياء ، يمكن لبلاب Discord استلام البيانات التي يتم نقلها بواسطة أجهزة إنترنت الأشياء.

يتم التعرف على الرمز الضروري في mqttHandler.js . تم تحقيق التكامل باتباع هذه الخطوات:

  1. استيراد وظيفة createMqttClient من ملف mqttHandler.js في index.js .
  2. قم بتكوين إعدادات MQTT من خلال توفير بيانات الاعتماد المطلوبة ، مثل عنوان MQTT ، ومستخدم التطبيق ، ومعرف الجهاز ، وكلمة المرور في ملف config.json .
  3. قم بإنشاء عميل MQTT عن طريق الاتصال بوظيفة createMqttClient() في ملف index.js وتوفير بيانات الاعتماد اللازمة ووظيفة رد الاتصال للتعامل مع الرسائل المستلمة.
    • تقوم وظيفة createMqttClient() بإعداد عميل MQTT عن طريق الاتصال بكدس الأشياء والاشتراك في الموضوع المحدد.
    • تقوم بإعداد مستمعي الأحداث لمختلف أحداث MQTT مثل "Connect" و "اشتراك" و "خطأ" و "رسالة".
    • يتم تشغيل حدث "Connect" عندما يتم توصيل عميل MQTT بمجموعة الأشياء.
    • يتم تشغيل حدث "الاشتراك" عندما يشترك عميل MQTT بنجاح في الموضوع المحدد.
    • يتم تشغيل حدث "الخطأ" عند حدوث خطأ في عميل MQTT.
    • يتم تشغيل حدث "الرسالة" عند استلام رسالة من الموضوع المحدد ، والذي يستدعي وظيفة رد الاتصال المقدمة.
  4. في وظيفة رد الاتصال المحددة في ملف index.js :
    • فك تشفير الحمولة الحمولة وحوض البيانات ذات الصلة من الرسالة المستلمة.
    • قم بإنشاء Discord تم تضمينها باستخدام البيانات المحلية عن طريق استدعاء وظيفة createWeatherEmbed() .
    • أرسل Discord تم تضمينه إلى القنوات المحددة عن طريق التكرار من خلال معرفات القناة المخزنة في وحدة dataStorage .
    • في حالة حدوث خطأ أثناء إرسال التضمين إلى قناة ، قم بإزالة معرف القناة من وحدة dataStorage .

من خلال فهم العملية ، يمكن للمطورين البناء على هذه المعرفة للمشاريع المستقبلية التي تتضمن أجهزة إنترنت الأشياء. يعمل التكامل كقالب لتطبيقات مختلفة ، مثل توصيل أجهزة إنترنت الأشياء بمنصات مختلفة ، وتحويل ومعالجة البيانات ، وإنشاء تنبيهات مخصصة أو إشعارات. يوضح هذا المثال كيف يمكن استخدام MQTT كأداة قوية لسد الفجوة بين أجهزة إنترنت الأشياء والتطبيقات الأخرى ، مما يعزز حلولًا أكثر إبداعًا وتكاملاً لإنترنت الأشياء.

المتطلبات الأساسية

  • node.js v14 أو أعلى
  • NPM (عادة ما يكون مع node.js)
  • حساب خلاف نشط مع وصول إداري إلى خادم
  • روبوت ورمز الروبوت المقابل من بوابة Discord Developer
  • معرف تطبيق الشبكة/المكدس ومفتاح API

إنشاء وإعداد روبوت الخلاف

  1. انتقل إلى بوابة Discord Developer وتسجيل الدخول مع حساب Discord الخاص بك.

  2. انقر فوق الزر "تطبيق جديد" ، أعط تطبيقك اسمًا ، ثم انقر فوق "إنشاء".

  3. في إعدادات التطبيق ، انقر فوق علامة التبويب "BOT" ، ثم انقر فوق الزر "إضافة BOT" لإنشاء روبوت لتطبيقك. تأكيد بالنقر فوق "نعم ، افعل ذلك!".

  4. في علامة التبويب "BOT" ، تأكد من تعيين "نية محتوى الرسالة" على true .

  5. ضمن قسم "الرمز المميز" ، انقر فوق "نسخة" لنسخ رمز الروبوت الخاص بك. احتفظ بهذا الرمز المميز ، حيث سيتم استخدامه لمصادقة الروبوت الخاص بك بالخلاف.

  6. (اختياري) تخصيص اسم الروبوت الخاص بك وصورة الملف الشخصي والإعدادات الأخرى حسب الرغبة. يفتح

تثبيت

  1. استنساخ المستودع: 
git clone https://github.com/yourusername/FHDW-Weatherstation-Discord-Bot.git
  1. تثبيت التبعيات المطلوبة: 
... 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. قم بإنشاء ملف config.json في دليل الروبوت وأضف رمز الروبوت الخاص بك ، معرف العميل ، معرف النقابة ، والتفاصيل المطلوبة الأخرى (معرف النقابة اختياري ، مطلوب فقط للأوامر الخاصة بالخادم): 
{
  "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 المناسب (استبدل your_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=1088555644333867069&permissions=8&SCOPE=BOT

  1. نشر أوامر SLASH على خادم Discord الخاص بك: 
... T heThingsNetwork-DiscordBot-FHDW-WeatherData B ot > node deploy-commands.js
 (You might have to restart your Discord-Client afterwards)
  1. قم بتشغيل الروبوت:

3.1. لبدء الروبوت ، قم بتشغيل: 

... 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 لرمز BOT Discord ومعرف العميل ومعرف النقابة وغيرها من التفاصيل المطلوبة.
  4. نشر الروبوت إلى هيروكو. يحتوي ملف package.json بالفعل على البرامج النصية اللازمة لبدء الروبوت.

لمزيد من الإرشادات التفصيلية حول نشر روبوت Discord على Heroku ، تحقق من هذا الدليل.

رخصة

هذا المشروع مرخص بموجب ترخيص معهد ماساتشوستس للتكنولوجيا.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل