تلتزم Google بتعزيز المساواة العرقية في المجتمعات السوداء. أنظر كيف.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

Quickstart لـ Cloud Anchors في iOS

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

يوضح لك هذا الدليل كيفية:

  • قم بإعداد بيئة التطوير الخاصة بك للعمل مع Cloud Anchors
  • جرب الاستضافة وحل نقاط الارتساء في نموذج التطبيق

متطلبات

لاستخدام Cloud Anchors ، ستحتاج إلى:

  • إصدار Xcode 10.1 أو أحدث

  • Cocoapods 1.4.0 أو أحدث

  • جهاز Apple متوافق مع ARKit يعمل بنظام iOS 11.0 أو إصدار أحدث (مطلوب هدف نشر iOS 10.0 أو أحدث)

استخدام المراسي السحابية

تستخدم الخطوات التالية نموذج تطبيق Cloud Anchors لتظهر لك المهام الحاسمة لتكوين وإنشاء تطبيق يدعم ARCore Cloud Anchors.

احصل على نموذج تطبيق Cloud Anchors

  1. قم باستنساخ ARCore SDK أو تنزيله لنظام iOS من GitHub للحصول على نموذج كود التطبيق.

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

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

إعداد الجلسة

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

قم بإعداد مشاركة Cloud Anchor ID

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

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

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

أضف مفتاح API

لاستخدام Cloud Anchors ، ستحتاج إلى إضافة مفتاح API إلى التطبيق.

  1. الحصول على مفتاح API. راجع إعداد مفاتيح API في مركز مساعدة Google Cloud Platform Console إذا كنت جديدًا في التعامل مع مفاتيح API.

  2. تفعيل واجهة برمجة تطبيقات ARCore Cloud Anchors لمشروع Google Cloud Platform.

  3. في Xcode ، أضف مفتاح API الخاص بك إلى التطبيق. للقيام بذلك ، أضف المفتاح إلى الكود التالي في CloudAnchorManager.m :

    self.gSession = [GARSession sessionWithAPIKey:@"Replace me with your API key."
                                 bundleIdentifier:nil
                                            error:nil];
    

قم بتشغيل تحديث البود

يتم شحن تطبيق 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 ملف .xcworkspace على جهازك.

  2. إذا طُلب منك ذلك ، فامنح أذونات الكاميرا للتطبيق. ثم تبدأ ARKit في اكتشاف الطائرات أمام الكاميرا.

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

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

    • يضع التطبيق كائن Andy Android على الطائرة ويربط مرساة به.
    • يتم إرسال طلب مضيف إلى خدمة ARCore Cloud Anchor. يتضمن طلب المضيف بيانات تمثل موضع المرساة بالنسبة إلى المعالم المرئية القريبة منه.
    • بمجرد استضافة المرساة ، تحصل على معرّف يُستخدم لحل نقاط الارتساء السحابية في هذا الفضاء.
  5. حل الحنفية وإدخال رمز الغرفة للوصول استضافت في السابق الغيمة المراس لهذه الغرفة، باستخدام نفس أو جهاز آخر.

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

أضف ARCore SDK إلى تطبيقاتك

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

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

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

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