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

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

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

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

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

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

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

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

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

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

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

1. افتح Unity وأنشئ مشروعًا جديدًا ثلاثي الأبعاد.
2. في Unity، انتقِل إلى النافذة > مدير الحِزم.
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. انقر على عنصر لعبة الكنز لفتح نافذة "المدقق". اضبط الطبقة على "تفاعلية". إذا ظهرت نافذة منبثقة تسألك عما إذا كنت تريد ضبط الطبقة على "تفاعلية" لجميع العناصر الفرعية أيضًا، انقر على "نعم، تغيير العناصر الفرعية".
5. انقر على عنصر اللاعب > الكاميرا > CardboardReticlePointer لفتح نافذة "المدقق". في نص "مؤشر شبكة الاستهداف في Cardboard"، اختَر "تفاعلي" كـ قناع طبقة تفاعل شبكة الاستهداف.

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

انتقِل إلى ملف > إعدادات الإنشاء.

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

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

درجة الدقة وطريقة العرض

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

1. اضبط الاتجاه التلقائي على أفقي لليسار أو أفقي لليمين.
2. أوقِف ميزة معدل عرض اللقطات المحسّن.

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

إعدادات أخرى

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

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

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

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

ملاحظة: لم يعُد الإصدار 2.0 من OpenGL ES متوافقًا مع الإصدار 2023.1 من Unity والإصدارات الأحدث. ويمكنك استخدام الإصدار 3.0 من OpenGL ES أو 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.

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

انتقِل إلى إعدادات المشروع > إدارة مكوّنات إضافية لتجربة الواقع المعزّز.

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

إنشاء مشروعك

انتقِل إلى ملف > إعدادات الإنشاء.

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

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

انتقِل إلى ملف > إعدادات الإنشاء.

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

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

درجة الدقة وطريقة العرض

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

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

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

إعدادات أخرى

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

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

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

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

انتقِل إلى إعدادات المشروع > إدارة مكوّنات إضافية لتجربة الواقع المعزّز.

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

إنشاء مشروعك

انتقِل إلى ملف > إعدادات الإنشاء.

1. اختَر إنشاء أو إنشاء وتشغيل.

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

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

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

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

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

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

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

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

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