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

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

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

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

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

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

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

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

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

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

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

1. افتح Unity وأنشئ مشروع ثلاثي الأبعاد جديد.
2. في Unity، انتقِل إلى Window > مدير الحزمة.
3. انقر على + واختر إضافة حزمة من git URL.
4. الصق https://github.com/googlevr/cardboard-xr-plugin.git في حقل إدخال النص
   يجب إضافة الحزمة إلى الحِزم المثبَّتة.
5. انتقِل إلى حزمة المكوّن الإضافي Google Cardboard XR لـ 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. حدد طبقة جديدة تسمى "Interactive" (تفاعلية).
4. انقر على Treasure GameObject (كنز) لفتح نافذة Inspector (أداة الفحص). قم بتعيين طبقتها لتكون "تفاعلية". إذا ظهرت نافذة منبثقة تسألك عما إذا كنت تريد تعيين الطبقة على تفاعلية لجميع الكائنات الفرعية أيضًا، فانقر فوق "Yes, change children" (نعم، تغيير الأطفال).
5. انقر على المشغّل > الكاميرا > CardboardReticlePointer GameObject لفتح نافذة أداة الفحص. في النص البرمجي "مؤشر لوحة Carboard"، اختَر "Interactive" (تفاعل) كقناع طبقة تفاعل Reticle.

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

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

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

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

الدقة والعرض التقديمي

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

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

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

إعدادات أخرى

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

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

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

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

ملاحظة: لم يعُد OpenGL ES 2.0 متوافقًا مع إصدارَي Unity 1+. لمنصة OpenGL 2023 الأحدث، وتم استخدام الإصدار Vulkan الجديد من الإصدار 2023. لمزيد من المعلومات، يُرجى الاطّلاع على صفحة متطلبات 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.6.1'
     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 الإضافي

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

1. اختَر Cardboard XR Plugin ضمن مقدِّمو المكوّنات الإضافية.

بناء مشروعك

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

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

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

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

1. اختَر iOS واختَر تبديل النظام الأساسي.
2. اختر إضافة 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. حدِّد نطاق شركتك ضمن اسم الحزمة.

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

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

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

1. اختَر Cardboard XR Plugin ضمن مقدِّمو المكوّنات الإضافية.

بناء مشروعك

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

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

جارٍ إعادة التوسيط

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

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

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

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

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

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

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

• راجع إرشادات بناء هوية العلامة التجارية في Cardboard.