التشغيل السريع: البحث عن الغرف المتوفرة باستخدام Azure Digital Twins

  • مقالة

هام

تم إصدار إصدار جديد من خدمة Azure Digital Twins. في ضوء القدرات الموسعة للخدمة الجديدة، تم إيقاف خدمة Azure Digital Twins الأصلية (الموضحة في مجموعة الوثائق هذه).

لعرض وثائق الخدمة الجديدة، تفضل بزيارة وثائق Azure Digital Twins النشطة.

تتيح لك خدمة Azure Digital Twins إعادة إنشاء صورة رقمية لبيئتك المادية. يمكنك بعد ذلك الحصول على إعلام بالأحداث في بيئتك وتخصيص استجاباتك لها.

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

يلخص الفيديو التالي إعداد التشغيل السريع:

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

  1. إذا لم يكن لديك حساب Azure، فأنشئ حساباً مجانياً قبل أن تبدأ.

  2. تتم كتابة تطبيقي وحدة التحكم اللذين تقوم بتشغيلهما في هذا التشغيل السريع باستخدام C#. قم بتثبيت .NET Core SDK الإصدار 2.1.403 أو أعلى على جهاز التطوير الخاص بك. إذا كان لديك .NET Core SDK مثبتا، فتحقق من الإصدار الحالي من C# على جهاز التطوير الخاص بك. تشغيل dotnet --version في موجه الأوامر.

  3. قم بتنزيل نموذج مشروع C#‎. استخراج أرشيف digital-twins-samples-csharp-master.zip.

إنشاء مثيل Digital Twins

إنشاء مثيل جديد من Digital Twins في المدخل باتباع الخطوات الواردة في هذا القسم.

  1. تسجيل الدخول إلى ⁧⁩مدخل Microsoft Azure⁧⁩.

  2. حدد الشريط الجانبي للمنزل، ثم + إنشاء مورد.

    قم بتوسيع الشريط الجانبي للمنزل، ثم حدد + Create a resource

  3. ابحث عن Digital Twins، وحدد Digital Twins.

    تحديدات لإنشاء مثيل Digital Twins جديد

    بدلا من ذلك، حدد إنترنت الأشياء، وحدد Digital Twins (معاينة).

  4. حدد Create لبدء عملية التوزيع.

    إنشاء وتأكيد نشر المورد

  5. في جزء Digital Twins ، أدخل المعلومات التالية:

    • اسم المورد: أنشئ اسما فريدا لمثيل Digital Twins الخاص بك.

    • الاشتراك: اختر الاشتراك الذي تريد استخدامه لإنشاء مثيل Digital Twins هذا.

    • مجموعة الموارد: حدد أو أنشئ مجموعة موارد لمثيل Digital Twins.

    • الموقع: حدد أقرب موقع إلى أجهزتك.

      جزء Digital Twins مع المعلومات المدخلة

  6. راجع معلومات Digital Twins، ثم حدد Create. قد يستغرق إنشاء مثيل Digital Twins بضع دقائق. يمكنك مراقبة التقدم في جزء الإعلامات.

  7. افتح جزء Overview لمثيل Digital Twins الخاص بك. لاحظ الارتباط ضمن Management API. تم تنسيق عنوان URL لواجهة برمجة تطبيقات الإدارة على النحو التالي:

    https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/swagger

    ينقلك عنوان URL هذا إلى وثائق Azure Digital Twins REST API التي تنطبق على المثيل الخاص بك. اقرأ كيفية استخدام Azure Digital Twins Swagger لمعرفة كيفية قراءة وثائق واجهة برمجة التطبيقات هذه واستخدامها. انسخ عنوان URL لواجهة برمجة تطبيقات الإدارة وعدله إلى هذا التنسيق:

    https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/

    سيستخدم تطبيقك عنوان URL المعدل كعنون URL أساسي للوصول إلى المثيل الخاص بك. انسخ عنوان URL المعدل هذا إلى ملف مؤقت. ستحتاج إلى هذا في القسم التالي.

    نظرة عامة على واجهة برمجة تطبيقات الإدارة

تعيين أذونات لتطبيقك

يسجل هذا القسم نموذج التطبيق الخاص بك إلى Azure Active Directory (Azure AD) بحيث يمكنه الوصول إلى مثيل Digital Twins الخاص بك. إذا كان لديك بالفعل تسجيل تطبيق Azure AD، فاعيد استخدامه لعينتك. تأكد من تكوينه كما هو موضح في هذا القسم.

ملاحظة

يوفر هذا القسم إرشادات لتسجيل التطبيق Azure AD.

  1. في مدخل Microsoft Azure، افتح Azure Active Directory من القائمة اليسرى القابلة للتوسيع، ثم افتح جزء App registrations .

    حدد جزء Azure Active Directory

  2. حدد زر + تسجيل جديد .

    حدد زر تسجيل جديد

  3. امنح اسما مألوفا لتسجيل هذا التطبيق في مربع الاسم .

    1. ضمن قسم Redirect URI (اختياري)، أدخل https://microsoft.com في مربع النص.

    2. تحقق من الحسابات والمستأجرين المدعومين من قبل تطبيق Azure Active Directory.

    3. اختر ⁧تسجيل⁧.

    إنشاء جزء

  4. تحدد شفرة المصادقة إعدادات تكوين المصادقة المهمة.

    1. أضف عناوين URL لإعادة التوجيه وقم بتكوين رموز Access المميزة عن طريق تحديد + إضافة نظام أساسي.

    2. حدد نعم لتحديد أن التطبيق عميل عام.

    3. تحقق من الحسابات والمستأجرين المدعومين من قبل تطبيق Azure Active Directory.

    إعداد تكوين العميل العام

  5. بعد تحديد النظام الأساسي المناسب، قم بتكوين عناوين URL لإعادة التوجيهورمز الوصول المميز في اللوحة الجانبية إلى يمين واجهة المستخدم.

    1. يجب أن تتطابق عناوين URI لإعادة التوجيه مع العنوان الذي يوفره طلب المصادقة:

      • بالنسبة للتطبيقات المستضافة في بيئة تطوير محلية، حدد العميل العام (المحمول & سطح المكتب). تأكد من تعيين العميل العام إلى نعم.
      • بالنسبة Single-Page التطبيقات المستضافة على Azure App Service، حدد Web.

    2. حدد ما إذا كان عنوان URL لتسجيل الخروج مناسبا أم لا.

    3. قم بتمكين تدفق المنح الضمني عن طريق التحقق من رموز Access المميزة أو رموز المعرف المميزة.

    تكوين عناوين URL لإعادة التوجيه

    انقر فوق تكوين، ثم حفظ.

  6. افتح جزء Overview لتطبيقك المسجل، وانسخ قيم الكيانات التالية إلى ملف مؤقت. ستستخدم هذه القيم لتكوين نموذج التطبيق الخاص بك في الأقسام التالية.

    • مُعرَّف التطبيق (العميل)
    • معرف الدليل (المستأجر)

    معرف تطبيق Azure Active Directory

  7. افتح جزء أذونات واجهة برمجة التطبيقات لتسجيل التطبيق الخاص بك. حدد + إضافة زر إذن . في جزء طلب أذونات واجهة برمجة التطبيقات ، حدد علامة التبويب واجهات برمجة التطبيقات التي تستخدمها مؤسستي ، ثم ابحث عن أحد الإجراءات التالية:

    1. Azure Digital Twins. حدد واجهة برمجة تطبيقات Azure Digital Twins .

      البحث عن واجهة برمجة التطبيقات أو Azure Digital Twins

    2. بدلا من ذلك، ابحث Azure Smart Spaces Serviceعن . حدد واجهة برمجة تطبيقات Azure Smart Spaces Service .

      البحث عن واجهة برمجة التطبيقات لمساحات Azure الذكية

    هام

    يعتمد اسم واجهة برمجة التطبيقات Azure AD والمعرف الذي سيظهر على المستأجر الخاص بك:

    • يجب أن يبحث Azure Digital Twinsاختبار حسابات المستأجر والعملاء عن .
    • يجب أن تبحث Azure Smart Spaces Serviceحسابات Microsoft الأخرى عن .

  8. ستظهر إما واجهة برمجة التطبيقات ك Azure Digital Twins في نفس جزء طلب أذونات واجهة برمجة التطبيقات بمجرد تحديدها. حدد الخيار المنسدلة قراءة ، ثم حدد خانة الاختيار قراءة.كتابة . حدد الزر ⁧⁩Add permissions⁧⁩.

    إضافة أذونات واجهة برمجة التطبيقات

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

    الموافقة مسؤول

    تحقق من ظهور Azure Digital Twins .

بناء التطبيق

أنشئ تطبيق الإشغال باتباع هذه الخطوات.

  1. فتح مطالبة أمر. انتقل إلى المجلد حيث تم استخراج ملفاتك digital-twins-samples-csharp-master.zip .

  2. قم بتشغيل cd occupancy-quickstart/src.

  3. قم بتشغيل dotnet restore.

  4. تحرير appSettings.json لتحديث المتغيرات التالية:

    • ClientId: أدخل معرف التطبيق لتسجيل تطبيق Azure AD، المذكور في القسم السابق.
    • المستأجر: أدخل معرف الدليل لمستأجر Azure AD، كما هو ملاحظ في القسم السابق.
    • BaseUrl: عنوان URL لواجهة برمجة تطبيقات الإدارة لمثيل Digital Twins بالتنسيق https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/. استبدل العناصر النائبة في عنوان URL هذا بقيم المثيل الخاص بك من القسم السابق.

    احفظ الملف المحدث.

رسم بياني للتوفير

توفر هذه الخطوة الرسم البياني المكاني Digital Twins الخاص بك مع:

  • عدة مسافات.
  • جهاز واحد.
  • جهازي استشعار.
  • دالة مخصصة.
  • تعيين دور واحد.

يتم توفير الرسم البياني المكاني باستخدام ملف provisionSample.yaml .

  1. قم بتشغيل dotnet run ProvisionSample.

    ملاحظة

    يتم استخدام أداة تسجيل الدخول إلى الجهاز Azure CLI لمصادقة المستخدم على Azure AD. يجب على المستخدم إدخال رمز معين للمصادقة باستخدام صفحة تسجيل الدخول إلى Microsoft . بعد إدخال التعليمات البرمجية، اتبع الخطوات للمصادقة. يجب على المستخدم المصادقة عند تشغيل الأداة.

    تلميح

    عند تشغيل هذه الخطوة، تأكد من نسخ المتغيرات بشكل صحيح إذا ظهرت رسالة الخطأ التالية: EXIT: Unexpected error: The input is not a valid Base-64 string ...

  2. قد تستغرق خطوة التوفير بضع دقائق. كما يوفر IoT Hub داخل مثيل Digital Twins الخاص بك. يتكرر حتى يعرض IoT Hub Status=Running.

    توفير العينة - Status=Running

  3. في نهاية التنفيذ، انسخ ConnectionString الجهاز للاستخدام في نموذج محاكاة الجهاز. انسخ السلسلة الموضحة في هذه الصورة فقط.

    نسخ سلسلة الاتصال

    تلميح

    يمكنك عرض الرسم البياني المكاني وتعديله باستخدام Azure Digital Twins Graph Viewer.

احتفظ بنافذة وحدة التحكم مفتوحة للاستخدام مرة أخرى لاحقا.

إرسال بيانات المستشعر

قم بإنشاء وتشغيل تطبيق جهاز محاكاة المستشعر باتباع هذه الخطوات.

  1. افتح موجه أوامر جديد. انتقل إلى المشروع الذي قمت بتنزيله في digital-twins-samples-csharp-master المجلد.

  2. قم بتشغيل cd device-connectivity.

  3. قم بتشغيل dotnet restore.

  4. قم بتحرير appsettings.json لتحديث DeviceConnectionString مع السابق ConnectionString. احفظ الملف المحدث.

  5. قم بتشغيل dotnet run لبدء إرسال بيانات أداة الاستشعار. سيتم إرساله إلى Azure Digital Twins كما هو موضح في الصورة التالية.

    اتصال الجهاز

  6. دع هذا المحاكي يعمل بحيث يمكنك عرض النتائج جنبا إلى جنب مع إجراء الخطوة التالية. تعرض لك هذه النافذة بيانات أداة الاستشعار المحاكية المرسلة إلى Digital Twins. تستعلم الخطوة التالية في الوقت الحقيقي عن الغرف المتوفرة مع الهواء النقي.

    تلميح

    عند تشغيل هذه الخطوة، تأكد من DeviceConnectionString نسخها بشكل صحيح إذا ظهرت رسالة الخطأ التالية: EXIT: Unexpected error: The input is not a valid Base-64 string ...

البحث عن المساحات المتوفرة مع الهواء النقي

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

  1. افتح موجه الأوامر الذي استخدمته لتشغيل خطوة التوفير في وقت سابق.

  2. قم بتشغيل ⁧dotnet run GetAvailableAndFreshSpaces⁩.

  3. انظر إلى موجه الأوامر هذا وموجه أمر بيانات المستشعر جنبا إلى جنب.

    يرسل موجه أوامر بيانات المستشعر بيانات الحركة المحاكاة وثاني أكسيد الكربون إلى Digital Twins كل خمس ثوان. يقرأ موجه الأوامر الآخر الرسم البياني في الوقت الحقيقي لمعرفة الغرف المتوفرة مع الهواء النقي استنادا إلى بيانات محاكاة عشوائية. يعرض أحد هذه الشروط في الوقت الفعلي تقريبا استنادا إلى بيانات المستشعر التي تم إرسالها مؤخرا:

    • Room is available and air is fresh

    • Room is not available or air quality is poor

      الحصول على المساحات المتوفرة مع الهواء النقي

لفهم ما حدث في هذا التشغيل السريع وما تم استدعاء واجهات برمجة التطبيقات، افتح Visual Studio Code مع مشروع مساحة عمل التعليمات البرمجية الموجود في digital-twins-samples-csharp. استخدم الأمر التالي:

<path>\occupancy-quickstart\src>code ..\..\digital-twins-samples.code-workspace

تتعمق البرامج التعليمية في التعليمات البرمجية. وهي تعلمك كيفية تعديل بيانات التكوين وما تسمى واجهات برمجة التطبيقات. لمزيد من المعلومات حول واجهات برمجة تطبيقات الإدارة، انتقل إلى صفحة Digital Twins Swagger:

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger
الاسم استبدال بـ
YOUR_INSTANCE_NAME اسم مثيل Digital Twins الخاص بك
YOUR_LOCATION منطقة الخادم حيث تتم استضافة المثيل الخاص بك

أو للراحة، استعرض للوصول إلى Digital Twins Swagger.

تنظيف الموارد

تذهب البرامج التعليمية إلى التفاصيل حول كيفية:

  • إنشاء تطبيق لمديري المرافق لزيادة الإنتاجية الشاغلة.
  • تشغيل المبنى بشكل أكثر كفاءة.

للمتابعة إلى البرامج التعليمية، لا تنظف الموارد التي تم إنشاؤها في هذا التشغيل السريع. إذا كنت لا تخطط للمتابعة، فاحذف جميع الموارد التي تم إنشاؤها بواسطة هذا التشغيل السريع.

  1. احذف المجلد الذي تم إنشاؤه عند تنزيل مستودع العينة.

  2. من القائمة على اليسار في مدخل Microsoft Azure، حدد All resources. ثم حدد مورد Digital Twins. في أعلى جزء All resources ، حدد Delete.

    تلميح

    إذا كنت قد واجهت مشكلة في حذف مثيل Digital Twins الخاص بك، فقد تم طرح تحديث خدمة مع الإصلاح. يرجى إعادة محاولة حذف المثيل الخاص بك.

الخطوات التالية

استخدم هذا التشغيل السريع سيناريو بسيطا وعينة من التطبيقات لإظهار كيفية استخدام Digital Twins للعثور على غرف ذات ظروف عمل جيدة. للتحليل المتعمق لهذا السيناريو، اقرأ هذا البرنامج التعليمي:

البرنامج التعليمي: توزيع Azure Digital Twins وتكوين رسم بياني مكاني