بدء سريع لخدمة Google Cardboard لـ Unity

يوضّح لك هذا الدليل كيفية استخدام Google Cardboard XR Plugin for Unity في Unity لإنشاء تجارب الواقع الافتراضي الخاصة بك.

ملاحظة: احرص على مراجعة إرشادات العلامة التجارية الخاصة بـ Cardboard قبل توزيع تطبيقك على جمهور أوسع.

يمكنك استخدام حزمة تطوير البرامج (SDK) في Cardboard لتحويل هاتف جوّال إلى منصة واقع افتراضي. يمكن للجهاز الجوّال عرض مشاهد ثلاثية الأبعاد باستخدام العرض المجسّم، وتتبُّع حركات الرأس والتفاعل معها، والتفاعل مع التطبيقات من خلال رصد وقت ضغط المستخدم على زر العارض.

للبدء، عليك استخدام HelloCardboard، وهي لعبة تجريبية توضّح الميزات الأساسية لحزمة تطوير البرامج (SDK) الخاصة بـ Cardboard. في اللعبة، يتجوّل المستخدمون في عالم افتراضي للعثور على كائنات وجمعها. يوضّح لك هذا المثال كيفية:

• إعداد بيئة التطوير
• تنزيل تطبيق العرض التوضيحي وإنشاؤه
• مسح رمز الاستجابة السريعة الخاص بنظّارة Cardboard لحفظ مَعلمات النظّارة
• تتبُّع حركات رأس المستخدم
• عرض صور مجسّمة من خلال ضبط التشويش الصحيح لكل عين
• تفعيل "وضع الواقع الافتراضي" وإيقافه

إعداد بيئة التطوير

متطلبات البرامج:

• ‫Unity 2021.3.44f1 أو إصدار أحدث
  • احرص على تضمين "دعم الإصدارات على Android وiOS" أثناء التثبيت.
  • تأكَّد من تثبيت الإصدار 44f1 أو إصدار أحدث من التصحيح.
• يجب تثبيت Git ويجب أن يكون الملف التنفيذي git ضمن متغير البيئة PATH. يمكنك الاطّلاع على مستندات توافق مدير الحِزم في Unity مع Git للحصول على مزيد من التفاصيل.

استيراد حزمة SDK وإنشاء مشروع جديد

اتّبِع الخطوات التالية لاستيراد حزمة تطوير البرامج (SDK) من Unity وإنشاء مشروع جديد.

1. افتح Unity وأنشئ مشروع ثلاثي الأبعاد جديدًا.
2. في Unity، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم).
3. انقر على + واختَر إضافة حزمة من عنوان URL على Git.
4. ألصِق https://github.com/googlevr/cardboard-xr-plugin.git في حقل إدخال النص.
   يجب إضافة الحزمة إلى الحِزم المثبَّتة.
5. انتقِل إلى حزمة Google Cardboard XR Plugin for Unity. في قسم العينات، اختَر استيراد إلى المشروع.
   يجب تحميل مواد العرض النموذجية في Assets/Samples/Google Cardboard/<version>/Hello Cardboard.

ملاحظة: <version> هو رقم الإصدار الدلالي X.Y.Z للحزمة التي تم إصدارها (على سبيل المثال، 1.1.0).

ضبط مشهد HelloCardboard

1. انتقِل إلى Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes، ثم انقر على إضافة مشاهد مفتوحة، واختَر HelloCardboard لفتح المشهد النموذجي.
2. افتح قائمة الطبقات واختَر تعديل الطبقات....
3. أنشئ طبقة جديدة باسم "تفاعلية".
4. انقر على عنصر Treasure GameObject لفتح نافذة "الفحص" (Inspector). اضبط طبقتها على "تفاعلية". إذا ظهرت نافذة منبثقة تسألك عمّا إذا كنت تريد ضبط الطبقة على "تفاعلية" لجميع العناصر الفرعية أيضًا، انقر على "نعم، تغيير العناصر الفرعية".
5. انقر على عنصر GameObject Player > Camera > CardboardReticlePointer لفتح نافذة Inspector. في نص برمجة "مؤشر شبكة التصويب في Cardboard"، اختَر "تفاعلي" كـ قناع طبقة التفاعل مع شبكة التصويب.

ضبط إعدادات إصدار Android

انتقِل إلى ملف (File) > إعدادات الإنشاء (Build Settings).

1. اختَر Android ثمّ تبديل النظام الأساسي.
2. انقر على إضافة مشاهد مفتوحة (Add Open Scenes) واختَر HelloCardboard.

إعدادات المشغّل

انتقِل إلى تعديل > إعدادات المشروع....

ضبط إعدادات الدقة والعرض

انتقِل إلى المشغّل > الدقة والعرض.

1. اضبط الاتجاه التلقائي على أفقي إلى اليسار أو أفقي إلى اليمين.
2. أوقِف خيار Optimized Frame Pacing.

ملاحظة: على الرغم من أنّ إضافة Cardboard XR تتوافق مع الاتجاهَين عمودي وعمودي مقلوب، قد لا يوفّر هذان الاتجاهان مساحة كافية لعرض الصور في العينَين على الأجهزة.

ضبط الإعدادات الأخرى

انتقِل إلى المشغّل > الإعدادات الأخرى.

1. اختَر OpenGLES2 أو OpenGLES3 أو Vulkan أو أي مجموعة منها في واجهات برمجة التطبيقات للرسومات.
2. اختَر Android 8.0 'Oreo' (API level 26) أو مستوى أعلى في الحد الأدنى لمستوى واجهة برمجة التطبيقات.
3. اختَر API level 35 أو مستوى أعلى في مستوى واجهة برمجة التطبيقات المستهدَف.
4. انقر على IL2CPP في الواجهة الخلفية للبرمجة النصية.
5. اختَر البُنى المطلوبة من خلال اختيار ARMv7 أو ARM64 أو كليهما في البُنى المستهدَفة.
6. انقر على Require في الوصول إلى الإنترنت.
7. انقر على Input System Package (New) في معالجة الإدخال النشطة.
8. حدِّد نطاق شركتك ضمن اسم الحزمة.
9. في حال اختيار Vulkan كـ واجهة برمجة تطبيقات الرسومات:
   • أزِل العلامة من مربّع الاختيار تطبيق دوران شاشة العرض أثناء العرض في إعدادات Vulkan.
   • إذا كان إصدار Unity هو 2021.2 أو إصدارًا أحدث، اختَر ETC2 في تنسيق ضغط النسيج.
10. إذا كان إصدار Unity هو 2023.1 أو إصدارًا أحدث، اختَر Activity وأزِل العلامة من المربّع GameActivity في نقطة دخول التطبيق.

ملاحظة: يمكن استخدام مستوى أدنى من الحد الأدنى لمستوى واجهة برمجة التطبيقات من خلال تغيير توافق واجهة برمجة التطبيقات الخاصة بالعرض. لمزيد من المعلومات، راجِع build.gradle

مستندات حزمة تطوير البرامج (SDK).ملاحظة: في حال مواجهة مشاكل عند اختيار Vulkan كواجهة برمجة تطبيقات للرسومات، ضَع علامة في المربّع Development Build ضمن Build Settings وحلِّل سجلات وقت التشغيل بحثًا عن أخطاء توافق برنامج التشغيل.

ملاحظة: لم يعُد الإصدار OpenGL ES 2.0 متوافقًا مع Unity 2023.1 والإصدارات الأحدث، لذا استخدِم OpenGL ES 3.0 أو Vulkan بدلاً منه. لمزيد من المعلومات، يُرجى الاطّلاع على صفحة متطلبات Android والتوافق في دليل Unity.

ضبط إعدادات النشر

انتقِل إلى المشغّل > إعدادات النشر.

1. في قسم إنشاء، اختَر Custom Main Gradle Template وCustom Gradle Properties Template.

2. أضِف الأسطر التالية إلى قسم التبعيات في Assets/Plugins/Android/mainTemplate.gradle:

     implementation 'androidx.appcompat:appcompat:1.6.1'
     implementation 'com.google.android.gms:play-services-vision:20.1.3'
     implementation 'com.google.android.material:material:1.12.0'
     implementation 'com.google.protobuf:protobuf-javalite:3.19.4'
   

3. أضِف الأسطر التالية إلى Assets/Plugins/Android/gradleTemplate.properties:

     android.enableJetifier=true
     android.useAndroidX=true
   

ملاحظة: قد تتغيّر العناصر التابعة المطلوبة بين الإصدارات. إذا كنت تريد استخدام إصدار مختلف عن الإصدار الأخير، يمكنك الاطّلاع على سجلّ قسم التبعيات في sdk/build.gradle في مستودع Cardboard SDK.

ضبط إعدادات "إدارة المكوّن الإضافي للواقع الممتد"

انتقِل إلى إدارة المكوّنات الإضافية لتقنيات الواقع الممتد (XR).

1. انقر على Cardboard XR Plugin ضمن موفّرو الإضافات.

إنشاء مشروعك

انتقِل إلى ملف (File) > إعدادات الإنشاء (Build Settings).

1. انقر على إنشاء أو اختَر جهازًا وانقر على إنشاء وتشغيل.

ضبط إعدادات مشروع iOS

انتقِل إلى ملف (File) > إعدادات الإنشاء (Build Settings).

1. اختَر iOS وانقر على تبديل النظام الأساسي.
2. انقر على إضافة مشاهد مفتوحة (Add Open Scenes) واختَر HelloCardboard.

إعدادات المشغّل

انتقِل إلى تعديل > إعدادات المشروع....

ضبط إعدادات الدقة والعرض

انتقِل إلى المشغّل > الدقة والعرض.

1. اضبط الاتجاه التلقائي على أفقي إلى اليسار أو أفقي إلى اليمين.

ملاحظة: على الرغم من أنّ إضافة Cardboard XR تتوافق مع الاتجاهَين عمودي وعمودي مقلوب، قد لا يوفّر هذان الاتجاهان مساحة كافية لعرض الصور في العينَين على الأجهزة.

ضبط الإعدادات الأخرى

انتقِل إلى المشغّل > الإعدادات الأخرى.

1. في وصف استخدام الكاميرا، اكتب Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters)..
2. في الحد الأدنى المستهدف لإصدار iOS، اكتب 12.0.
3. حدِّد نطاق شركتك ضمن اسم الحزمة.
4. ضَع علامة في المربّعات Top Edge وLeft Edge وRight Edge ضمن تأجيل إيماءات النظام على الحواف.

ملاحظة: إذا كنت تستخدم هاتف iPhone X، اختَر الخيار إخفاء زر الشاشة الرئيسية على هاتف iPhone X.

ضبط إعدادات "إدارة المكوّن الإضافي للواقع الممتد"

انتقِل إلى إدارة المكوّنات الإضافية لتقنيات الواقع الممتد (XR).

1. انقر على Cardboard XR Plugin ضمن موفّرو الإضافات.

إنشاء مشروعك

انتقِل إلى ملف (File) > إعدادات الإنشاء (Build Settings).

1. انقر على إنشاء أو إنشاء وتشغيل.

إعادة التوسيط

تتيح لك حزمة تطوير البرامج (SDK) في Cardboard إعادة توسيط أداة تتبُّع حركة الرأس باستخدام Recenter().

اتّبِع الخطوات التالية لتجربتها باستخدام التطبيق النموذجي:

1. حرِّك الجهاز إلى الموضع الذي تريد إعادة توسيطه فيه (استخدِم وضعية الرأس الجديدة للنظر إلى الأمام).
2. اضغط مع الاستمرار على زر التشغيل في جهاز Cardboard لمدة ثلاث ثوانٍ على الأقل.
3. ارفع إصبعك عن زر التشغيل.
4. أصبحت الوضعية الأولية الآن في الاتجاه الذي تشير إليه الكاميرا.

تفعيل "وضع الواقع الافتراضي" وإيقافه

تتيح لك Unity XR Plugin Management API تفعيل وضع الواقع الافتراضي أو إيقافه في Google Cardboard XR Plugin for Unity. تتوفّر مستندات المستخدم النهائي وأمثلة الاستخدام في مستندات المستخدم النهائي الخاصة بمنصة Unity.

يعرض مشهد VrMode في نموذج HelloCardboard طريقة استخدام أساسية لواجهة برمجة التطبيقات المذكورة أعلاه. في هذا المشهد، يمكن إيقاف وضع الواقع الافتراضي من خلال النقر على خروج ، ويمكن تفعيله مرة أخرى من خلال النقر على أي مكان على الشاشة. راجِع VrModeController.cs للحصول على تفاصيل حول كيفية تنفيذ ذلك.

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

• راجِع إرشادات استخدام هوية العلامة التجارية لـ Cardboard.