يغطي هذا التشغيل السريع كيفية تشغيل نموذج تطبيق Azure Spatial Anchors لأجهزة iOS باستخدام Xamarin (C#). Azure Spatial Anchors عبارة عن خدمة للمطورين عبر المنصات تتيح لك إنشاء تجارب واقع مختلط باستخدام كائنات تستمر في موقعها عبر الأجهزة بمرور الوقت. عند الانتهاء، سيكون لديك تطبيق iOS يمكنه حفظ وترسيخ مرساة مكانية.
أدخل اسماً فريداً للمورد باستخدام أحرف أبجدية رقمية عادية.
قم بتحديد الاشتراك الذي تريد إرفاق المورد به.
إنشاء مجموعة الموارد عن طريق تحديد Create new. قم بتسميتها myResourceGroup، ثم حدد OK.
مجموعة الموارد هي حاوية منطقية يتم فيها نشر موارد Azure وإدارتها، مثل تطبيقات الويب وقواعد البيانات وحسابات التخزين. على سبيل المثال، يمكنك اختيار حذف مجموعة الموارد بأكملها في خطوة واحدة بسيطة لاحقاً.
قم بتحديد موقع (منطقة) لوضع المورد فيه.
حدد Create لبدء إنشاء المورد.
بعد إنشاء المورد، يظهر مدخل Microsoft Azure اكتمال عملية النشر.
حدِّد الانتقال إلى المورد. يمكنك الآن أن تعرض خصائص المورد.
نسخ قيمة Account ID للمورد إلى محرر النص لاستخدامها لاحقا.
أيضاً قم بنسخ قيمة Account Domain للمورد إلى محرر النص لاستخدامها لاحقا.
ضمن "Settings"، حددAccess key. نسخ قيمتي Primary key وAccount Key إلى محرر النص لاستخدامهما لاحقا.
إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.
إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.
عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات بشأن الامتدادات، راجع استخدام امتدادات مع Azure CLI.
يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.
بعد تسجيل الدخول، استخدم الأمر az account set لتحديد الاشتراك الذي لإعداد حساب spatial anchors:
az account set --subscription 00000000-0000-0000-0000-000000000000
شغّل الأمر az group create لإنشاء مجموعة موارد أو استخدام مجموعة موارد موجودة:
az group create --name myResourceGroup --location eastus2
مجموعة الموارد هي حاوية منطقية يتم فيها نشر موارد Azure وإدارتها، مثل تطبيقات الويب وقواعد البيانات وحسابات التخزين. على سبيل المثال، يمكنك اختيار حذف مجموعة الموارد بأكملها في خطوة واحدة بسيطة لاحقاً.
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.MixedReality PowerShell، يجب تثبيتها بشكلٍ منفصل باستخدام Install-Module cmdlet. بعد أن تصبح وحدة PowerShell هذه متاحة بشكل عام، ستكون جزءًا من إصدارات وحدة Az PowerShell المستقبلية وستتوفر افتراضيًا من داخل Azure Cloud Shell.
Install-Module -Name Az.MixedReality
بعد تسجيل الدخول، استخدم الأمر Set-AzContext لتحديد الاشتراك الذي لإعداد حساب spatial anchors:
مجموعة الموارد هي حاوية منطقية يتم فيها نشر موارد Azure وإدارتها، مثل تطبيقات الويب وقواعد البيانات وحسابات التخزين. على سبيل المثال، يمكنك اختيار حذف مجموعة الموارد بأكملها في خطوة واحدة بسيطة لاحقاً.
حدد موقع الحقل SpatialAnchorsAccountKey واستبدل Set me بمفتاح الحساب.
حدد موقع الحقل SpatialAnchorsAccountId واستبدل Set me بمعرف الحساب.
حدد موقع الحقل SpatialAnchorsAccountDomain واستبدل Set me بنطاق الحساب.
انشر التطبيق على جهاز iOS
الطاقة على جهاز iOS، تسجيل الدخول، وتوصيله إلى الكمبيوتر باستخدام كابل USB.
جهز مشروع البدء من أجل SampleXamarin.iOS وغيِّر تكوين الحل لوضعية الإطلاق، وحدد الجهاز الذي ترغب في نشره من القائمة المنسدلة الخاصة بتحديد الجهاز.
حدد تصحيح>ابدأ التصحيح لنشر تطبيقك وبدء التصحيح.
في التطبيق، حدد وضع أساسي من أجل تشغيل العرض واتبع التعليمات لوضع واستدعاء أحد المراسي.
تنظيف الموارد
في الخطوات السابقة، أنشأت موارد Azure في إحدى مجموعات الموارد. إذا لم تكن تتوقع أن تحتاج إلى هذه الموارد في المستقبل، يمكنك حذفها عن طريق حذف مجموعة الموارد.
من قائمة مدخل Microsoft Azure أو من Home، حدد Resource groups. بعد ذلك، في صفحة مجموعات الموارد، حدد "myResourceGroup".
في صفحة myResourceGroup، تأكد من أن الموارد المدرجة هي التي تريد حذفها.
حدد حذف مجموعة الموارد واكتب myResourceGroup في مربع النص للتأكيد، ثم حدد حذف.
الخطوات التالية
لقد أنشأت في بدء التشغيل السريع هذا حساب Spatial Anchors. ثم أعددت تطبيقاً ونشرته لحفظ المراسي المكانية واستدعائها. لمعرفة المزيد حول كيفية تحسين التطبيق لتتمكن من مشاركة المراسي المكانية مع الأجهزة الأخرى، تابع البرنامج التعليمي التالي.