التشغيل السريع: إنشاء نموذج "Object Anchors" من نموذج ثلاثي الأبعاد

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

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

• إنشاء حساب Object Anchors.
• تحويل نموذج ثلاثي الأبعاد لإنشاء نموذج "Object Anchors" باستخدام Azure Object Anchors Conversion SDK لـ .NET (NuGet).

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

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

• جهاز Windows مع Visual Studio 2022.
• Git لـ Windows.
• .NET 6.0 SDK.

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

إنشاء حساب 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. سوف تحتاجها لاحقًا.

   

الحصول على عينة المشروع

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

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

cd ./azure-object-anchors

تحويل نموذج ثلاثي الأبعاد

الآن، يمكنك المضي قدماً وتحويل النموذج ثلاثي الأبعاد خاصتك.

1. افتح quickstarts/conversion/Conversion.sln في Visual Studio. يحتوي هذا الحل على مشروع وحدة تحكم C#‎.

2. افتح الملف Configuration.cs الموجود في جذر المشروع ثم استبدل القيم set-me الموجودة في الحقول التالية:

   الحقل	‏‏الوصف
   AccountDomain	مجال الحساب لحساب Object Anchors الذي أُنشئ أعلاه.
   AccountId	معرف الحساب لحساب Object Anchors الذي أُنشئ أعلاه.
   AccountKey	المفتاح الأساسي لحساب Object Anchors الذي أُنشئ أعلاه

   هناك أربعة حقول إضافية تحتاج إلى التحقق منها:

   الحقل	‏‏الوصف
   InputAssetPath	المسار المطلق لنموذج ثلاثي الأبعاد على جهازك المحلي. تنسيقات الملفات المدعومة هي fbxو objplyو و.glb
   AssetDimensionUnit	وحدة قياس نموذجك ثلاثي الأبعاد. يمكن الوصول إلى جميع وحدات القياس المعتمدة باستخدام التعداد Azure.MixedReality.ObjectAnchors.Conversion.AssetLengthUnit.
   جاذبية	اتجاه متجه الجاذبية للنموذج ثلاثي الأبعاد. يعطي هذا المتجه ثلاثي الأبعاد اتجاهاً تنازلياً في نظام إحداثيات نموذجك. على سبيل المثال إذا كان السالب y يمثل الاتجاه التنازلي في المساحة ثلاثية الأبعاد للنموذج، ستكون هذه القيمة هي Vector3(0.0f, -1.0f, 0.0f).
   DisableDetectScaleUnits	اعتبارا من Azure.MixedReality.ObjectAnchors.Conversion 0.3.0-beta.6، يتم استخدام وحدات المقياس المضمنة بشكل افتراضي عند توفرها للملفات fbx . يمكن تعطيل هذا السلوك عن طريق تعيين القيمة إلى true. يتم تجاهل هذا الخيار لتنسيقات الملفات بخلاف fbx.

3. بادر بإنشاء وتشغيل المشروع لتحميل نموذجك ثلاثي الأبعاد، وتسجيل مهمة تحويل جديدة مع الخدمة، وانتظار اكتمالها. بمجرد اكتمال المهمة، سيجري تحميل نموذج "Object Anchors" بجوار الملف المحدد في InputAssetPath. يجب أن ترى شيئاً مشابهاً لإخراج وحدة التحكم التالية:

    Asset   : ***********
    Gravity : ***********
    Unit    : ***********
    Attempting to upload asset...
    Attempting to create asset conversion job...
    Successfully created asset conversion job. Job ID: ***********
    Waiting for job completion...
   
    Asset conversion job completed successfully.
    Attempting to download result as '***********'...
    Success!
   

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

4. بمجرد إكمال المهمة بنجاح، يجب أن تشاهد ملفاً بالتنسيق <Model-Filename-Without-Extension>_<JobID>.ou في موقع الإخراج المحدد. على سبيل المثال، إذا كان اسم ملف النموذج ثلاثي الأبعاد خاصتك هو chair.ply ومعرف المهمة خاصتك هو 00000000-0000-0000-0000-000000000000إذ فاسم الملف الذي تخرجه الخدمة سيكون chair_00000000-0000-0000-0000-000000000000.ou.

رموز الخطأ

للحصول على تفاصيل بخصوص تعليمات الخطأ البرمجية المختلفة التي يمكن أن تنتج عن وظيفة تحويل أصل فاشلة وطريقة التعامل مع كلٍ منها، ارجع إلى صفحة تعليمات الخطأ البرمجية الخاصة بالتحويل.

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

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

من قائمة مدخل Microsoft Azure أو من Home، حدد Resource groups. بعد ذلك، في صفحة مجموعات الموارد، حدد "myResourceGroup".

في صفحة myResourceGroup، تأكد من أن الموارد المدرجة هي التي تريد حذفها.

حدد حذف مجموعة الموارد واكتب myResourceGroup في مربع النص للتأكيد، ثم حدد حذف.

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

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

Unity HoloLens

Unity HoloLens with MRTK

HoloLens DirectX

تحويل SDK