Unity के लिए Android XR Interaction Framework का इस्तेमाल शुरू करना

Android XR इंटरैक्शन फ़्रेमवर्क (AXRIF), Android XR पर OpenXR ऐप्लिकेशन के लिए, जाने-पहचाने, हाई-लेवल, और राय पर आधारित इंटरैक्शन उपलब्ध कराता है. AXRIF, सिस्टम-लेवल के इंटरैक्शन और ऐप्लिकेशन में होने वाले इंटरैक्शन के बीच के अंतर को कम करता है. साथ ही, उपयोगकर्ता के इनपुट को मैनेज करने का आसान और बेहतर तरीका उपलब्ध कराता है.

Unity के साथ AXRIF को सेट अप करने और इसका इस्तेमाल शुरू करने के लिए, इस गाइड को पढ़ें.

ज़रूरी शर्तें

शुरू करने से पहले, पक्का करें कि आपका डेवलपमेंट एनवायरमेंट इन ज़रूरी शर्तों को पूरा करता हो:

• Unity का वर्शन: Unity 6 version 6000.3.12f1 या इसके बाद का वर्शन.
• प्रोजेक्ट सेटअप करना: Unity प्रोजेक्ट सेटअप करने से जुड़ी गाइड में दिए गए सभी चरण पूरे करें.

Unity को सेट अप और कॉन्फ़िगर करना

सेंपल सीन आज़माने से पहले, आपको AXRIF के लिए Unity को सेट अप और कॉन्फ़िगर करना होगा. इस प्रोसेस को पूरा करने के लिए, यहां दिए गए निर्देशों का पालन करें.

AXRIF पैकेज इंपोर्ट करें

सबसे पहले, AXRIF पैकेज और उसकी डिपेंडेंसी इंस्टॉल करें:

1. Window > Package Manager पर जाएं.
2. Package Manager टूलबार में जाकर, 'जोड़ें' मेन्यू खोलें.
3. पैकेज जोड़ने के विकल्पों में जाकर, + (प्लस) पर क्लिक करें.

4. ड्रॉप-डाउन मेन्यू से, Install package from git URL चुनें.

   

5. यह यूआरएल डालें:

   https://github.com/android-xr/android-xr-interaction-framework-unity-package.git

6. इंस्टॉल करें पर क्लिक करें.

   

XR Interaction Toolkit का वर्शन देखना

AXRIF पैकेज, Unity XR Interaction Toolkit (XRIT) के साथ काम करता है. यह XRIT को बदलता नहीं है. AXRIF पैकेज, XRIT पर निर्भर करता है. इसलिए, पिछले चरणों में AXRIF पैकेज इंस्टॉल करते समय, Unity को XRIT इंस्टॉल करना चाहिए था. हालांकि, आपको यह पक्का करना चाहिए कि Unity Editor में Window > Package Manager > Unity Registry > XR Interaction Toolkit पर जाकर, वर्शन 3.3.1 या उससे बाद का वर्शन इंस्टॉल किया गया हो.

Android XR की बिल्ड प्रोफ़ाइल चुनना

Android XR के लिए सही OpenXR एक्सटेंशन और बिल्ड सेटिंग चालू करने के लिए, Android XR की बिल्ड प्रोफ़ाइल चुनें:

1. फ़ाइल > बिल्ड प्रोफ़ाइलें पर जाएं.

2. Android XR पर क्लिक करें. इसके बाद, Switch Platform पर क्लिक करें.

   

OpenXR की सेटिंग कॉन्फ़िगर करना

Unity की OpenXR सेटिंग कॉन्फ़िगर करें, ताकि Unity ज़रूरी OpenXR डेटा को ऐक्सेस कर सके:

1. बदलें > प्रोजेक्ट सेटिंग > XR प्लग-इन मैनेजमेंट > OpenXR पर जाएं.
2. Android टैब में, चालू की गई इंटरैक्शन प्रोफ़ाइलें सेक्शन के लिए, + (प्लस) पर क्लिक करें.

3. अपने ऐप्लिकेशन की ज़रूरतों के हिसाब से, इनमें से कोई प्रोफ़ाइल जोड़ें:

   • आई गेज़ इंटरैक्शन प्रोफ़ाइल
   • हाथ के इंटरैक्शन की प्रोफ़ाइल
   • Oculus Touch Controller Profile
   • Android XR Mouse Interaction Profile

4. XR प्लग-इन मैनेजमेंट > OpenXR में मौजूद सुविधाओं की सूची में जाकर, ये सुविधाएं चालू करें:

   • Android XR (एक्सटेंशन): पासथ्रू कंपोज़िशन लेयर
   • Android XR (एक्सटेंशन): सेशन मैनेजमेंट
   • Android XR के लिए सहायता
   • Android XR: एआर कैमरा
   • Android XR: एआर सेशन
   • Android XR: एआर हैंड मेश डेटा
   • कंपोज़िशन लेयर की सुविधा
   • हैंड ट्रैकिंग सबसिस्टम

प्रोजेक्ट की पुष्टि करना

अपने प्रोजेक्ट के कॉन्फ़िगरेशन में मौजूद OpenXR से जुड़ी किसी भी गड़बड़ी को ठीक करने के लिए, प्रोजेक्ट की पुष्टि करें:

1. बदलाव करें > प्रोजेक्ट सेटिंग > XR प्लग-इन मैनेजमेंट > प्रोजेक्ट की पुष्टि पर जाएं.

2. बची हुई किसी भी सूचना या चेतावनी को ठीक करें, ताकि रनटाइम की गड़बड़ियों का असर कंपाइलेशन पर न पड़े.

   

सैंपल सीन का इस्तेमाल करना

शुरुआती सेटअप और कॉन्फ़िगरेशन पूरा करने के बाद, अब AXRIF के सैंपल सीन का इस्तेमाल किया जा सकता है. सैंपल सीन पाने और उसे आज़माने के लिए, यहां दिए गए निर्देशों का पालन करें.

XRIT के सैंपल पैकेज और AXRIF का सैंपल इंपोर्ट करना

AXRIF की सैंपल सीन, Unity के XR Interaction Toolkit (XRIT) Starter Assets और Hands Interaction Demo के सैंपल पैकेज पर निर्भर करती है.

XRIT के सैंपल पैकेज इंपोर्ट करना

AXRIF सैंपल के लिए ज़रूरी XRIT सैंपल पैकेज इंपोर्ट करें:

1. Window > Package Manager पर जाएं.
2. पैकेज की सूची से, XR Interaction Toolkit चुनें.

3. सैंपल टैब में, स्टार्टर ऐसेट और हाथ के इंटरैक्शन का डेमो के बगल में मौजूद, इंपोर्ट करें पर क्लिक करें.

   

AXRIF का सैंपल इंपोर्ट करना

सैंपल सीन पाने के लिए, AXRIF सैंपल इंपोर्ट करें:

1. Window > Package Manager पर जाएं.
2. पैकेज की सूची से, Android XR Interaction Framework चुनें.

3. सैंपल टैब में, Axrif सैंपल के बगल में मौजूद इंपोर्ट करें पर क्लिक करें.

   

सीन खोलें

ज़रूरी सैंपल पैकेज इंपोर्ट करने के बाद, सीन खोला जा सकता है:

1. ऐसेट > सैंपल > Android XR Interaction Framework > [AXRIF Version Number] > Axrif Sample पर जाएं.

2. AxrifDemoScene खोलें.

   

प्रीफ़ैब एक्सप्लोर करना

सीन को पहले से कॉन्फ़िगर किया गया है. इसके लिए, Packages > Android XR Interaction Framework > Prefabs में मौजूद मॉड्यूलर प्रीफ़ैब का इस्तेमाल किया गया है.

इंटरैक्टर प्रीफ़ैब

Axrif Interactor के प्रीफ़ैब, Unity XRIT इंटरैक्टर के मेकेनिक को चलाते हैं. इसके लिए, वे यहां दी गई सूची से इनपुट मोडैलिटी का इस्तेमाल करते हैं:

• हाथ/कंट्रोलर रे:
  • Axrif Left Interactor - Uses left hand raycast or controller.
  • Axrif Right Interactor - Uses right hand raycast or controller.
• देखकर पिंच करना:
  • Axrif Left GazePinch Interactor - Uses eye gaze and left-hand motion when pinching.
  • Axrif Right GazePinch Interactor - Uses eye gaze and right-hand motion when pinching.
  • Axrif Gaze Interactor - Uses eye gaze to point only.
• हैंड पोक:
  • Axrif Left Poke Interactor - Uses left index finger when touching interactables.
  • Axrif Right Poke Interactor - Uses right index finger when touching interactables.
• माउस:
  • Axrif Mouse Interactor - Uses Android XR spatial mouse.

Axrif Interaction Manager और Origin प्रीफ़ैब

• Axrif Interaction Manager: यह प्रीफ़ैब, सीन में AXRIF के लिए सेंट्रल हब है. प्रीफ़ैब में Axrif Interaction Manager कॉम्पोनेंट होता है. इसे XRIT XR Interaction Manager के साथ काम करने के लिए डिज़ाइन किया गया है. यह प्रीफ़ैब इन कामों के लिए ज़िम्मेदार है:

  • यह रनटाइम के दौरान, मुख्य AXRIF सबसिस्टम को शुरू और मैनेज करता है.
  • Interaction Framework Input Adapter का इस्तेमाल करके, OpenXR से मिले इनपुट डेटा को प्रोसेस और रूट करना.
  • Interaction Framework Scene Integrator का इस्तेमाल करके, यूज़र इंटरफ़ेस (यूआई) और कोलाइडर की स्थितियों को मॉनिटर करना.

• Axrif XR Origin: यह मुख्य किरदार और कैमरा ड्राइवर के तौर पर काम करता है. साथ ही, हैंड-मेश विज़ुअलाइज़र को मैनेज करता है.

इनपुट ऐक्शन कॉन्फ़िगर करना

OpenXR रनटाइम डेटा को Unity के इनपुट ऐक्शन से जोड़ने के लिए, पूरे प्रोजेक्ट के लिए मैप बाइंडिंग रजिस्टर करें:

1. Packages > Android XR Interaction Framework > InputActions पर जाएं.
2. AndroidXRInteractionFramework Input Actions ढूंढें.

3. पूरे प्रोजेक्ट के लिए इनपुट ऐक्शन के तौर पर असाइन करें पर क्लिक करें.

   

इंटरैक्शन में बदलाव करना

Axrif Interaction Manager प्रीफ़ैब का इस्तेमाल करके, अलग-अलग इनपुट मोड चालू या बंद किए जा सकते हैं. AXRIF में, इनपुट के लिए इन तरीकों का इस्तेमाल किया जा सकता है:

• कंट्रोलर रेकास्टिंग
• पिंच करें और देखें
• हाथ से रेकास्ट करना
• डायरेक्ट हैंड
• माउस के इंटरैक्शन.

Interaction Framework Manager कॉम्पोनेंट के Configurations सेक्शन में जाकर, सीधे तौर पर Inspector में इनपुट मोडेलिटी कॉन्फ़िगर की जा सकती हैं.

सैंपल बनाना

जब आपको सैंपल बनाना हो, तब Unity Editor में Build या Build and Run पर क्लिक करें.