تشغيل نموذج التطبيق: iOS - Unity (C#)
يغطي هذا التشغيل السريع كيفية تشغيل نموذج تطبيق Azure Spatial Anchors لأجهزة iOS باستخدام Unity (C#). Azure Spatial Anchors عبارة عن خدمة للمطورين عبر المنصات تتيح لك إنشاء تجارب واقع مختلط باستخدام كائنات تستمر في موقعها عبر الأجهزة بمرور الوقت. عند الانتهاء، سيكون لديك تطبيق ARKit iOS مدمج مع Unity يمكنه حفظ واستدعاء مرساة مكانية.
ستتعلم كيفية:
- إنشاء حساب المراسي المكانية
- إعداد إعدادات إنشاء Unity
- تكوين معرف حساب Spatial Anchors ومفتاح الحساب
- تصدير مشروع Xcode
- النشر والعمل على جهاز iOS
إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.
المتطلبات الأساسية
لإكمال هذا التشغيل السريع، تأكد من أن لديك:
- قام مطور بتمكين جهاز IOS متوافق مع ARKit.
- جهاز macOS مع تثبيت أحدث إصدار من Xcode .
- تثبيت Unity. للحصول على الإصدارات المدعومة والقدرات المطلوبة، تفضل بزيارة صفحة إعداد مشروع Unity.
- ثبت Git عبر HomeBrew. أدخل الأمر التالي في سطر واحد من المحطة الطرفية:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". وبعد ذلك، شغّلbrew install gitوbrew install git-lfs.
إنشاء مورد 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 إلى محرر النص لاستخدامهما لاحقا.
تنزيل نموذج المشروع واستيراد SDK
استنساخ مستودع العينات
نسخ مستودع العينات بتشغيل الأوامر التالية:
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
استيراد ASA SDK
اتبع الإرشادات هنا لتنزيل واستيراد حزم ASA SDK المطلوبة لنظام iOS الأساسي.
تكوين Unity
في الوحدة، افتح المشروع في مجلد Unity. قد يطالبك Unity بالفرق بين الإصدار في المشروع والإصدار المثبت على جهازك. هذا التحذير مقبول، طالما أن إصدار Unity Editor الخاص بك أحدث من الإصدار الذي تم إنشاء المشروع به. إذا كان إصدارك أحدث، فحدد Continue. أما إذا كان إصدارك أقدم من الإصدار الذي يحتاجه المشروع، فحدد Quit، وقم بترقية محرر Unity Editor لديك.
افتح إعدادات البناء عن طريق تحديد إعدادات> إنشاء الملف.
فيقسمالمنصة، حددiOS.
حدد تبديل المنصة لتغيير المنصة إلىiOS. قد يدفعك Unity لتثبيت مكونات دعم iOS إذا كانت مفقودة.
أغلقنافذة إعدادات البناء.
تكوين معلومات الحساب
الخطوة التالية هي تكوين التطبيق لاستخدام معلومات حسابك. قمت بنسخ قيم مفتاح الحساب،معرف الحساب ID، وقيم نطاق الحساب إلى محرر نصوص في وقت سابق، في قسم "إنشاء مورد روابط مكانية".
في جزء المشروع، انتقل إلى Assets\AzureSpatialAnchors.SDK\Resources.
حدد SpatialAnchorConfig. في جزء المفتش، أدخل Account Key كقيمة مفتاح حساب الروابط المكانية، وAccount ID كقيمة معرف حساب الروابط المكانية، وAccount Domainكقيمة نطاق حساب الروابط المكانية.
تصدير مشروع Xcode
افتح إعدادات البناء عن طريق تحديد إعدادات> إنشاء الملف.
ضمن 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.
حدد إنشاء ثم قم بتشغيل النظام الحالي.
في التطبيق، حدد BasicDemo باستخدام الأسهم، ثم اضغط على الزر Go! لتشغيل العرض التوضيحي. اتبع التعليمات لوضع المرساة واستدعائها.
عند الانتهاء، أوقف التطبيق بالضغط على Stop in Xcode.
استكشاف الأخطاء وإصلاحها
تقديم المشكلات
عند تشغيل التطبيق، إذا كنت لا ترى الكاميرا كخلفية (على سبيل المثال ترى بدلاً من ذلك مواد فارغة أو زرقاء أو غيرها)، فمن المرجح أنك تحتاج إلى إعادة استيراد الأصول في Unity. أوقف التطبيق. من القائمة العلوية في Unity، اختر Assets -> Re-import all. ثم قم بتشغيل التطبيق مرة أخرى.
تنظيف الموارد
في الخطوات السابقة، أنشأت موارد Azure في إحدى مجموعات الموارد. إذا لم تكن تتوقع أن تحتاج إلى هذه الموارد في المستقبل، يمكنك حذفها عن طريق حذف مجموعة الموارد.
من قائمة مدخل Microsoft Azure أو من Home، حدد Resource groups. بعد ذلك، في صفحة مجموعات الموارد، حدد "myResourceGroup".
في صفحة myResourceGroup، تأكد من أن الموارد المدرجة هي التي تريد حذفها.
حدد حذف مجموعة الموارد واكتب myResourceGroup في مربع النص للتأكيد، ثم حدد حذف.
الخطوات التالية
لقد أنشأت في بدء التشغيل السريع هذا حساب Spatial Anchors. ثم أعددت تطبيقاً ونشرته لحفظ المراسي المكانية واستدعائها. لمعرفة المزيد حول كيفية تحسين التطبيق لتتمكن من مشاركة المراسي المكانية مع الأجهزة الأخرى، تابع البرنامج التعليمي التالي.