Share via

البدء السريع: نشر نموذج C++ WMR الأصلي في HoloLens

  • مقالة

يغطي هذا التشغيل السريع كيفية نشر وتشغيل تطبيق البرنامج التعليمي الأصلي C++ Windows Mixed Reality (WMR) على HoloLens 2.

في هذا التشغيل السريع، ستتعلم كيفية:

  • بناء التطبيق التعليمي HoloLens.
  • تغيير بيانات اعتماد Azure Remote Rendering في التعليمات البرمجية المصدر.
  • توزيع النموذج وتشغيله على الجهاز.

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

للوصول إلى خدمة Remote Rendering، تحتاج أولا إلى إنشاء حساب.

يجب تثبيت البرنامج التالي:

استنساخ مستودع عينات العرض عن بعد

كخطوة أولى، انسخ مستودع Git، الذي يضم عينات Azure Remote Rendering العالمية. اكتب cmd في قائمة البدء في Windows لفتح نافذة موجه الأوامر. قم بالتغيير إلى دليل حيث تريد تخزين نموذج مشروع ARR.

شغّل الأوامر التالية:

mkdir ARR
cd ARR
git clone https://github.com/Azure/azure-remote-rendering

ينشئ الأمر الأخير مجلدا في مجلد ARR يحتوي على نماذج المشاريع المختلفة ل Azure Remote Rendering.

يمكن العثور على البرنامج التعليمي C++ HoloLens في المجلد NativeCpp/HoloLens-Wmr.

إنشاء المشروع

افتح ملف الحل HolographicApp.sln الموجود في المجلد NativeCpp/HoloLens-Wmr باستخدام Visual Studio.

بدّل تكوين البنية إلى ⁧⁩Debug⁧⁩ (أو ⁧⁩Release⁧⁩) و⁧⁩ARM64⁧⁩. تأكد من تعيين وضع مصحح الأخطاء إلى الجهاز بدلا من الجهاز البعيد:

تظهر لقطة الشاشة منطقة تكوين Visual Studio مع القيم كما هو موضح.

نظرًا إلى أن بيانات اعتماد الحساب مشفرة في التعليمة البرمجية المصدر الخاصة بالدليل التعليمي، يجب تغييرها إلى بيانات اعتماد صالحة. افتح الملف HolographicAppMain.cpp داخل Visual Studio وغير الجزء حيث يتم إنشاء العميل داخل الدالة الإنشائية للفئة HolographicAppMain:

// 2. Create Client
{
    // Users need to fill out the following with their account data and model
    RR::SessionConfiguration init;
    init.AccountId = "00000000-0000-0000-0000-000000000000";
    init.AccountKey = "<account key>";
    init.RemoteRenderingDomain = "westus2.mixedreality.azure.com"; // <change to the region that the rendering session should be created in>
    init.AccountDomain = "westus2.mixedreality.azure.com"; // <change to the region the account was created in>
    m_modelURI = "builtin://Engine";
    m_sessionOverride = ""; // If there is a valid session ID to re-use, put it here. Otherwise a new one is created
    m_client = RR::ApiHandle(RR::RemoteRenderingClient(init));
}

وبوجه خاص، غير القيم التالية:

  • ⁧init.AccountId⁩، و⁧init.AccountKey⁩، و⁧init.AccountDomain⁩ لاستخدام بيانات حسابك. راجع القسم حول كيفية استرداد معلومات الحساب.
  • حدد مكان إنشاء جلسة العرض عن بُعد عن طريق تعديل جزء المنطقة للسلسلة ⁧init.RemoteRenderingDomain⁩لمناطق ⁧⁩ الأخرى⁧⁩، بخلاف ⁧westus2⁩، على سبيل المثال ⁧"westeurope.mixedreality.azure.com"⁩.
  • بالإضافة إلى ذلك، يمكن تغيير ⁧m_sessionOverride⁩ إلى معرف جلسة موجود. يمكن إنشاء جلسات العمل خارج هذه العينة. لمزيد من المعلومات، راجع RenderingSession.ps1 أو استخدام واجهة برمجة تطبيقات REST لإدارة الجلسة مباشرة.

من الأفضل إنشاء جلسة عمل خارج النموذج عند ضرورة تشغيل النموذج عدة مرات. إذا لم يتم تمرير جلسة عمل، يقوم النموذج بإنشاء جلسة عمل عند كل بدء تشغيل، والتي قد تستغرق عدة دقائق.

الآن يمكنك تحويل التطبيق برمجيا.

تشغيل التطبيق

  1. صِل HoloLens باستخدام كابل USB بجهاز الكمبيوتر الخاص بك.
  2. شغل HoloLens، وانتظر حتى تظهر قائمة البدء.
  3. ابدأ تشغيل المصحح في Visual Studio (F5). يقوم تلقائيا بتوزيع التطبيق على الجهاز.

يتم تشغيل نموذج التطبيق وتظهر لوحة نصية تعلمك بحالة التطبيق الحالية. تكون الحالة في وقت بدء التشغيل إما بدء جلسة عمل جديدة أو الاتصال بجلسة عمل موجودة. بعد انتهاء تحميل النموذج، يظهر نموذج المحرك المضمن مباشرة في موضع رأسك. من جانب الانسداد، يتفاعل نموذج المحرك بشكل صحيح مع المكعب الدوار الذي يتم عرضه محليًّا.

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

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

يستند هذا البدء السريع إلى نتيجة برنامج تعليمي يشرح كيفية دمج جميع القطع ذات الصلة بالعرض عن بُعد في Holographic App للمخزون. لمعرفة الخطوات الضرورية، اتبع هذا البرنامج التعليمي:

البرنامج التعليمي: دمج Remote Rendering في HoloLens Holographic App