Unity के लिए Google Cardboard के लिए क्विकस्टार्ट

यह गाइड आपको इनके लिए Google Cardboard XR प्लगिन का इस्तेमाल करने का तरीका बताती है Unity का इस्तेमाल करें, ताकि वर्चुअल रिएलिटी (वीआर) का अनुभव लेने के लिए.

ध्यान दें: कार्डबोर्ड ब्रैंडिंग को ज़रूर देखें दिशा-निर्देशों को शेयर करने से पहले ज़्यादा दर्शकों तक पहुंचाने में मदद मिलेगी.

किसी मोबाइल फ़ोन को वीआर प्लैटफ़ॉर्म में बदलने के लिए, आप Cardboard SDK टूल का इस्तेमाल कर सकते हैं. ऐप्लिकेशन स्मार्टफ़ोन स्टीरियोस्कोपिक रेंडरिंग से 3D सीन दिखा सकता है, ट्रैक कर सकता है, और प्रतिक्रिया दे सकता है जब उपयोगकर्ता सिर को घुमाता है, तो यह पता लगाकर ऐप्लिकेशन के साथ इंटरैक्ट करता है कि दर्शक बटन.

शुरू करने के लिए, आपको HelloCardboard का इस्तेमाल करना होगा. यह एक डेमो गेम है, जो कार्डबोर्ड SDK की मुख्य सुविधाएं. गेम में, लोग वर्चुअल चीज़ों को खोजने और इकट्ठा करने में मदद करता है. इसमें, ये काम करने का तरीका बताया गया है:

• अपना डेवलपमेंट एनवायरमेंट सेट अप करें
• डेमो ऐप्लिकेशन डाउनलोड करना और बनाना
• कार्डबोर्ड व्यूअर के क्यूआर कोड को स्कैन करें और उसके पैरामीटर सेव करें
• उपयोगकर्ता के सिर के मूवमेंट को ट्रैक करें
• हर आंख के लिए सही डिस्टॉर्शन सेट करके, स्टीरियोस्कोपिक इमेज बनाएं
• वीआर मोड को चालू या बंद करना

अपना डेवलपमेंट एनवायरमेंट सेट अप करें

ज़रूरी सॉफ़्टवेयर:

• Unity 2021.3.32f1 या इसके बाद
  • इंस्टॉलेशन के दौरान Android और iOS Build Support को शामिल करना न भूलें.
• Git इंस्टॉल होना चाहिए और git की एक्ज़ीक्यूटेबल फ़ाइल को PATH के एनवायरमेंट वैरिएबल पर होना चाहिए. Unity का पैकेज मैनेजर Git देखें अधिक के लिए दस्तावेज़ का समर्थन करें विवरण.

SDK टूल इंपोर्ट करें और नया प्रोजेक्ट बनाएं

Unity SDK टूल इंपोर्ट करने और नया प्रोजेक्ट बनाने के लिए, यह तरीका अपनाएं.

1. Unity खोलें और नया 3D प्रोजेक्ट बनाएं.
2. Unity में, Window > पैकेज मैनेजर.
3. + पर क्लिक करें और git यूआरएल से पैकेज जोड़ें चुनें.
4. टेक्स्ट में https://github.com/googlevr/cardboard-xr-plugin.git चिपकाएं एंट्री फ़ील्ड में.
   पैकेज को इंस्टॉल किए गए पैकेज में जोड़ा जाना चाहिए.
5. Unity के लिए Google Cardboard XR प्लगिन पैकेज पर जाएं. इस सैंपल सेक्शन में, प्रोजेक्ट में इंपोर्ट करें चुनें.
   सैंपल ऐसेट इसे Assets/Samples/Google Cardboard/<version>/Hello Cardboard में लोड किया जाना चाहिए.

ध्यान दें: <version>, रिलीज़ किए गए पैकेज का X.Y.Z सिमैंटिक वर्शन नंबर है (उदाहरण के लिए, 1.1.0).

हैलोकार्डबोर्ड सीन कॉन्फ़िगर किया जा रहा है

1. Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes पर जाएं, Open सीन जोड़ें को चुनें, और Heycardboard चुनें का इस्तेमाल करें.
2. लेयर मेन्यू खोलें और लेयर में बदलाव करें... चुनें.
3. "इंटरैक्टिव" नाम की एक नई लेयर तय करें.
4. इंस्पेक्टर विंडो खोलने के लिए, Treasure GameObject पर क्लिक करें. इसे सेट करें लेयर को "इंटरैक्टिव" होना चाहिए. अगर कोई पॉप-अप विंडो दिखती है, जिसमें पूछा जाता है कि आपको लेयर को सभी चाइल्ड ऑब्जेक्ट के लिए इंटरैक्टिव पर सेट करें, और "हां, बच्चों को बदलने के लिए खोज करते हैं".
5. प्लेयर > कैमरा > कार्डबोर्ड ReticlePointer GameObject से इंस्पेक्टर विंडो को खोलें. "कार्बोर्ड रेटिकल पॉइंटर" में स्क्रिप्ट, चुनें "इंटरैक्टिव" रीटिकल इंटरैक्शन लेयर मास्क के तौर पर.

Android प्रोजेक्ट की सेटिंग कॉन्फ़िगर करना

फ़ाइल पर जाएं > बिल्ड सेटिंग.

1. Android चुनें. इसके बाद, स्विच प्लैटफ़ॉर्म चुनें.
2. Open सीन जोड़ें को चुनें और hellocardboard चुनें.

प्लेयर की सेटिंग

रिज़ॉल्यूशन और प्रज़ेंटेशन

प्रोजेक्ट सेटिंग पर जाएं > खिलाड़ी > रिज़ॉल्यूशन और प्रज़ेंटेशन.

1. डिफ़ॉल्ट ओरिएंटेशन को लैंडस्केप लेफ़्ट या लैंडस्केप पर सेट करें जी हां.
2. ऑप्टिमाइज़ की गई फ़्रेम पेसिंग बंद करें.

ध्यान दें: Cardboard XR प्लगिन के साथ काम करने के दौरान, पोर्ट्रेट और पोर्ट्रेट अपसाइड डाउन ओरिएंटेशन की इमेज, आंखों के लिए ज़रूरत के मुताबिक नहीं है रेंडर होने में लगने वाला समय शामिल करना.

अन्य सेटिंग

प्रोजेक्ट सेटिंग पर जाएं > खिलाड़ी > अन्य सेटिंग.

1. OpenGLES2, OpenGLES3 या Vulkan या फिर इनमें से किसी भी कॉम्बिनेशन को चुनें Graphics API.
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 को चुनने में समस्या आ रही है, तो इसकी जानकारी दें एपीआई, Build Settings में Development Build बॉक्स को चुनें और रनटाइम लॉग, ड्राइवर के साथ काम करने से जुड़ी गड़बड़ियों को खोजने के लिए किए जाते हैं.

ध्यान दें: OpenGL ES 2.0, Unity 2023.1 के बाद के वर्शन पर काम नहीं करेगा. नए के लिए इस वर्शन में OpenGL ES 3.0 या Vulkan का इस्तेमाल किया जाता है. ज़्यादा जानकारी के लिए, देखें Android की ज़रूरी शर्तें और यह किन डिवाइसों पर काम करता है पेज पर जाएं.

पब्लिश करने की सेटिंग

प्रोजेक्ट सेटिंग पर जाएं > खिलाड़ी > पब्लिश करने की सेटिंग.

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 का इस्तेमाल किया जा सकता है.

XR प्लग-इन मैनेजमेंट सेटिंग

प्रोजेक्ट सेटिंग पर जाएं > XR प्लग-इन मैनेजमेंट.

1. प्लग-इन प्रोवाइडर में जाकर, Cardboard XR Plugin को चुनें.

अपना प्रोजेक्ट बनाएं

फ़ाइल पर जाएं > बिल्ड सेटिंग.

1. बिल्ड चुनें या कोई डिवाइस चुनने के बाद, बनाएं और चलाएं को चुनें.

iOS प्रोजेक्ट की सेटिंग कॉन्फ़िगर करना

फ़ाइल पर जाएं > बिल्ड सेटिंग.

1. iOS चुनें और Switch Platform चुनें.
2. Open सीन जोड़ें को चुनें और 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. बिल्ड या बनाएं और चलाएं को चुनें.

फिर से सेंटर में किया जा रहा है

कार्डबोर्ड SDK की मदद से इसका इस्तेमाल करके हेड ट्रैकर को फिर से बीच में लाएं Recenter().

ऐप्लिकेशन के नमूने का इस्तेमाल करके इसे आज़माने के लिए इन चरणों का पालन करें:

1. डिवाइस को उस पोज़िशन पर ले जाएं जिसे आपको फिर से बीच में लाना है (नई इमेज के तौर पर इस्तेमाल करें) सिर को आगे बढ़ाने का पोज़ (हाव-भाव).
2. अपने कार्डबोर्ड डिवाइस के ट्रिगर को कम से कम तीन सेकंड के लिए सक्रिय रखें.
3. ट्रिगर छोड़ दें.
4. शुरुआती पोज़ अब उस दिशा में है जहां कैमरा इशारा कर रहा है.

VR मोड को चालू और बंद करना

Unity XR प्लगिन मैनेजमेंट API की मदद से इसके लिए Google Cardboard XR प्लगिन के लिए VR मोड चालू या बंद करें Unity. असली उपयोगकर्ता के लिए दस्तावेज़ और इस्तेमाल के उदाहरण Unity के असली उपयोगकर्ता के लिए उपलब्ध हैं दस्तावेज़ में दिया गया है.

Hellocardboard के सैंपल में VrMode सीन में, ऊपर बताया गया एपीआई. इस सीन में, बाहर निकलें पर टैप करके, वीआर मोड को बंद किया जा सकता है है. कुछ ही समय में इसे फिर से चालू किया जा सकता है स्क्रीन पर कहीं भी टैप करें. इस्तेमाल की जानकारी VrModeController.cs देखें.

अगले चरण

• कार्डबोर्ड ब्रैंडिंग के दिशा-निर्देश पढ़ें.