اتصال الجهاز ودخول القياس عن بعد
هام
تم إصدار إصدار جديد من خدمة Azure Digital Twins. في ضوء القدرات الموسعة للخدمة الجديدة، تم إيقاف خدمة Azure Digital Twins الأصلية (الموضحة في مجموعة الوثائق هذه).
لعرض وثائق الخدمة الجديدة، قم بزيارة وثائق Azure Digital Twins النشطة.
تشكل بيانات القياس عن بعد التي ترسلها الأجهزة وأجهزة الاستشعار العمود الفقري لأي حل من حلول إنترنت الأشياء. تعد كيفية تمثيل هذه الموارد المختلفة وإدارتها في سياق الموقع من الشواغل الرئيسية في تطوير تطبيقات إنترنت الأشياء. يبسط Azure Digital Twins عملية تطوير حلول إنترنت الأشياء من خلال توحيد الأجهزة وأجهزة الاستشعار مع رسم بياني للذكاء المكاني.
للبدء، قم بإنشاء مورد Azure IoT Hub في جذر الرسم البياني المكاني. يسمح مورد IoT Hub لجميع الأجهزة الموجودة أسفل مساحة الجذر بإرسال الرسائل. بعد إنشاء مركز إنترنت الأشياء، قم بتسجيل الأجهزة المزودة بمستشعرات داخل مثيل Digital Twins. يمكن للأجهزة إرسال البيانات إلى خدمة Digital Twins عبر SDK لجهاز Azure IoT.
للحصول على دليل خطوة بخطوة حول كيفية إحضار الأجهزة على متن الطائرة، اقرأ البرنامج التعليمي لنشر التوائم الرقمية وتكوينها. في لمحة ، الخطوات هي:
- نشر مثيل Digital Twins من مدخل Azure.
- إنشاء مسافات في الرسم البياني الخاص بك.
- قم بإنشاء مورد IoT Hub، وقم بتعيينه إلى مساحة في الرسم البياني الخاص بك.
- قم بإنشاء أجهزة وأجهزة استشعار في الرسم البياني، وقم بتعيينها إلى المساحات التي تم إنشاؤها في الخطوات السابقة.
- قم بإنشاء مطابق لتصفية رسائل القياس عن بعد استنادا إلى الشروط.
- قم بإنشاء دالة معرفة من قبل المستخدم، وقم بتعيينها إلى مساحة في الرسم البياني للمعالجة المخصصة لرسائل القياس عن بعد.
- قم بتعيين دور للسماح للدالة المعرفة من قبل المستخدم بالوصول إلى بيانات الرسم البياني.
- احصل على سلسلة اتصال جهاز IoT Hub من واجهات برمجة تطبيقات إدارة التوائم الرقمية.
- قم بتكوين سلسلة اتصال الجهاز على الجهاز باستخدام حزمة SDK لجهاز Azure IoT.
في الأقسام التالية، ستتعرف على كيفية الحصول على سلسلة اتصال جهاز IoT Hub من واجهة برمجة تطبيقات إدارة التوائم الرقمية. ستتعرف أيضا على كيفية استخدام تنسيق رسالة القياس عن بعد IoT Hub لإرسال القياس عن بعد المستند إلى المستشعر. يتطلب Digital Twins أن ترتبط كل قطعة من القياس عن بعد التي تتلقاها بمستشعر داخل الرسم البياني المكاني. يضمن هذا المطلب معالجة البيانات وتوجيهها ضمن السياق المكاني المناسب.
الحصول على سلسلة اتصال جهاز IoT Hub من واجهة برمجة تطبيقات الإدارة
في الأمثلة أدناه ، YOUR_MANAGEMENT_API_URL يشير إلى عنوان URI لواجهات برمجة تطبيقات Digital Twins:
https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/api/v1.0
| الاسم | استبدال بـ |
|---|---|
| YOUR_INSTANCE_NAME | اسم مثيل Azure Digital Twins الخاص بك |
| YOUR_LOCATION | المنطقة التي تتم استضافة المثيل عليها |
قم بإجراء مكالمة GET على واجهة برمجة تطبيقات الجهاز باستخدام includes=ConnectionString معلمة للحصول على سلسلة اتصال جهاز IoT Hub. قم بالتصفية حسب المعرف الفريد العمومي للجهاز أو معرف الجهاز للعثور على الجهاز المحدد.
YOUR_MANAGEMENT_API_URL/devices/YOUR_DEVICE_GUID?includes=ConnectionString
| المعلمة | استبدال بـ |
|---|---|
| YOUR_DEVICE_GUID | معرف الجهاز |
YOUR_MANAGEMENT_API_URL/devices?HardwareIds=YOUR_DEVICE_HARDWARE_ID&includes=ConnectionString
| قيمة المعلمة | استبدال بـ |
|---|---|
| YOUR_DEVICE_HARDWARE_ID | معرف جهاز الجهاز |
في حمولة الاستجابة، انسخ خاصية connectionString الخاصة بالجهاز. يمكنك استخدامه عند الاتصال ب Azure IoT device SDK لإرسال البيانات إلى Digital Twins.
رسالة من الجهاز إلى السحابة
يمكنك تخصيص تنسيق الرسائل والحمولة الصافية لجهازك لتناسب احتياجات الحل الخاص بك. استخدم أي عقد بيانات يمكن تسلسله في صفيف بايت أو دفق مدعوم من قبل فئة رسالة عميل جهاز Azure IoT، Message(byte[] byteArray). يمكن أن تكون الرسالة تنسيقا ثنائيا مخصصا من اختيارك، طالما أنك تقوم بفك تشفير عقد البيانات في وظيفة مقابلة يحددها المستخدم. هناك متطلب واحد فقط لرسالة من الجهاز إلى السحابة. احتفظ بمجموعة من الخصائص للتأكد من توجيه رسالتك بشكل مناسب إلى محرك المعالجة.
خصائص القياس عن بعد
يمكن أن تكون محتويات الحمولة الصافية للرسالة بيانات عشوائية يصل حجمها إلى 256 كيلوبايت. هناك بعض المتطلبات المتوقعة لخصائص من Message.Properties هذا النوع. يوضح الجدول الخصائص المطلوبة والاختيارية التي يدعمها النظام.
| اسم الخاصية | القيمة | مطلوب | الوصف |
|---|---|---|---|
| ديجيتال توينز - القياس عن بعد | 1.0 | نعم | قيمة ثابتة تحدد رسالة إلى النظام. |
| DigitalTwins-SensorHardwareId | string(72) |
نعم | معرف فريد للمستشعر الذي يرسل الرسالة. يجب أن تتطابق هذه القيمة مع خاصية HardwareId الخاصة بالكائن حتى يتمكن النظام من معالجتها. على سبيل المثال، 00FF0643BE88-CO2. |
| CreationTimeUtc | string |
لا | سلسلة تواريخ بتنسيق ISO 8601 تحدد وقت أخذ العينات للحمولة. على سبيل المثال، 2018-09-20T07:35:00.8587882-07:00. |
| CorrelationId | string |
لا | UUID يستخدم لتتبع الأحداث عبر النظام. على سبيل المثال، cec16751-ab27-405d-8fe6-c68e1412ce1f. |
أرسل رسالتك إلى Digital Twins
استخدم مكالمة DeviceClient SendEventAsync أو SendEventBatchAsync لإرسال رسالتك إلى Digital Twins.
الخطوات التالية
- للتعرف على إمكانات معالجة بيانات Azure Digital Twins والوظائف المعرفة من قبل المستخدم، اقرأ معالجة بيانات Azure Digital Twins والدالات المعرفة من قبل المستخدم.