توفّر واجهة برمجة تطبيقات ARCore Cloud Anchor API أو خدمة ARCore Cloud Anchor، إمكانيات الإرساء على السحابة الإلكترونية لتطبيقات iOS، ما يتيح للمستخدمين مشاركة تجارب الواقع المعزّز على أجهزة iOS وAndroid.
يوضِّح لك هذا الدليل كيفية:
- إعداد بيئة التطوير للعمل مع Cloud Anchors
- تجربة استضافة الإعلانات الثابتة وحلّها في نموذج تطبيق
المتطلبات الأساسية
- الإصدار 13.0 من Xcode أو إصدار أحدث
- الإصدار 1.4.0 من تطبيق Cocoapods أو إصدار أحدث في حال استخدام Cocoapods
- جهاز Apple متوافق مع ARKit يعمل بنظام التشغيل iOS 12.0 أو إصدار أحدث (مطلوب نشر الإصدار 12.0 من نظام التشغيل iOS أو إصدار أحدث)
استخدام Cloud Anchors
تستخدم الخطوات التالية نموذج تطبيق Cloud Anchors لعرض المهام الحرجة لإعداد وإنشاء تطبيق يتوافق مع ARCore Cloud Anchors.
الحصول على نموذج تطبيق Cloud Anchors
استنسِخ أو نزِّل حزمة ARCore SDK لنظام التشغيل iOS من GitHub للحصول على نموذج رمز التطبيق.
افتح نافذة Terminal أو Finder (الباحث)، وانتقِل إلى المجلد الذي تم نسخ حزمة تطوير البرامج (SDK) أو تنزيلها من خلاله.
يمكنك العثور على نموذج رمز التطبيق في
/arcore-ios-sdk-master/Examples/CloudAnchorExample
.نموذج رمز التطبيق الثابت في السحابة الإلكترونية في
/arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample
.
إعداد الجلسة
ينفذ نموذج التطبيق المهام المهمة التالية كجزء من إعداد الجلسة:
- إنشاء
GARSession
- إنشاء
ARSession
وتشغيله - ضبط
ARSessionDelegate
- تمرير
ARFrame
إلىGARSession
في طريقةsession:didUpdateFrame:
.
إعداد مشاركة رقم تعريف Cloud Anchor
يستخدم نموذج تطبيق Cloud Anchors منصة Firebase لمشاركة أرقام تعريف Cloud Anchor بين الأجهزة. يمكنك استخدام حلّ مختلف في تطبيقاتك.
لإعداد قاعدة بيانات Firebase في نموذج التطبيق:
- اتّبع تعليمات Firebase من أجل إضافة Firebase إلى تطبيقك.
- يمكنك تنزيل ملف
GoogleService-Info.plist
الذي تم إنشاؤه كجزء من إضافة Firebase إلى تطبيقك. - فعِّل مساحة التخزين في Firebase للنموذج:
- انتقِل إلى وحدة تحكُّم Firebase واختَر المشروع الذي أعددته لنموذج التطبيق.
- انقر على لوحة Database.
- في الخيار Realtime Database، انقر على Get Started.
- ستفتح قائمة Security rules for Realtime Database.
- لأغراض تشغيل النموذج، اختر Start in test mode.
- تجدر الإشارة إلى أنّك إذا كنت تستخدم Firebase لتطبيق تعتزم نشره، عليك استخدام قواعد أمان أكثر صرامة.
- في Xcode، أضِف ملف
GoogleService-Info.plist
إلى تطبيقك، بجانبInfo.plist
.
إعداد واجهة برمجة تطبيقات ARCore
لاستخدام Cloud Anchors، عليك أولاً إعداد ARCore API لتطبيقك.
تنفيذ تحديث مجموعة الإعلانات المتسلسلة
يتم شحن تطبيق CloudAnchorExample مع Podfile
مُعدّ مسبقًا مع
إصدارات ARCore SDK وiOS التي ستحتاج إليها. لتثبيت هذه التبعيات:
- افتح نافذة المحطة الطرفية وشغِّل
pod update
من المجلد الذي يوجد فيه مشروع Xcode.
يؤدي هذا إلى إنشاء ملف.xcworkspace
ستستخدمه لاحقًا لإنشاء التطبيق وتشغيله.
راجِع إضافة حزمة ARCore SDK إلى تطبيقك
للحصول على مزيد من التفاصيل حول ضبط Podfile
في تطبيقاتك الخاصة.
افتح ملف
.xcworkspace
للمشروع في Xcode.لتجنب أخطاء الإصدار، تأكَّد من إنشاء المحتوى من ملف
.xcworkspace
وليس من ملف.xcodeproj
.
تغيير معرِّف حزمة التطبيق
في Xcode، غيِّر معرِّف حزمة التطبيق حتى تتمكّن من توقيع التطبيق مع فريقك.
إنشاء التطبيق وتشغيله
اربط جهازك وشغِّل التطبيق في Xcode.
(اختياري) إذا كنت بصدد إنشاء نموذج تطبيق وتشغيله، يُرجى الاطّلاع على القسم التالي للحصول على تفاصيل عن استخدام التطبيق لاستضافة Cloud Anchors وحلها.
تجربة نموذج التطبيق
أنشئ نموذج التطبيق وشغِّله من ملف
.xcworkspace
لتشغيله على جهازك.امنح أذونات الكاميرا للتطبيق إذا طُلب منك ذلك. سيبدأ ARKit بعد ذلك في رصد الطائرات أمام الكاميرا.
انقر على HOST للدخول إلى وضع الاستضافة. يتم إنشاء رمز غرفة لمشاركة الإعلانات الثابتة المستضافة ويظهر على شاشتك.
انقر على طائرة لبدء استضافة مرساة على السحابة الإلكترونية.
- يضع التطبيق عنصر Android على الطائرة ويربط مرساة به.
- يتم إرسال طلب مضيف إلى نقطة نهاية السحابة الإلكترونية لـ ARCore API. ويتضمن طلب المضيف بيانات تمثل موضع المرساة بالنسبة إلى الميزات المرئية القريبة منه.
- وبعد استضافة الإعلان الثابت، يحصل على معرّف يتم استخدامه لحل مشاكل ارتساء السحابة الإلكترونية في هذه المساحة.
انقر على "RESOLVE" وأدخِل رمز الغرفة للوصول إلى Cloud Anchors الذي تمت استضافته سابقًا لهذه الغرفة، باستخدام الجهاز نفسه أو جهاز مختلف.
- يتم إرسال طلب حلّ إلى نقطة نهاية ARCore API على السحابة الإلكترونية.
- يتضمن طلب الحل رقم تعريف ارتساء السحابة الإلكترونية. وإذا تطابق رقم التعريف مع علامة ارتساء مستضافة ونجحت الترجمة، يعرض الخادم تحويل علامة الارتساء في الإحداثيات المحلية.
- يستخدم نموذج التطبيق التحويل لإضافة الرابط إلى المشهد وعرض الكائنات الافتراضية المرتبطة به.
إضافة حزمة تطوير البرامج (SDK) في ARCore إلى تطبيقاتك
في تطبيقاتك الخاصة، ستحتاج إلى تحديث Podfile
لتضمين
حزمة تطوير البرامج (SDK) لـ ARCore والإصدارات المتوافقة مع iOS. لإجراء ذلك، يُرجى اتّباع الخطوات التالية:
أضف
platform
وpod
التاليين إلىPodfile
لمشروعك:platform :ios, '11.0' pod 'ARCore/CloudAnchors', '~> 1.44.0'
- افتح نافذة Terminal وشغِّل
pod update
من المجلد الذي يتضمّن مشروع Xcode الخاص بك.
يؤدي هذا إلى إنشاء ملف.xcworkspace
تستخدمه لإنشاء التطبيق وتشغيله.
الإعلانات الثابتة على السحابة الإلكترونية
كما هو موضّح في مقالة استضافة الإعلان الثابت على السحابة الإلكترونية،
يمكنك منح الإعلان الثابت على السحابة الإلكترونية فترةً تصل إلى 365 يومًا. ويتوفر نموذج التعليمات البرمجية الخاص
باستخدام الإعلانات الثابتة للسحابة الإلكترونية الدائمة في دليل
/arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample
في حزمة تطوير برامج ARCore لنظام التشغيل iOS من GitHub.
الخطوات التالية
راجِع دليل مطوِّري Cloud Anchors لنظام التشغيل iOS لاستكشاف نموذج رمز التطبيق ومعرفة المزيد من المعلومات حول العمل مع Cloud Anchors في تطبيقاتك الخاصة.
يمكنك الاطّلاع على التفاصيل في مرجع واجهة برمجة تطبيقات ARCore iOS.