تفعيل الواقع المعزّز في تطبيق 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 للواقع المعزّز" قديمة أو تم إلغاء تثبيتها يدويًا.

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

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

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