تفعيل الواقع المعزّز في تطبيق AR Foundation (على نظام التشغيل Android فقط)

فعِّل الواقع المعزّز لاستخدام ميزات الواقع المعزّز في تطبيقك الجديد أو الحالي.

ضبط تطبيقك على "يتطلّب الواقع المعزّز" أو "يتيح الواقع المعزّز"

لتوفير مساحة على الأجهزة الفردية، يتم تخزين جميع ميزات الواقع المعزّز في تطبيق يُسمى خدمات Google Play للواقع المعزّز يتم تحديثه بشكل منفصل من خلال "متجر Play". تتواصل تطبيقات Android التي تستخدم ميزات الواقع المعزّز مع "خدمات Google Play للواقع المعزّز" باستخدام حزمة تطوير البرامج ARCore. يمكن ضبط تطبيق يتيح ميزات الواقع المعزّز بطريقتَين: الواقع المعزّز مطلوب والواقع المعزّز اختياري. يحدّد هذا التصنيف طريقة تفاعل التطبيق مع تطبيق "خدمات Google Play للواقع المعزّز".

لا يمكن تشغيل تطبيق يتطلّب الواقع المعزّز بدون ARCore. تتطلّب هذه الميزة جهازًا متوافقًا مع ARCore مثبّتًا عليه "خدمات Google Play للواقع المعزّز".

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

يستخدم تطبيق الواقع المعزّز الاختياري ARCore لتحسين الوظائف الحالية. يتضمّن التطبيق ميزات واقع معزّز اختيارية لا يتم تفعيلها إلا على الأجهزة المتوافقة مع ARCore والتي تم تثبيت "خدمات Google Play للواقع المعزّز" عليها.

  • يمكن تثبيت تطبيقات "الواقع المعزّز الاختياري" وتشغيلها على الأجهزة غير المتوافقة مع ARCore.
  • عندما يثبّت المستخدمون تطبيقًا اختياريًا للواقع المعزّز، لن يثبّت "متجر Google Play" تلقائيًا "خدمات Google Play للواقع المعزّز" على الجهاز.
الواقع المعزّز مطلوبAR Optional
استخدام ميزة الواقع المعزّز يحتاج تطبيقك إلى ARCore لتنفيذ الوظائف الأساسية. تعزّز ARCore وظائف تطبيقك. يمكن تشغيل تطبيقك بدون توفير توافق مع ARCore.
حالة عرض المراجعات على "متجر Play" يتم إدراج تطبيقك في "متجر Google Play" فقط على الأجهزة المتوافقة مع ARCore. يتّبع تطبيقك إجراءات الإدراج العادية.
طريقة تثبيت "خدمات Google Play للواقع المعزّز" يثبِّت "متجر Play" "خدمات Google Play للواقع المعزّز" إلى جانب تطبيقك. يستخدم تطبيقك الروتين الفرعي ARSession.Install() لتنزيل ARCore وتثبيته.
متطلبات Android minSdkVersion ‫Android 7.0 (المستوى 24 لواجهة برمجة التطبيقات) ‫Android 4.4 (المستوى 19 من واجهة برمجة التطبيقات)، مع العلم أنّ تشغيل أي وظيفة من وظائف الواقع المعزّز يتطلّب الإصدار 7.0 من نظام التشغيل Android (المستوى 24 من واجهة برمجة التطبيقات) على الأقل
يجب استخدام ARSession.state للتحقّق من التوافق مع ARCore وحالة التثبيت
يجب استخدام إجراء ARSession.Install() الروتيني لتثبيت "خدمات Google Play للواقع المعزّز"

جعل تطبيقك يتطلّب توفّر الواقع المعزّز

Android

  1. الانتقال إلى Edit > Project Settings > XR Plug-in Management > ARCore يكون خيار Requirement مضبوطًا على Required تلقائيًا.

  2. انقر على Edit > Project Settings > Player، ثم اختَر علامة التبويب التي تتضمّن رمز Android.

  3. ضمن Other Settings > Identification، حدِّد Minimum API Level بقيمة 24 أو أعلى.

iOS

  1. الانتقال إلى Edit > Project Settings > XR Plug-in Management > ARKit يكون خيار Requirement مضبوطًا على Required تلقائيًا.

  2. انقر على Edit > Project Settings > Player، ثم اختَر علامة التبويب التي تتضمّن رمز iOS.

  3. ضِمن Other Settings > Configuration، حدِّد Target minimum iOS Version لتطبيقك.

جعل ميزة الواقع المعزّز اختيارية في تطبيقك

Android

  1. الانتقال إلى Edit > Project Settings > XR Plug-in Management > ARCore

  2. من القائمة المنسدلة Requirement، اختَر Optional لضبط تطبيقك على أن يكون استخدام الواقع المعزّز اختياريًا.

  3. انقر على Edit > Project Settings > Player، ثم اختَر علامة التبويب التي تتضمّن رمز Android.

  4. ضمن Other Settings > Identification، حدِّد Minimum API Level بقيمة 24 أو أعلى.

iOS

  1. الانتقال إلى Edit > Project Settings > XR Plug-in Management > ARKit

  2. من القائمة المنسدلة Requirement، اختَر Optional لضبط تطبيقك على "الواقع المعزّز اختياري".

  3. انقر على Edit > Project Settings > Player، ثم اختَر علامة التبويب التي تتضمّن رمز iOS.

  4. ضِمن Other Settings > Configuration، حدِّد Target minimum iOS Version لتطبيقك.

إجراء عمليات التحقّق أثناء التشغيل

التحقّق من تثبيت "خدمات Google Play للواقع المعزّز"

يجب أن تستخدم التطبيقات التي تتطلّب الواقع المعزّز أو تتيحه كخيار ARSession.Install() روتينًا فرعيًا قبل إنشاء جلسة ARCore للتحقّق مما إذا كان الإصدار المتوافق من "خدمات Google Play للواقع المعزّز" مثبّتًا (أو لا يزال مثبّتًا) ولضمان تنزيل جميع بيانات ملفات تعريف أجهزة ARCore المطلوبة.

أثناء وقت التشغيل، ستجري التطبيقات التي تتطلّب توفّر الواقع المعزّز عمليات تحقّق تلقائية أثناء وقت التشغيل للتأكّد من أنّ جهاز الاختبار:

  • يتوافق مع ARCore
  • تم تثبيت Google Play Services for AR: إذا لم يتم تثبيت هذا التطبيق (ربما لأنّ المستخدم أزاله) أو كان الإصدار قديمًا جدًا، سيطلب تطبيقك من المستخدم تثبيته أو تحديثه.
  • يتضمّن بيانات حديثة لملف تعريف جهاز ARCore، وإذا كانت البيانات قديمة، سينزّل تطبيقك بيانات جديدة.

اضبط قيمة ARSession.attemptUpdate على false لإيقاف عمليات التحقّق التلقائية هذه. يجب أن يظل تطبيقك يتعامل مع الحالات التالية:

الشرط الإجراء
الجهاز غير متوافق مع ARCore. يخفي هذا الخيار الوظائف المتعلّقة بالواقع المعزّز.
يتوافق الجهاز مع ARCore، ولكن بيانات ملف تعريف جهاز ARCore و/أو Google Play Services for AR غير مثبّتة أو قديمة. يطلب من المستخدم تثبيت Google Play Services for AR و/أو تعديل بيانات ملف تعريف جهاز ARCore من خلال استدعاء ARSession.Install().
يتوافق الجهاز مع ARCoreGoogle Play Services for AR، وتم تثبيت بيانات ملف تعريف جهاز ARCore وتحديثها. تنشئ هذه السمة Session في ARCore وتبدأ في استخدام ARCore.

يمكنك أيضًا الاطّلاع على ARSession.state لمعرفة حالات التثبيت والدعم.

الالتزام بمتطلبات خصوصية المستخدم

لنشر تطبيقك على "متجر Google Play"، تأكَّد من امتثاله لمتطلبات خصوصية المستخدم في ARCore.

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