التشغيل السريع لـ Cloud Anchors في نظام التشغيل iOS

توفّر واجهة برمجة تطبيقات 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

  1. استنسِخ أو نزِّل حزمة ARCore SDK لنظام التشغيل iOS من GitHub للحصول على نموذج رمز التطبيق.

  2. افتح نافذة Terminal أو Finder (الباحث)، وانتقِل إلى المجلد الذي تم نسخ حزمة تطوير البرامج (SDK) أو تنزيلها من خلاله.

  3. يمكنك العثور على نموذج رمز التطبيق في
    /arcore-ios-sdk-master/Examples/CloudAnchorExample.

    نموذج رمز التطبيق الثابت في السحابة الإلكترونية في
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample.

إعداد الجلسة

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

إعداد مشاركة رقم تعريف Cloud Anchor

يستخدم نموذج تطبيق Cloud Anchors منصة Firebase لمشاركة أرقام تعريف Cloud Anchor بين الأجهزة. يمكنك استخدام حلّ مختلف في تطبيقاتك.

لإعداد قاعدة بيانات Firebase في نموذج التطبيق:

  1. اتّبع تعليمات Firebase من أجل إضافة Firebase إلى تطبيقك.
  2. يمكنك تنزيل ملف GoogleService-Info.plist الذي تم إنشاؤه كجزء من إضافة Firebase إلى تطبيقك.
  3. فعِّل مساحة التخزين في Firebase للنموذج:
    • انتقِل إلى وحدة تحكُّم Firebase واختَر المشروع الذي أعددته لنموذج التطبيق.
    • انقر على لوحة Database.
    • في الخيار Realtime Database، انقر على Get Started.
    • ستفتح قائمة Security rules for Realtime Database.
      • لأغراض تشغيل النموذج، اختر Start in test mode.
      • تجدر الإشارة إلى أنّك إذا كنت تستخدم Firebase لتطبيق تعتزم نشره، عليك استخدام قواعد أمان أكثر صرامة.
  4. في Xcode، أضِف ملف GoogleService-Info.plist إلى تطبيقك، بجانب Info.plist.

إعداد واجهة برمجة تطبيقات ARCore

لاستخدام Cloud Anchors، عليك أولاً إعداد ARCore API لتطبيقك.

تنفيذ تحديث مجموعة الإعلانات المتسلسلة

يتم شحن تطبيق CloudAnchorExample مع Podfile مُعدّ مسبقًا مع إصدارات ARCore SDK وiOS التي ستحتاج إليها. لتثبيت هذه التبعيات:

  1. افتح نافذة المحطة الطرفية وشغِّل pod update من المجلد الذي يوجد فيه مشروع Xcode.
    يؤدي هذا إلى إنشاء ملف .xcworkspace ستستخدمه لاحقًا لإنشاء التطبيق وتشغيله.

راجِع إضافة حزمة ARCore SDK إلى تطبيقك للحصول على مزيد من التفاصيل حول ضبط Podfile في تطبيقاتك الخاصة.

  1. افتح ملف .xcworkspace للمشروع في Xcode.

    لتجنب أخطاء الإصدار، تأكَّد من إنشاء المحتوى من ملف .xcworkspace وليس من ملف .xcodeproj.

تغيير معرِّف حزمة التطبيق

في Xcode، غيِّر معرِّف حزمة التطبيق حتى تتمكّن من توقيع التطبيق مع فريقك.

إنشاء التطبيق وتشغيله

  1. اربط جهازك وشغِّل التطبيق في Xcode.

  2. (اختياري) إذا كنت بصدد إنشاء نموذج تطبيق وتشغيله، يُرجى الاطّلاع على القسم التالي للحصول على تفاصيل عن استخدام التطبيق لاستضافة Cloud Anchors وحلها.

تجربة نموذج التطبيق

  1. أنشئ نموذج التطبيق وشغِّله من ملف .xcworkspace لتشغيله على جهازك.

  2. امنح أذونات الكاميرا للتطبيق إذا طُلب منك ذلك. سيبدأ ARKit بعد ذلك في رصد الطائرات أمام الكاميرا.

  3. انقر على HOST للدخول إلى وضع الاستضافة. يتم إنشاء رمز غرفة لمشاركة الإعلانات الثابتة المستضافة ويظهر على شاشتك.

  4. انقر على طائرة لبدء استضافة مرساة على السحابة الإلكترونية.

    • يضع التطبيق عنصر Android على الطائرة ويربط مرساة به.
    • يتم إرسال طلب مضيف إلى نقطة نهاية السحابة الإلكترونية لـ ARCore API. ويتضمن طلب المضيف بيانات تمثل موضع المرساة بالنسبة إلى الميزات المرئية القريبة منه.
    • وبعد استضافة الإعلان الثابت، يحصل على معرّف يتم استخدامه لحل مشاكل ارتساء السحابة الإلكترونية في هذه المساحة.

  5. انقر على "RESOLVE" وأدخِل رمز الغرفة للوصول إلى Cloud Anchors الذي تمت استضافته سابقًا لهذه الغرفة، باستخدام الجهاز نفسه أو جهاز مختلف.

    • يتم إرسال طلب حلّ إلى نقطة نهاية ARCore API على السحابة الإلكترونية.
    • يتضمن طلب الحل رقم تعريف ارتساء السحابة الإلكترونية. وإذا تطابق رقم التعريف مع علامة ارتساء مستضافة ونجحت الترجمة، يعرض الخادم تحويل علامة الارتساء في الإحداثيات المحلية.
    • يستخدم نموذج التطبيق التحويل لإضافة الرابط إلى المشهد وعرض الكائنات الافتراضية المرتبطة به.

إضافة حزمة تطوير البرامج (SDK) في ARCore إلى تطبيقاتك

في تطبيقاتك الخاصة، ستحتاج إلى تحديث Podfile لتضمين حزمة تطوير البرامج (SDK) لـ ARCore والإصدارات المتوافقة مع iOS. لإجراء ذلك، يُرجى اتّباع الخطوات التالية:

  1. أضف platform وpod التاليين إلى Podfileلمشروعك:

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.41.0'
  1. افتح نافذة Terminal وشغِّل pod update من المجلد الذي يتضمّن مشروع Xcode الخاص بك.
    يؤدي هذا إلى إنشاء ملف .xcworkspace تستخدمه لإنشاء التطبيق وتشغيله.

الإعلانات الثابتة على السحابة الإلكترونية

كما هو موضّح في مقالة استضافة الإعلان الثابت على السحابة الإلكترونية، يمكنك منح الإعلان الثابت على السحابة الإلكترونية فترةً تصل إلى 365 يومًا. ويتوفر نموذج التعليمات البرمجية الخاص باستخدام الإعلانات الثابتة للسحابة الإلكترونية الدائمة في دليل /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample في حزمة تطوير برامج ARCore لنظام التشغيل iOS من GitHub.

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