التشغيل السريع لـ 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

تستخدم الخطوات التالية نموذج تطبيق 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 Anchors بين الأجهزة. يمكنك استخدام حلّ مختلف في تطبيقاتك.

لإعداد قاعدة بيانات 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 API

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

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

يتوفر تطبيق CloudAnchorExample مع Podfile تم إعداده مسبقًا مع إصدارات حزمة تطوير البرامج (SDK) من ARCore وإصدارات 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 وأدخِل رمز الغرفة للدخول سابقًا. Google Cloud Anchors مستضافة في هذه الغرفة، باستخدام الجهاز نفسه أو جهاز مختلف.

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

إضافة حزمة ARCore SDK إلى تطبيقاتك

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

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

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

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

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

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