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

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

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

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

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