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

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

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

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

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

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

استخدام Cloud Anchors

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

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

  1. استنسِخ أو نزِّل ARCore SDK لنظام التشغيل 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

لاستخدام Cloud Anchors، يجب أولاً إعداد 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 في السحابة الإلكترونية.
    • يتضمّن طلب المعالجة معرّف عنصر التثبيت في السحابة الإلكترونية. وفي حال تطابق المعرّف مع إعلان ثابت مستضاف ونجاح الأقلمة، يعرض الخادم 120 درجة في الإحداثيات المحلية
    • يستخدم نموذج التطبيق عملية التحويل لإضافة العنصر الأساسي إلى المشهد و عرض الأجسام الافتراضية المرتبطة به.

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

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

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

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

عمليات الارتساء على السحابة الإلكترونية بشكل دائم

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

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