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

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

يجب ضبط تطبيقك ليكون "الواقع المعزّز" أو "الواقع المعزّز" اختياري.

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

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

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

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

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

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

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 لضبط تطبيقك على "الواقع المعزّز" (AR اختياري).

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

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

تنفيذ عمليات التحقّق في وقت التشغيل

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

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

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

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

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

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

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

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

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

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