استخدام الخصائص في حل Azure IoT Central
يوضح لك دليل الكيفية هذا كيفية استخدام خصائص الجهاز المحددة في قالب جهاز في تطبيق Azure IoT Central.
تمثل الخصائص قيم النقطة في الوقت. على سبيل المثال، يمكن للجهاز استخدام خاصية للإبلاغ عن درجة الحرارة المستهدفة التي يحاول الوصول إليها. بشكل افتراضي، تكون خصائص الجهاز للقراءة فقط في IoT Central. تتيح لك الخصائص القابلة للكتابة مزامنة الحالة بين جهازك وتطبيق Azure IoT Central.
يمكنك أيضا تعريف خصائص السحابة في تطبيق Azure IoT Central. لا يتم تبادل قيم خصائص السحابة أبدا مع جهاز وهي خارج نطاق هذه المقالة.
للتعرف على اصطلاحات خصائص IoT Pug وPlay، راجع اصطلاحات أجهزة التوصيل و التشغيل IoT.
لمعرفة المزيد حول بيانات الخصائص التي يتبادلها الجهاز مع IoT Central، راجع بيانات تتبع الاستخدام والخصائص وحمولة الأوامر.
لمعرفة كيفية إدارة الخصائص باستخدام واجهة برمجة تطبيقات REST ل IoT Central، راجع كيفية استخدام واجهة برمجة تطبيقات REST ل IoT Central للتحكم في الأجهزة.
لمعرفة كيفية تنفيذ الخصائص في جهاز دون استخدام حزم SDK للجهاز، راجع الاتصال بمركز IoT باستخدام بروتوكول MQTT.
تعريف خصائصك
الخصائص هي حقول البيانات التي تمثل حالة جهازك. استخدم الخصائص لتمثيل الحالة الدائمة للجهاز، مثل حالة تشغيل/إيقاف تشغيل الجهاز. يمكن أن تمثل الخصائص أيضا خصائص الجهاز الأساسية، مثل إصدار البرنامج من الجهاز. تقوم بتعريف الخصائص للقراءة فقط أو قابلة للكتابة.
تظهر لقطة الشاشة التالية تعريف خاصية في تطبيق Azure IoT Central.
يعرض الجدول التالي إعدادات التكوين لإمكانية خاصية.
| الحقل | الوصف |
|---|---|
| اسم العرض | اسم العرض لقيمة الخاصية المستخدمة في لوحات لوحة المعلومات ونماذج الجهاز. |
| الاسم | اسم الخاصية. ينشئ Azure IoT Central قيمة لهذا الحقل من اسم العرض، ولكن يمكنك اختيار القيمة الخاصة بك إذا لزم الأمر. يجب أن يكون هذا الحقل أبجديا رقميا. تستخدم التعليمات البرمجية للجهاز قيمة الاسم هذه. |
| نوع القدرة | الخاصية. |
| النوع الدلالي | النوع الدلالي للخاصيّة، مثل درجة الحرارة أو الحالة أو الحدث. يحدد اختيار النوع الدلالي أي من الحقول التالية تكون متوفرة. |
| مخطط | نوع بيانات الخاصية، مثل أن تكون مزدوجة أو سلسلة أو خط متجه. يحدد النوع الدلالي الخيارات المتاحة. المخطط غير متوفر للأنواع الدلالية للحدث والحالة. |
| قابل للكتابة | إذا لم تكن الخاصية قابلة للكتابة، يمكن للجهاز الإبلاغ عن قيم الخصائص إلى Azure IoT Central. إذا كانت الخاصية قابلة للكتابة، يمكن للجهاز الإبلاغ عن قيم الخصائص إلى Azure IoT Central. ثم يمكن ل Azure IoT Central إرسال تحديثات الخصائص إلى الجهاز. |
| الأهمية | متوفر لنوع الحدث الدلالي فقط. الخطورة هي خطأ أو معلومات أو تحذير. |
| قيم الحالة | متوفر لنوع دلالة الحالة فقط. حدد قيم الحالة المحتملة، لكل منها اسم العرض والاسم ونوع التعداد والقيمة. |
| الوحدة | وحدة لقيمة الخاصية، مثل mph أو %أو °C. |
| وحدة العرض | وحدة عرض للاستخدام على لوحات المعلومات ونماذج الأجهزة. |
| تعليق | أية تعليقات حول إمكانية الخاصية. |
| الوصف | وصف لإمكانية الخاصية. |
للتعرف على لغة تعريف التوأم الرقمي (DTDL) التي يستخدمها Azure IoT Central لتعريف الخصائص في قالب الجهاز، راجع خصائص اصطلاحات > IoT أجهزة التوصيل و التشغيل للقراءة فقط.
تتيح لك الحقول الاختيارية، مثل اسم العرض والوصف، إضافة المزيد من التفاصيل إلى الواجهة والقدرات.
عند إنشاء خاصية، يمكنك تحديد أنواع المخططات المعقدة مثل Object و Enum.
عند تحديد المخطط المعقد، مثل Object، تحتاج إلى تعريف مخطط الكائن.
تنفيذ خصائص القراءة فقط
بشكل افتراضي، تكون الخصائص للقراءة فقط. تسمح خصائص القراءة فقط بتحديث قيمة خاصية الجهاز لتطبيق Azure IoT Central. لا يمكن لتطبيق Azure IoT Central تعيين قيمة خاصية للقراءة فقط.
يستخدم Azure IoT Central توائم الجهاز لمزامنة قيم الخصائص بين الجهاز وتطبيق Azure IoT Central. تستخدم قيم خصائص الجهاز خصائص الجهاز المزدوج المبلغ عنها. لمزيد من المعلومات، راجع توائم الجهاز.
يرسل الجهاز تحديثات الخصائص كحمولة JSON. لمزيد من المعلومات، راجع بيانات تتبع الاستخدام والخصائص وحمولة الأوامر.
يمكنك استخدام SDK لجهاز Azure IoT لإرسال تحديث خاصية إلى تطبيق Azure IoT Central.
على سبيل المثال التطبيقات بلغات متعددة، راجع إنشاء تطبيق عميل وتوصيله بتطبيق Azure IoT Central.
تظهر طريقة العرض التالية في تطبيق Azure IoT Central خصائص الجهاز للقراءة فقط:
تنفيذ خصائص قابلة للكتابة
يعين عامل تشغيل IoT Central خصائص قابلة للكتابة في نموذج. يرسل Azure IoT Central الخاصية إلى الجهاز. يتوقع Azure IoT Central إقرارا من الجهاز.
على سبيل المثال التطبيقات بلغات متعددة، راجع إنشاء تطبيق عميل وتوصيله بتطبيق Azure IoT Central.
يجب أن تتضمن رسالة الاستجابة الحقلين ac و av . حقل ad اختياري. لمعرفة المزيد، راجع خصائص اصطلاحات > IoT أجهزة التوصيل و التشغيل القابلة للكتابة.
عندما يعين عامل التشغيل خاصية قابلة للكتابة في واجهة مستخدم Azure IoT Central، يستخدم التطبيق خاصية الجهاز المزدوج المطلوبة لإرسال القيمة إلى الجهاز. ثم يستجيب الجهاز باستخدام خاصية تم الإبلاغ عنها بواسطة توأم الجهاز. عندما يتلقى Azure IoT Central قيمة الخاصية التي تم الإبلاغ عنها، فإنه يحدث طريقة عرض الخاصية بحالة Accepted.
عند إدخال القيمة وتحديد حفظ، تكون الحالة الأولية معلقة. عندما يقبل الجهاز التغيير، تتغير الحالة إلى مقبول.
استخدام الخصائص على الأجهزة غير المعينة
يمكنك عرض وتحديث الخصائص القابلة للكتابة على جهاز لم يتم تعيينه إلى قالب جهاز.
لعرض الخصائص الموجودة على جهاز غير محدد، انتقل إلى الجهاز في قسم الأجهزة ، وحدد إدارة الجهاز، ثم خصائص الجهاز:
يمكنك تحديث الخصائص القابلة للكتابة في طريقة العرض هذه:
الخطوات التالية
الآن بعد أن تعلمت كيفية استخدام الخصائص في تطبيق Azure IoT Central، راجع: