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

توفّر واجهة برمجة التطبيقات ARCore Cloud Anchor API أو خدمة ARCore Cloud Anchor إمكانات ربط السحابة الإلكترونية لتطبيقاتك على أجهزة iOS، ما يتيح للمستخدمين على أجهزة iOS وAndroid مشاركة تجارب الواقع المعزّز.

يوضّح لك هذا الدليل كيفية تنفيذ ما يلي:

  • إعداد بيئة التطوير للعمل مع ميزة "تثبيتات السحابة"
  • تجربة استضافة عناصر الربط وحلّها في نموذج تطبيق

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

  • الإصدار 13.0 من Xcode أو إصدار أحدث
  • ‫Cocoapods 1.4.0 أو إصدار أحدث في حال استخدام Cocoapods
  • جهاز Apple متوافق مع ARKit يعمل بالإصدار 12.0 من نظام التشغيل iOS أو إصدار أحدث (يجب أن يكون هدف النشر هو الإصدار 12.0 من نظام التشغيل iOS أو إصدار أحدث)

استخدام "عناصر الربط في السحابة الإلكترونية"

تستخدِم الخطوات التالية نموذج تطبيق "نقاط الربط في السحابة الإلكترونية" لعرض المهام المهمة لضبط إعدادات تطبيق متوافق مع ميزة "نقاط الربط في السحابة الإلكترونية" من ARCore وإنشائه.

الحصول على نموذج تطبيق "تثبيتات السحابة الإلكترونية"

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

  2. افتح نافذة Terminal أو Finder وانتقِل إلى المجلد الذي نسخت فيه حزمة SDK أو نزّلتها.

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

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

إعداد الجلسة

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

إعداد مشاركة معرّف Cloud Anchor

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

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

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

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

لاستخدام ميزة "تثبيتات السحابة الإلكترونية"، عليك أولاً إعداد واجهة برمجة التطبيقات ARCore API لتطبيقك.

تشغيل تحديث مجموعة التطبيقات

يتم شحن تطبيق CloudAnchorExample مع Podfile تم ضبطه مسبقًا باستخدام حزمة تطوير البرامج (SDK) لـ ARCore وإصدارات iOS التي ستحتاج إليها. لتثبيت هذه التبعيات:

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

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

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

    لتجنُّب أخطاء التصميم، تأكَّد من أنّك تُنشئ التطبيق من ملف .xcworkspace وليس من ملف .xcodeproj.

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

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

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

  1. وصِّل جهازك وافتح التطبيق في Xcode.

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

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

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

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

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

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

    • يضع التطبيق عنصر Andy 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.48.0'
  1. افتح نافذة Terminal (وحدة التحكّم في المحطة الطرفية) وشغِّل pod update من المجلد الذي يقع فيه مشروع Xcode.
    يؤدي ذلك إلى إنشاء ملف .xcworkspace الذي تستخدمه لإنشاء التطبيق وتشغيله.

نقاط تثبيت السحابة الإلكترونية الثابتة

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

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