التشغيل السريع: إنشاء تطبيق HoloLens باستخدام Azure Object Anchors، في Unity

في هذا التشغيل السريع، ستقوم بإنشاء تطبيق Unity HoloLens يستخدم Azure Object Anchors. Azure Object Anchors هي خدمة سحابية مُدارة تقوم بتحويل الأصول ثلاثية الأبعاد إلى نماذج ذكاء اصطناعي تتيح تجارب الواقع المختلط المدركة للكائنات لـ HoloLens. عند الانتهاء، سيكون لديك تطبيق HoloLens مصمم باستخدام Unity والذي يمكنه اكتشاف الأشياء في العالم المادي.

ستتعلم كيفية:

• قم بإعداد إعدادات بناء Unity .
• تصدير مشروع HoloLens Visual Studio.
• نشر التطبيق وتشغيله على جهاز HoloLens 2.

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

لإكمال هذا التشغيل السريع، تأكد من أن لديك:

• كائن فعلي في البيئة الخاصة بك ونموذجه ثلاثي الأبعاد (إما CAD أو ممسوح ضوئيًّا).
• جهاز Windows مثبت عليه ما يلي:
  • Git for Windows
  • Visual Studio 2019 باستخدام حمل عمل تطوير Universal Windows Platform وعنصر SDK Windows 10 (10.0.18362.0 أو أحدث)
  • Unity 2019.4
• جهاز HoloLens 2 محدث وبه وضع المطوّر ممكّن.
  • للتحديث إلى أحدث إصدار من HoloLens، افتح الإعدادات الخاصة بالتطبيق، وانتقل إلى التحديث والأمان ، ثم حدد تأكد من التحديثات.

إنشاء حساب Object Anchors

أولاً، تحتاج إلى إنشاء حساب مع خدمة Object Anchors.

1. انتقل إلى مدخل Azure، وحدد Create a resource.

   

2. ابحث عن مورد Object Anchors.

   ابحث عن Object Anchors.

   

   في مورد Object Anchors في نتائج البحث، حدد Create -> Object Anchors.

   

3. في مربع الحوار Object Anchors Account:

   • أدخل اسم المورد الفريد.
   • حدد الاشتراك الذي تريد إرفاق المورد به.
   • أنشئ أو استخدم مجموعة موارد موجودة.
   • حدد المنطقة التي تريد أن يتواجد فيها المورد.

   

   حدد Create لبدء إنشاء المورد.

4. بمجرد إنشاء المورد، حدد Go to resource.

   

5. في صفحة النظرة العامة:

   ضع في اعتبارك Account Domain. سوف تحتاجها لاحقًا.

   

   ضع في اعتبارك Account ID. سوف تحتاجها لاحقًا.

   

   انتقل إلى صفحة Access Keys، ودوِّن Primary key. سوف تحتاجها لاحقًا.

   

إعداد جهازك

لنشر التطبيقات على HoloLens، ستحتاج إلى توصيل HoloLens بالكمبيوتر.

1. في HoloLens، انتقل إلى الإعدادات -> التحديث والأمان -> للمطورين.
2. انقر فوق اتصال، واترك الشاشة مفتوحة حتى إدخال رقم التعريف الشخصي في Visual Studio خلال إجراء عملية النشر الأولى.

قم بتحميل النموذج الخاص بك

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

مع تشغيل HoloLens وتوصيله بجهاز التطوير (الكمبيوتر)، اتبع الخطوات التالية لتحميل نموذج إلى مجلد الكائنات ثلاثية الأبعاد على HoloLens:

1. حدد النماذج التي تريد العمل بها وانسخها بالضغط على مفتاح Ctrl وC، معًا (Ctrl + C).

2. اضغط على مفتاح شعار Windows وE معًا (Win + E) لتشغيل مستكشف الملفات. يجب أن ترى HoloLens الخاص بك مدرجًا مع محركات الأقراص والمجلدات الأخرى في الجزء الأيسر.

   

3. انقر على رابط HoloLens لإظهار سعة التخزين على جهاز HoloLens في الجزء الأيمن.

   

4. في مستكشف الملفات، انتقل إلى الكائنات ثلاثية الأبعاد للتخزين > الداخلي. الآن، يمكنك لصق النماذج الخاصة بك في مجلد الكائنات ثلاثية الأبعاد عن طريق الضغط على مفتاح Ctrl وV معا (Ctrl + V).

   

فتح نموذج المشروع

نسخ مستودع العينات بتشغيل الأوامر التالية:

git clone https://github.com/Azure/azure-object-anchors.git

cd ./azure-object-anchors

الخطوة التالية هي تنزيل حزم "Azure Object Anchors" للوحدة.

تنزيل الويب

حدد موقع حزمة "Azure Object Anchors" للوحدة (com.microsoft.azure.object-anchors.runtime) هنا. حدد الإصدار الذي تريده وقم بتنزيل الحزمة باستخدام الزر تنزيل.

تنزيل NPM

تتطلب هذه الخطوة تثبيت NPM وتوفيرها.

تشغيل الأمر التالي يستبدل <version_number> بإصدار "Azure Object Anchors" الذي تريد تنزيله:

npm pack com.microsoft.azure.object-anchors.runtime@<version_number> --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/

إشعار

لإدراج الإصدارات المتوفرة من حزمة "Azure Object Anchors"، قم بتشغيل ما يلي:

npm view com.microsoft.azure.object-anchors.runtime --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/ versions

سيتم تنزيل حزمة "Azure Object Anchors" في المجلد حيث قمت بتشغيل الأمر.

أداة Mixed Reality Feature

تابع إلى الخطوة التالية. ستستخدم أداة "Mixed Reality Feature Tool" في خطوة لاحقة.

في Unity، افتح quickstarts/apps/unity/basic المشروع.

تنزيل الويب

اتبع الإرشادات الواردة هنا لاستيراد حزمة Azure Object Anchors التي قمت بتنزيلها في مشروع Unity باستخدام مدير الحِزم Unity Package Manager.

تنزيل NPM

اتبع الإرشادات الواردة هنا لاستيراد حزمة Azure Object Anchors التي قمت بتنزيلها في مشروع Unity باستخدام مدير الحِزم Unity Package Manager.

أداة Mixed Reality Feature

تتطلب هذه الخطوة تنزيل أداة Mixed Reality Feature وتوفرها.

إشعار

أداة Mixed Reality Feature لا تدعمْ حاليًا سوى أنظمة Windows.

1. اتبع تعليمات وثائق أداة Mixed Reality Feature لإعداد الأداة وتعلم كيفية استخدامها.
2. قم بتثبيت حزمة مزايا Microsoft Azure Object Anchors في مجلد مشروع Unity.

تكوين معلومات الحساب

الخطوة التالية هي تكوين التطبيق لاستخدام معلومات حسابك. لقد لاحظت قيم مفتاح الحساب ومعرف الحساب ونطاق الحساب، في قسم "Create an Object Anchors account".

في جزء المشروع، انتقل إلى Assets\AzureObjectAnchors.SDK\Resources.

حدد ObjectAnchorsConfig. في جزء Inspector، أدخل Account Key القيمة لـ Object Anchors Account Key، وأيضًا Account ID القيمة لـ Object Anchors Account Id، وأخيرًا Account Domain القيمة لـ Object Anchors Account Domain.

إنشاء وتشغيل التطبيق

إنشاء نموذج التعليمات البرمجية.

في محرر الوحدة، انتقل إلى الأصول/MixedReality.AzureObjectAnchors/Scenes، وافتح AOASampleScene، وأضفه إلى قائمة إنشاء المشهد.

حدد ملف -> إنشاء الإعدادات. حدد "Universal Windows Platform" ثم حدد "Switch Platform". إذا ظهرت رسالة من Unity Editor تُفيد بأنك بحاجة إلى تنزيل بعض المكونات أولاً، فقم بتنزيلها وتثبيتها. اتبع لقطة الشاشة التالية لتكوين إعدادات البناء. تأكد من أن AOASampleScene فقطلديه علامة اختيار بجواره: لا ينبغي تضمين جميع المشاهد الأخرى.

حدد "Build" ثم حدد مجلد إخراج. يمكنك الآن إنشاء مشروع VS في مجلد الإخراج.

إنشاء التطبيقات ونشرها

افتح الملف الذي .sln تم إنشاؤه بواسطة Unity. قم بتغيير تكوين البناء إلى ما يلي.

بعد ذلك، ستحتاج إلى تكوين عنوان IP للجهاز البعيد لنشر التطبيق وتصحيحه.

انقر بزر الماوس الأيمن فوق مشروع التطبيق وحدد خصائص. في صفحة الخصائص، حدد خصائص التكوين -> تصحيح الأخطاء. قم بتغيير قيمة اسم الجهاز إلى عنوان IP لجهاز HoloLens وانقر فوق تطبيق.

أغلق صفحة الخاصية. انقر فوق Remote Machine. يجب أن يبدأ التطبيق في الإنشاء والنشر على جهازك البعيد. تأكد من أن جهازك نشط.

بعد شاشة Unity، سترى رسالة تشير إلى أنه قد تمت تهيئة مراقب الكائن.

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

استكشاف الأخطاء وإصلاحها

تلميحات

إذا لم يتم الكشف عن الكائن، يمكنك تجربة الخطوات التالية:

1. تحقق مرة أخرى من أنك تستخدم النموذج الصحيح للكائن.
2. عرض منطقة البحث والتأكد من أنها تغطي الكائن الهدف.
3. حاول تقليل MinSurfaceCoverage .
4. في مدخل جهاز Windows، انقر فوق طرق العرض -> طرق العرض ثلاثية الأبعاد، وتحقق مما إذا كان الفحص قد اكتمل.

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

Unity HoloLens with MRTK

المفاهيم: نظرة عامة على SDK

الأسئلة المتداولة

تحويل SDK

استكشاف أخطاء الكشف عن الكائنات وإصلاحها