الوثائق

البدء السريع

كل ما تحتاجه لربط جهازك الأول بـ MQTT One: بيانات الاتصال وأمثلة الكود وأفضل الممارسات.

قبل أن تبدأ

للاتصال بـ MQTT One تحتاج إلى عنوان البروكر واسم مستخدم وكلمة مرور، وتُنشأ لك هذه البيانات تلقائياً عند بدء مشروع في منصة iotBind.

  1. أنشئ حساباً مجانياً أو سجّل الدخول في iotBind.
  2. أنشئ مشروعاً جديداً (أو افتح مشروعاً موجوداً).
  3. افتح تفاصيل المشروع لتجد عنوان البروكر وبيانات الدخول والـ Topics المخصصة له.

بيانات الاتصال

استخدم القيم التالية مع أي عميل MQTT. في أمثلة هذه الصفحة your-broker.mqtt.one مجرد عنوان توضيحي: استبدله بعنوان البروكر الظاهر في مشروعك.

الإعدادالقيمة
عنوان البروكرyour-broker.mqtt.one (من مشروعك)
MQTT (TCP)1883
MQTT عبر TLS8883
WebSocket8083، المسار /mqtt
WebSocket آمن8084، المسار /mqtt
اسم المستخدم / كلمة المروربيانات دخول البروكر من مشروعك
معرّف العميل (Client ID)أي قيمة فريدة لكل جهاز، مثل esp32-kitchen-01
إصدار البروتوكولMQTT 3.1 / 3.1.1

تتوفر عدة بروكرات، ولكل مشروع عنوان بروكر خاص به. انسخ دائماً العنوان كما يظهر في مشروعك.

أمثلة الكود

اختر منصتك. استبدل YOUR_USERNAME وYOUR_PASSWORD وعنوان البروكر وyour/topic بالقيم الموجودة في مشروعك.

terminal
# Subscribe to a topic (keeps listening)
mosquitto_sub -h your-broker.mqtt.one -p 1883 \
  -u "YOUR_USERNAME" -P "YOUR_PASSWORD" \
  -t "your/topic" -q 1 -v

# Publish a message from another terminal
mosquitto_pub -h your-broker.mqtt.one -p 1883 \
  -u "YOUR_USERNAME" -P "YOUR_PASSWORD" \
  -t "your/topic" -m "hello from MQTT One" -q 1

# Encrypted connection over TLS
mosquitto_sub -h your-broker.mqtt.one -p 8883 --capath /etc/ssl/certs \
  -u "YOUR_USERNAME" -P "YOUR_PASSWORD" -t "your/topic"

الـ Topics وقواعد الصلاحيات

لا يستطيع مستخدم البروكر النشر أو الاشتراك إلا في الـ Topics المسموحة له. يعرض مشروعك الـ Topics المتاحة وما إذا كان كل منها يسمح بالنشر أو الاشتراك أو كليهما.

  • استخدم أسماء الـ Topics كما تظهر في مشروعك تماماً — الأسماء حساسة لحالة الأحرف.
  • نظّم البيانات بمستويات تفصلها /، مثل your/topic/temperature.
  • استخدم الأحرف والأرقام والشرطة والشرطة السفلية، وتجنب المسافات والرموز الخاصة.
  • يمكن استخدام الرموز الشاملة + و# عند الاشتراك، ضمن الـ Topics المسموحة لك.

أفضل الممارسات

معرّف عميل فريد

إذا اتصل عميلان بنفس المعرّف فسيقطع كل منهما اتصال الآخر. امنح كل جهاز معرّفاً خاصاً.

إبقاء الاتصال

استخدم فترة Keep Alive بين 30 و60 ثانية لاكتشاف الاتصالات المقطوعة بسرعة.

إعادة الاتصال تلقائياً

الشبكات تنقطع أحياناً. اجعل جهازك يعيد المحاولة بعد مهلة قصيرة بدلاً من التوقف.

اختر QoS المناسب

QoS 0 للقراءات المتكررة، وQoS 1 لمعظم الرسائل، وQoS 2 فقط عندما يكون التكرار غير مقبول.

Retain ورسالة الوصية

احفظ آخر حالة بخيار Retain، وسجّل رسالة وصية للإعلان عن انقطاع الجهاز.

شفّر على الشبكات العامة

استخدم المنفذ 8883 (TLS) أو 8084 (WebSocket الآمن) عندما تمر البيانات عبر الإنترنت.

حل المشكلات

المشكلةما الذي يجب التحقق منه
رفض الاتصال: غير مصرّحتحقق من اسم المستخدم وكلمة المرور، وتأكد أنك نسخت عنوان البروكر الخاص بنفس المشروع.
تم الاتصال لكن لا تصل رسائلتأكد أن الناشر والمشترك يستخدمان نفس الـ Topic بالضبط، وأن مستخدمك مسموح له بالاشتراك فيه.
ينقطع الاتصال كل بضع ثوانٍغالباً يستخدم عميل آخر نفس معرّف العميل. استخدم معرّفاً فريداً لكل جهاز.
لا يمكن الاتصال من المتصفحتحتاج المتصفحات إلى WebSocket: استخدم المنفذ 8084 مع wss:// والمسار /mqtt.
انتهت مهلة الاتصالقد تحجب شبكتك المنفذ. جرّب منفذاً آخر مثل 8883 أو 8084، أو اختبر من شبكة مختلفة.

اربط جهازك الأول خلال دقائق

أنشئ حساباً مجانياً في iotBind، وابدأ مشروعاً، واحصل فوراً على بيانات بروكر MQTT One الخاص بك.