تكوين المراسي المكانية Azure في مشروع وحدة

  • مقالة
  • قراءة خلال 4 دقائق

سيوضح لك هذا الدليل كيفية بدء استخدام Azure Spatial Anchors SDK في مشروع Unity الخاص بك.

متطلبات Project

عند بدء تشغيل مشروع Unity جديد، يمكنك الاختيار بين إطار عمل المكون الإضافي Unity XR وXR القديم المدمج.

يتم دعم إطار عمل المكون الإضافي XR فقط على ASA SDK الإصدار 2.9.0 أو إصدار أحدث. لاستهداف إطار عمل المكون الإضافي XR، استخدم Unity 2020.3 (LTS) وAR Foundation 4.1.7 مع الحزم التالية، وفقا للنظام الأساسي الخاص بك:

  • الواقع المختلط OpenXR البرنامج المساعد: 1.1.2
  • Windows XR البرنامج المساعد: 4.5.0
  • ARCore XR البرنامج المساعد: 4.1.7
  • ARKit XR البرنامج المساعد: 4.1.7

تكوين مشروع

قبل تضمين Azure Spatial Anchors SDK في مشروع Unity الخاص بك، تأكد من تثبيت الحزم المطلوبة من خلال مدير الحِزَم Unity.

اختر إصدار ASA

لتحديد إصدار ASA SDK الذي سيتم استخدامه في مشروع Unity الخاص بك، يرجى تحديد إصدار Unity أدناه.

تمت إضافة دعم Unity 2020 باستخدام ASA SDK 2.9.0. نقترح استخدام أحدث ASA SDK لتطوير Unity 2020.

هام

إذا كنت تستخدم المكون الإضافي OpenXR للواقع المختلط ، فإن ASA SDK 2.10.0 هو الحد الأدنى من الإصدار المدعوم. في حالة استخدام Windows XR 4.5.1 أو إصدار أحدث، فإن ASA SDK 2.11.0 هو الحد الأدنى من الإصدار المدعوم.

تنزيل حزم ASA

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

لاستخدام Azure Spatial Anchors in Unity، تحتاج إلى تنزيل كل من الحزمة الأساسية (com.microsoft.azure.spatial-anchors-sdk.core) وحزمة خاصة بالنظام الأساسي لكل نظام أساسي تخطط لدعمه.

النظام الأساسي أسماء الحزم المطلوبة
HoloLens com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.windows@<version_number>
Android com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.android@<version_number>
iOS com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.ios@<version_number>

ملاحظة

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

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

استيراد حزم ASA

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

  1. اتبع تعليمات وثائق أداة Mixed Reality Feature لإعداد الأداة وتعلم كيفية استخدامها.
  2. تثبيت
    1. Azure Spatial Anchors SDK Core
    2. Azure Spatial Anchors SDK للنظام <الأساسي (المنصات)> الخاص بك
    3. البرنامج المساعد OpenXR للواقع المختلط إذا كنت تستخدم OpenXR - يقع ضمن دعم النظام الأساسي

تكوينات إضافية

إذا كنت تقوم بالتطوير لنظام التشغيل HoloLens أو Android ، فيرجى اتباع خطوات الإعداد الإضافية أدناه

تكوين إعدادات XR لمشروع Unity الخاص بك

عند تطوير تطبيقات MixedReality على HoloLens ، تحتاج إلى تعيين تكوين XR في Unity. لمزيد من المعلومات، راجع إعداد تكوين XR - الواقع المختلط | Microsoft Docsواختيار إصدار Unity والمكون الإضافي XR - الواقع المختلط | Microsoft Docs.

توفر إصدارات Azure Spatial Anchors SDK 2.9.0 أو الإصدارات الأقدم فقط الدعم للمكون الإضافي XR Windows (com.unity.xr.windowsmr) ، وبالتالي فإن حزمة نوافذ Azure Spatial Anchors لها اعتماد صريح على المكون الإضافي XR Windows.

توفر إصدارات Azure Spatial Anchors SDK 2.10.0 أو الإصدارات الأحدث الدعم لكل من المكون الإضافي OpenXR للواقع المختلط (com.microsoft.mixedreality.openxr) والمكون الإضافي com.unity.xr.windowsmrWindows XR . تحتاج إلى تضمين إما الحزمة أو الحزمة com.microsoft.mixedreality.openxrcom.unity.xr.windowsmr في مشروعك اعتمادا على اختيارك.

تكوين قدرات مشروع Unity الخاص بك

تأكد من تمكين الإمكانات التالية في مشروع Unity الخاص بك:

  • SpatialPerception
  • InternetClient
  • PrivateNetworkClientServer

تحذير

قد يؤدي الفشل في تمكين إمكانية PrivateNetworkClientServer إلى فشل في الاستعلام عن المراسي عندما يستخدم الجهاز شبكة تم تكوينها لتكون خاصة.