البرنامج التعليمي: مشاركة نقاط الارتساء المكانية عبر الجلسات والأجهزة

Azure Spatial Anchors هي خدمة مطور عبر الأنظمة الأساسية يمكنك من خلالها إنشاء تجارب واقع مختلط باستخدام الكائنات التي تستمر في موقعها عبر الأجهزة بمرور الوقت.

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

ستتعلم في هذه البرنامج التعليمي كيفية:

• توزيع تطبيق ويب ASP.NET Core في Azure حيث يمكنك استخدامه لمشاركة نقاط الارتساء وتخزينها في الذاكرة لفترة زمنية محددة.
• تكوين مشهد AzureSpatialAnchorsLocalSharedDemo ضمن نموذج Unity من التشغيل السريع للاستفادة من تطبيق الويب Sharing Anchors.
• توزيع نقاط الارتساء وتشغيلها إلى جهاز واحد أو أكثر.

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

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

قبل البدء في هذا البرنامج التعليمي، تأكد من أنك قد استوفيت المتطلبات الأساسية التالية:

• يُرجى الاطلاع على نظرة عامة على Azure Spatial Anchors .
• إنجاز أحد قوالب التشغيل السريع لمدة 5 دقائق.

  إشعار

  لا يعرض التشغيل السريع لـ Android/ NDK وiOS/ Swift حالياً القدرات الموضحة في هذا البرنامج التعليمي.

• معرفة أساسية بأي مما يلي:
  • ARCore إذا كنت تستخدم Android.
  • ARKit إذا كنت تستخدم iOS.
• حاسوب Windows مع نسخة Visual Studio 2019 أو نسخة أحدث، وحمل عمل تطوير ASP.NET وشبكة الإنترنت.
• .NET Core 3.1 SDK.
• واحد أو أكثر من الأجهزة التالية لنشر وتشغيل التطبيق من عليها: HoloLens أو HoloLens 2، أو iOS أو Android.

إشعار

ستتمكن من استخدام Unity وتطبيق ويب ASP.NET Core في هذا البرنامج التعليمي، ولكن النهج هنا هو تقديم مثال على كيفية مشاركة معرفات Azure Spatial Anchors عبر الأجهزة الأخرى. يمكنك استخدام لغات أخرى وتقنيات الخلفية لتحقيق نفس الهدف.

إنشاء مورد Spatial Anchors

المدخل

انتقل إلى مدخل Azure.

في الجزء الأيسر، حدد Create a resource.

استخدم مربع البحث للبحث عن Spatial Anchors.

حدد Spatial Anchors، ثم حدد Create.

في جزء Spatial Anchors Account قم بتنفيذ ما يلي:

• أدخل اسماً فريداً للمورد باستخدام أحرف أبجدية رقمية عادية.

• قم بتحديد الاشتراك الذي تريد إرفاق المورد به.

• إنشاء مجموعة الموارد عن طريق تحديد Create new. قم بتسميتها myResourceGroup، ثم حدد OK.

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

• قم بتحديد موقع (منطقة) لوضع المورد فيه.

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

بعد إنشاء المورد، يظهر مدخل Microsoft Azure اكتمال عملية النشر.

حدِّد الانتقال إلى المورد. يمكنك الآن أن تعرض خصائص المورد.

نسخ قيمة Account ID للمورد إلى محرر النص لاستخدامها لاحقا.

أيضاً قم بنسخ قيمة Account Domain للمورد إلى محرر النص لاستخدامها لاحقا.

ضمن "Settings"، حددAccess key. نسخ قيمتي Primary key وAccount Key إلى محرر النص لاستخدامهما لاحقا.

Azure CLI

بدء إعداد البيئة الخاصة بك لـ Azure CLI:

• استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع التشغيل السريع ل Bash في Azure Cloud Shell.

  

• إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.

  • إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.

  • عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات بشأن الامتدادات، راجع استخدام امتدادات مع Azure CLI.

  • يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.

1. بعد تسجيل الدخول، استخدم الأمر az account set لتحديد الاشتراك الذي لإعداد حساب spatial anchors:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. شغّل الأمر az group create لإنشاء مجموعة موارد أو استخدام مجموعة موارد موجودة:

   az group create --name myResourceGroup --location eastus2
   

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

   يمكنك عرض حسابات spatial anchors الحالية لمجموعة الموارد باستخدام الأمر az spatial-anchors-account list:

   az spatial-anchors-account list --resource-group myResourceGroup
   

   يمكنك أيضا عرض حسابات spatial anchors المرتبطة باشتراكك:

   az spatial-anchors-account list
   

3. تشغيل الأمر az spatial-anchors-account create لإنشاء حساب spatial anchors الخاص بك:

   az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2
   

4. عرض خصائص المورد باستخدام الأمر az spatial-anchors-account show:

   az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   نسخ قيمة Account ID المورد وقيمة مجال Account Domain المورد إلى محرر نص لاستخدامها لاحقا.

5. تشغيل الأمر az spatial-anchors-account key show للحصول على المفاتيح الرئيسية والثانوية الخاصة بك:

   az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   نسخ القيم الأساسية في محرر النص لاستخدامها لاحقا.

   إذا كنت بحاجة إلى إعادة إنشاء مفاتيح، استخدم الأمر az spatial-anchors-account key renew:

   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary
   

يمكنك حذف حساب باستخدام الأمر az spatial-anchors-account delete:

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Azure PowerShell

ابدأ بإعداد بيئة Azure PowerShell الخاصة بك:

• إذا اخترت استخدام Azure PowerShell محليا:
  • تثبيت أحدث إصدار من الوحدة النمطية Az PowerShell.
  • اتصل بحساب Azure الخاص بك باستخدامConnect-AzAccount cmdlet.
• إذا اخترت استخدام Azure Cloud Shell:
  • لمزيد من المعلومات، راجع نظرة عامة على Azure Cloud Shell.

هام

أثناء معاينة الوحدة النمطية Az.MixedReality PowerShell، يجب تثبيتها بشكلٍ منفصل باستخدام Install-Module cmdlet. بعد أن تصبح وحدة PowerShell هذه متاحة بشكل عام، ستكون جزءًا من إصدارات وحدة Az PowerShell المستقبلية وستتوفر افتراضيًا من داخل Azure Cloud Shell.

Install-Module -Name Az.MixedReality

1. بعد تسجيل الدخول، استخدم الأمر Set-AzContext لتحديد الاشتراك الذي لإعداد حساب spatial anchors:

   Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
   

2. قم بتشغيل الأمرcmdlet New-AzResourceGroup لإنشاء مجموعة موارد، أو استخدام مجموعة موارد موجودة:

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

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

   يمكنك عرض حسابات spatial anchors الحالية لمجموعة الموارد باستخدام الأمر Get-AzSpatialAnchorsAccount cmdlet:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   يمكنك أيضا عرض حسابات spatial anchors المرتبطة باشتراكك:

   Get-AzSpatialAnchorsAccount
   

3. قم بتشغيل الأمر New-AzSpatialAnchorsAccount لإنشاء حساب spatial anchors:

   New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2
   

4. عرض خصائص المورد باستخدام الأمر Get-AzSpatialAnchorsAccount:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   انسخ قيمة الخاصية accountId وقيمة الخاصية accountDomain في محرر نصوص لاستخدامها لاحقاً.

5. تشغيل الأمر Get-AzSpatialAnchorsAccountKey للحصول على المفاتيح الرئيسية والثانوية الخاصة بك:

   Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   نسخ القيم الأساسية في محرر النص لاستخدامها لاحقا.

   إذا كنت بحاجة إلى إعادة إنشاء المفاتيح، استخدم الأمر New-AzSpatialAnchorsAccountKey:

   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary
   

يمكنك حذف حساب باستخدام الأمر Remove-AzSpatialAnchorsAccount:

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

تنزيل نموذج المشروع + استيراد SDK

استنساخ مستودع العينات

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

git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples

استيراد ASA SDK

اتبع الإرشادات "here" لتنزيل واستيراد حزم ASA SDK المطلوبة لمنصة HoloLens.

توزيع خدمة Sharing Anchors

إشعار

في هذا البرنامج التعليمي، سنستخدم المستوى المجاني من Azure App Service. سيتم انتهاء مهلة المستوى المجاني بعد 20 دقيقة من عدم النشاط وإعادة تعيين ذاكرة التخزين المؤقت للذاكرة.

Visual Studio

افتح Visual Studio، ثم افتح المشروع في المجلد Sharing\SharingServiceSample.

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

في مستكشف الحلول، انقر بزر الماوس الأيمن فوق مشروع SharingService، ثم حدد Publish....

يبدأ معالج النشر عمله.

1. حدد Target Azure>Next.
2. حدد Specific Target Azure App Service (Windows)>Next
3. قم بتسجيل الدخول إلى بوابة Azure.
4. حدد الأخضر "+" لإنشاء Azure App Service

الإعدادات App Service

الإعدادات	القيمة المقترحة	‏‏الوصف‬
الاسم	myASASharingService	امنح الخدمة اسما فريدا
اسم الاشتراك		حدد اشتراك Azure المفضل لديك
مجموعة الموارد	myResourceGroup أو حدد مجموعة موجودة	مجموعة الموارد هي حاوية منطقية يتم فيها نشر موارد Azure وإدارتها، مثل تطبيقات الويب وقواعد البيانات وحسابات التخزين. على سبيل المثال، يمكنك اختيار حذف مجموعة الموارد بأكملها في خطوة واحدة بسيطة لاحقاً.
خطة الاستضافة	حدد جديد... وشاهد الجدول أدناه	تحددخطة خدمة تطبيقاتموقع مزرعة خوادم الويب التي تستضيف تطبيقك، وحجمها، ومزاياها. يمكنك توفير المال عند استضافة تطبيقات متعددة عن طريق تكوين تطبيقات الويب لمشاركة خطة App Service واحدة. تحدد خطط App Service ما يلي: منطقة (على سبيل المثال: شمال أوروبا أو شرق الولايات المتحدة أو جنوب شرق آسيا) حجم العنصر المثيل (صغير أو متوسط أو كبير) حجم المقياس (1 إلى 20 مثيلًا) SKU (مجاني أو مشترك أو أساسي أو قياسي أو متميز)

الإعدادات خطة الاستضافة

الإعدادات	القيمة المقترحة	‏‏الوصف
خطة الاستضافة	MySharingServicePlan	امنح خطة الاستضافة اسما فريدا
الموقع	غرب الولايات المتحدة	مركز البيانات حيث تتم استضافة تطبيق الويب اختر موقعا أقرب إلى الموقع الفعلي الذي سيتم استخدام تطبيقك فيه
الحجم	مجاني	إن مستوى التسعير هو ما يحدد ميزات الاستضافة

5. حدد Create لإنشاء App Service
6. بمجرد إنشاء خدمة التطبيق، حددها في قائمة "مثيلات خدمة التطبيقات" وحدد إنهاء
7. في علامة التبويب SharingService: Publish حدد Publish

بمجرد نشر تطبيق ويب ASP.NET Core إلى Azure، يمكنك الانتقال إلى https://<your_app_name>.azurewebsites.net الارتباط الموجود بجانب الموقع أو النقر فوقه: في علامة التبويب SharingService: Publish . انسخ عنوان URL هذا إلى محرر نص لاستخدامه لاحقا.

Visual Studio Code

يجب عليك إنشاء مجموعة موارد وخطة App Service قبل توزيع الخدمة في برمجية Visual Studio.

تسجيل الدخول إلى Azure

انتقل إلى مدخل Azure، ثم قم بتسجيل الدخول إلى اشتراك Azure.

إنشاء مجموعة موارد

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

بجوار Resource Group، حدد New.

قم بتسمية مجموعة الموارد myResourceGroup، ثم حدد OK.

إنشاء خطة App Service

تحددخطة خدمة تطبيقاتموقع مزرعة خوادم الويب التي تستضيف تطبيقك، وحجمها، ومزاياها. يمكنك توفير المال عند استضافة عدة تطبيقات بتكوين تطبيقات الويب لمشاركة خطة خدمة تطبيقات واحدة.

تُعرف خطة خدمة تطبيقات:

• منطقة (على سبيل المثال: شمال أوروبا أو شرق الولايات المتحدة أو جنوب شرق آسيا)
• حجم العنصر المثيل (صغير أو متوسط أو كبير)
• حجم المقياس (1 إلى 20 مثيلًا)
• SKU (مجاني أو مشترك أو أساسي أو قياسي أو متميز)

بجوار Hosting Plan، حدد New.

في جزء تكوين خطة Hosting، استخدم هذه الإعدادات:

الإعدادات	القيمة المقترحة	‏‏الوصف
خطة App Service	MySharingServicePlan	اسم خطة خدمة التطبيق
الموقع	غرب الولايات المتحدة	مركز البيانات حيث تتم استضافة تطبيق الويب
الحجم	مجاني	إن مستوى التسعير هو ما يحدد ميزات الاستضافة

حدد موافق.

افتح برمجية Visual Studio، ثم افتح المشروع من مجلد Sharing\SharingServiceSample.

لتوزيع خدمة المشاركة من خلال برمجية Visual Studio، اتبع الإرشادات الموجودة في توزيع تطبيق ASP.NET Core على Azure باستخدام Visual Studio Code. ابدأ في قسم "الفتح باستخدام Visual Studio Code". لا تقم بإنشاء مشروع ASP.NET آخر كما هو موضح في الخطوة السابقة، لأن لديك بالفعل مشروعًا ليتم توزيعه ونشره:SharingServiceSample.

تكوين + توزيع نموذج التطبيق

Unity - HoloLens

فتح المشروع

في الوحدة، افتح المشروع في مجلد Unity. قد يطالبك Unity بالفرق بين الإصدار في المشروع والإصدار المثبت على جهازك. هذا التحذير مقبول، طالما أن إصدار Unity Editor الخاص بك أحدث من الإصدار الذي تم إنشاء المشروع به. إذا كان إصدارك أحدث، فحدد Continue. أما إذا كان إصدارك أقدم من الإصدار الذي يحتاجه المشروع، فحدد Quit، وقم بترقية محرر Unity Editor لديك.

الإعدادات إنشاء الإعداد

افتح إعدادات البناء عن طريق تحديد إعدادات> إنشاء الملف.

في قسم "Platform"، حدد "Universal Windows Platform". قم بتغيير "Target Device" إلى "HoloLens".

حدد "Switch Platform" لتغيير النظام الأساسي إلى "Universal Windows Platform". قد تطالبك الوحدة بتثبيت مكونات دعم UWP إذا كانت مفقودة.

أغلقنافذة إعدادات البناء.

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

الخطوة التالية هي تكوين التطبيق لاستخدام معلومات حسابك. قمت بنسخ قيم مفتاح الحساب،معرف الحساب ID، وقيم نطاق الحساب إلى محرر نصوص في وقت سابق، في قسم "إنشاء مورد روابط مكانية".

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

حدد SpatialAnchorConfig. في جزء المفتش، أدخل Account Key كقيمة مفتاح حساب الروابط المكانية، وAccount ID كقيمة معرف حساب الروابط المكانية، وAccount Domainكقيمة نطاق حساب الروابط المكانية.

افتح المشهد المسمى AzureSpatialAnchorsLocalSharedDemo الموجود في Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo بالنقر المزدوج فوقه في جزء المشروع

في جزء Project، انتقل إلى Assets\AzureSpatialAnchors.Examples\Resources.

حدد SpatialAnchorSamplesConfig. بعد ذلك، في جزء Inspector ، أدخل Sharing Anchors Service عنوان URL (من نشر Azure لتطبيق الويب ASP.NET) كقيمة ل Base Sharing Url. ألحق عنوان URL ب /swagger/api/anchors. يجب أن يبدو كما يلي: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

احفظ المشهد عن طريق تحديد File>Save.

تصدير + نشر تطبيق HoloLens

افتح إعدادات البناء عن طريق تحديد إعدادات> إنشاء الملف.

ضمن Scenes In Build، تأكد من وجود علامة اختيار بجانب جميع المشاهد.

حدد إنشاء. في مربع الحوار، حدد مجلداً لتصدير مشروع HoloLens Visual Studio فيه.

عند اكتمال التصدير، سيظهر مجلد يحتوي على مشروع HoloLens المُصدَّر.

في المجلد، انقر نقراً مزدوجاً فوق HelloAR U3D.sln لفتح المشروع في Visual Studio.

غيّر "Solution Configuration" إلى "Release"، وقم بتغيير "Solution Platform" إلى x86، وحدد "Device" من النشر خيارات الهدف.

إذا كنت تستخدم HoloLens 2، فاستخدم ARM64كنظام حل أساسي،بدلاً من x86.

قم بتشغيل جهاز HoloLens وتسجيل الدخول وتوصيل الجهاز بجهاز الكمبيوتر باستخدام كابل USB.

حدد "Debug"> بدء التصحيح لنشر تطبيقك وبدء التصحيح.

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

في التطبيق، حدد LocalSharedDemo باستخدام الأسهم، ثم اضغط على الزر Go! لتشغيل العرض التوضيحي. اتبع التعليمات لوضع المرساة واستدعائها.

باستخدام Create &Share Anchor، يمكنك إنشاء ارتساء وحفظه في خدمة المشاركة. في المقابل، ستحصل على معرّف له يمكنك استخدامه لاسترداده من خدمة المشاركة. يمكنك بعد ذلك تشغيل السيناريو الثاني، تحديد موقع الارتساء المشترك، إما من جهازك أو من جهاز آخر.

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

Unity - Android

فتح المشروع

في الوحدة، افتح المشروع في مجلد Unity. قد يطالبك Unity بالفرق بين الإصدار في المشروع والإصدار المثبت على جهازك. هذا التحذير مقبول، طالما أن إصدار Unity Editor الخاص بك أحدث من الإصدار الذي تم إنشاء المشروع به. إذا كان إصدارك أحدث، فحدد Continue. أما إذا كان إصدارك أقدم من الإصدار الذي يحتاجه المشروع، فحدد Quit، وقم بترقية محرر Unity Editor لديك.

الإعدادات إنشاء الإعداد

افتح إعدادات البناء عن طريق تحديد إعدادات> إنشاء الملف.

في قسم النظام الأساسي ، حدد Android، ثم حدد تبديل النظام الأساسي لتغيير النظام الأساسي إلى Android. قد تطالبك الوحدة بتثبيت مكونات دعم Android إذا كانت مفقودة.

أغلقنافذة إعدادات البناء.

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

الخطوة التالية هي تكوين التطبيق لاستخدام معلومات حسابك. قمت بنسخ قيم مفتاح الحساب،معرف الحساب ID، وقيم نطاق الحساب إلى محرر نصوص في وقت سابق، في قسم "إنشاء مورد روابط مكانية".

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

حدد SpatialAnchorConfig. في جزء المفتش، أدخل Account Key كقيمة مفتاح حساب الروابط المكانية، وAccount ID كقيمة معرف حساب الروابط المكانية، وAccount Domainكقيمة نطاق حساب الروابط المكانية.

افتح المشهد المسمى AzureSpatialAnchorsLocalSharedDemo الموجود في Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo بالنقر المزدوج فوقه في جزء المشروع

في جزء Project، انتقل إلى Assets\AzureSpatialAnchors.Examples\Resources.

حدد SpatialAnchorSamplesConfig. بعد ذلك، في جزء Inspector ، أدخل Sharing Anchors Service عنوان URL (من نشر Azure لتطبيق الويب ASP.NET) كقيمة ل Base Sharing Url. ألحق عنوان URL ب /swagger/api/anchors. يجب أن يبدو كما يلي: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

احفظ المشهد عن طريق تحديد File>Save.

نشر

قم بتسجيل الدخول إلى جهاز Android الخاص بك، وقم بتوصيله بجهاز الكمبيوتر الخاص بك باستخدام كابل USB.

افتح إعدادات البناء عن طريق تحديد إعدادات> إنشاء الملف.

ضمن Scenes In Build، تأكد من أن كل مشهد يحتوي على علامة اختيار بجواره.

تأكد من أن Export Project لا يحتوي على علامة اختيار. حدد إنشاء وتشغيل. ستتم مطالبتك بحفظ ملف .apk . يمكنك اختيار أي اسم لها.

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

في التطبيق، حدد العرض التوضيحي LocalShare باستخدام الأسهم، ثم اضغط على الزر Go! لتشغيل العرض التوضيحي. اتبع التعليمات لوضع المرساة واستدعائها.

باستخدام Create &Share Anchor، يمكنك إنشاء ارتساء وحفظه في خدمة المشاركة. في المقابل، ستحصل على معرّف له يمكنك استخدامه لاسترداده من خدمة المشاركة. يمكنك بعد ذلك تشغيل السيناريو الثاني، تحديد موقع الارتساء المشترك، إما من جهازك أو من جهاز آخر.

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

Unity - iOS

فتح المشروع

في الوحدة، افتح المشروع في مجلد Unity. قد يطالبك Unity بالفرق بين الإصدار في المشروع والإصدار المثبت على جهازك. هذا التحذير مقبول، طالما أن إصدار Unity Editor الخاص بك أحدث من الإصدار الذي تم إنشاء المشروع به. إذا كان إصدارك أحدث، فحدد Continue. أما إذا كان إصدارك أقدم من الإصدار الذي يحتاجه المشروع، فحدد Quit، وقم بترقية محرر Unity Editor لديك.

الإعدادات إنشاء الإعداد

افتح إعدادات البناء عن طريق تحديد إعدادات> إنشاء الملف.

فيقسمالمنصة، حددiOS.

حدد تبديل المنصة لتغيير المنصة إلىiOS. قد يدفعك Unity لتثبيت مكونات دعم iOS إذا كانت مفقودة.

أغلقنافذة إعدادات البناء.

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

الخطوة التالية هي تكوين التطبيق لاستخدام معلومات حسابك. قمت بنسخ قيم مفتاح الحساب،معرف الحساب ID، وقيم نطاق الحساب إلى محرر نصوص في وقت سابق، في قسم "إنشاء مورد روابط مكانية".

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

حدد SpatialAnchorConfig. في جزء المفتش، أدخل Account Key كقيمة مفتاح حساب الروابط المكانية، وAccount ID كقيمة معرف حساب الروابط المكانية، وAccount Domainكقيمة نطاق حساب الروابط المكانية.

افتح المشهد المسمى AzureSpatialAnchorsLocalSharedDemo الموجود في Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo بالنقر المزدوج فوقه في جزء المشروع

في جزء Project، انتقل إلى Assets\AzureSpatialAnchors.Examples\Resources.

حدد SpatialAnchorSamplesConfig. بعد ذلك، في جزء Inspector ، أدخل Sharing Anchors Service عنوان URL (من نشر Azure لتطبيق الويب ASP.NET) كقيمة ل Base Sharing Url. ألحق عنوان URL ب /swagger/api/anchors. يجب أن يبدو كما يلي: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

احفظ المشهد عن طريق تحديد File>Save.

التوزيع على جهاز iOS

افتح إعدادات البناء عن طريق تحديد إعدادات> إنشاء الملف.

ضمن Scenes In Build، تأكد من أن كل مشهد يحتوي على علامة اختيار بجواره.

حدد إنشاء. في الجزء الذي يفتح، حدد مجلدًا لتصدير مشروع Xcode إليه.

عند اكتمال التصدير، يظهر مجلد يحتوي على مشروع Xcode المُصدَّر.

إشعار

إذا ظهرت نافذة مع رسالة تسألك عما إذا كنت تريد الاستبدال أو الإلحاق، فإننا نوصي بتحديد Append، لأنه أسرع. سيؤدي استبدال إلى إزالة كافة الملفات من المجلد الهدف وإنشاء محتوى جديد.

فتح مشروع Xcode

الآن يمكنك فتح المشروع Unity-iPhone.xcodeproj في Xcode.

يمكنك إما تشغيل Xcode وفتح المشروع Unity-iPhone.xcodeproj المُصدّر أو تشغيل المشروع في Xcode بواسطة تشغيل الأمر التالي من الموقع حيث قمت بتصدير المشروع:

open ./Unity-iPhone.xcodeproj

حدد العقدة Unity-iPhone لعرض إعدادات المشروع، ثم حدد علامة التبويب General.

ضمن Deployment Info، تأكد من تعيين هدف النشر إلى iOS 11.0.

حدد علامة التبويب Signing & Capabilities وتأكد من تمكين إدارة التوقيع Automatically إذا لم يكن كذلك، قم بتمكينه، ثم أعد تعيين إعدادات البنية عن طريق تحديد Enable Automatic في الجزء الذي يظهر.

انشر التطبيق على جهاز iOS

صِل جهاز iOS بـMac وتعيين النظام النشط على جهاز iOS.

حدد إنشاء ثم قم بتشغيل النظام الحالي.

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

في التطبيق، حدد العرض التوضيحي LocalShare باستخدام الأسهم، ثم اضغط على الزر Go! لتشغيل العرض التوضيحي. اتبع التعليمات لوضع المرساة واستدعائها.

باستخدام Create &Share Anchor، يمكنك إنشاء ارتساء وحفظه في خدمة المشاركة. في المقابل، ستحصل على معرّف له يمكنك استخدامه لاسترداده من خدمة المشاركة. يمكنك بعد ذلك تشغيل السيناريو الثاني، تحديد موقع الارتساء المشترك، إما من جهازك أو من جهاز آخر.

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

في Xcode، أوقف التطبيق عن طريق تحديد Stop.

Android

نموذج Java Android يدعم المشاركة عبر الأجهزة.

في Android Studio، افتح ملف SharedActivity.java من مجلد العينات.

أدخل عنوان URL الذي نسخته في الخطوة السابقة (من نشر Azure لتطبيق الويب ASP.NET) كقيمة SharingAnchorsServiceUrlفي ملف SharedActivity.java .

استبدل في index.html عنوان URL ب api/anchors. يجب أن يبدو كما يلي: https://<app_name>.azurewebsites.net/api/anchors.

قم بتوزيع التطبيق على جهازك.

بعد بدء تشغيل التطبيق، في جزء اختيار عرض توضيحي ، استخدم السهمين الأيمن والأيسر لتحديد الخيار LocalShare . ثم اضغط على انتقال!.

اتبع التعليمات الموجودة في التطبيق. يمكنك تحديد إنشاء و مشاركة ارتساء أو تحديد موقع الارتساء المشترك.

باستخدام Create &Share Anchor، يمكنك إنشاء ارتساء وحفظه في خدمة المشاركة. في المقابل، ستحصل على معرّف له يمكنك استخدامه لاسترداده من خدمة المشاركة. يمكنك بعد ذلك تشغيل السيناريو الثاني، تحديد موقع الارتساء المشترك، إما من جهازك أو من جهاز آخر.

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

iOS

يدعم نموذج Objective-C iOS المشاركة عبر الأجهزة.

افتح الملف SharedDemoViewController.m في مجلد العينات.

أدخل عنوان URL الذي حصلت عليه في الخطوة السابقة (من نشر Azure لتطبيق الويب ASP.NET) كقيمة SharingAnchorsServiceUrl في ملف SharedDemoViewController.m .

استبدل في index.html عنوان URL ب api/anchors. يجب أن يبدو كما يلي: https://<app_name>.azurewebsites.net/api/anchors.

قم بتوزيع التطبيق على جهازك.

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

باستخدام Create &Share Anchor، يمكنك إنشاء ارتساء وحفظه في خدمة المشاركة. في المقابل، ستحصل على معرّف له يمكنك استخدامه لاسترداده من خدمة المشاركة. يمكنك بعد ذلك تشغيل السيناريو الثاني، تحديد موقع الارتساء المشترك، إما من جهازك أو من جهاز آخر.

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

Xamarin

تدعم عينات Xamarin Android وiOS المشاركة عبر الأجهزة.

افتح ملف AccountDetails.cs في مجلد العينات.

أدخل عنوان URL الذي حصلت عليه في الخطوة السابقة (من نشر Azure لتطبيق الويب ASP.NET) كقيمة AnchorSharingServiceUrl في ملف AccountDetails.cs .

استبدل في index.html عنوان URL ب api/anchors. يجب أن يبدو كما يلي: https://<app_name>.azurewebsites.net/api/anchors.

قم بتوزيع التطبيق على جهازك.

بعد بدء تشغيل التطبيق، في جزء اختيار عرض توضيحي ، استخدم السهمين الأيمن والأيسر لتحديد الخيار LocalShare . ثم اضغط على انتقال!.

اتبع التعليمات الموجودة في التطبيق. يمكنك تحديد إنشاء و مشاركة ارتساء أو تحديد موقع الارتساء المشترك.

باستخدام Create &Share Anchor، يمكنك إنشاء ارتساء وحفظه في خدمة المشاركة. في المقابل، ستحصل على معرّف له يمكنك استخدامه لاسترداده من خدمة المشاركة. يمكنك بعد ذلك تشغيل السيناريو الثاني، تحديد موقع الارتساء المشترك، إما من جهازك أو من جهاز آخر.

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

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

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

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

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

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

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

في هذا البرنامج التعليمي، قمت بتوزيع تطبيق ويب برمجية ASP.NET في Azure، وقمت بتكوين تطبيق Unity وتوزيعه. لقد أنشأت نقاط الارتساء المكانية مع التطبيق، وشاركتها مع أجهزة أخرى باستخدام تطبيق الويب برمجة ASP.NET.

يمكنك تحسين تطبيق الويب برمجة ASP.NET الخاص بك بحيث يستخدم Azure Cosmos DB للاستمرار في تخزين معرفات الارتساء المكانية المشتركة. بإضافة دعم Azure Cosmos DB، يمكنك الحصول على تطبيق الويب برمجة ASP.NET لإنشاء نقاط الارتساء اليوم. بعد ذلك، باستخدام معرف نقاط الارتساء المخزن في تطبيق الويب الخاص بك، يمكنك إعادة التطبيق بعد أيام لتحديد نقطة الارتساء مرة أخرى.

استخدام Azure Cosmos DB لتخزين نقاط الارتساء