Android XR के लिए Unity की मदद से डेवलप करना

इस्तेमाल किए जा सकने वाले XR डिवाइस

इन दिशा-निर्देशों से आपको इस तरह के एक्सआर डिवाइसों के लिए अनुभव तैयार करने में मदद मिलती है.

एक्सआर डिवाइस के टाइप के बारे में जानें →

एक्सआर डिवाइस के टाइप के बारे में जानें →

इस गाइड में, Android XR के लिए Unity का इस्तेमाल करके ऐप्लिकेशन बनाने के बारे में खास जानकारी दी गई है. Android XR, Unity के उन जाने-पहचाने टूल और सुविधाओं के साथ काम करता है जिनकी आपको उम्मीद है. Unity में Android XR की सुविधा, OpenXR पर आधारित है. इसलिए, OpenXR की खास जानकारी में बताई गई कई सुविधाएं, Unity में भी काम करती हैं.

इस गाइड को पढ़कर, इनके बारे में जानें:

• Android XR के लिए Unity की सहायता
  • Unity XR की बुनियादी बातें
  • Android XR के लिए ऐप्लिकेशन डेवलप और पब्लिश करना
  • Android XR के लिए Unity पैकेज
    • Unity OpenXR: Android XR पैकेज
    • Unity के लिए Android XR Extensions
    • सुविधाएं और साथ काम करने से जुड़ी ज़रूरी बातें
• इनपुट और इंटरैक्शन

Android XR के लिए Unity की सहायता

Android XR के लिए Unity ऐप्लिकेशन बनाते समय, Unity 6 के नए वर्शन में मौजूद मिक्स्ड रिएलिटी टूल और सुविधाओं का फ़ायदा लिया जा सकता है. इनमें मिक्स्ड रिएलिटी वाले टेंप्लेट शामिल हैं. ये टेंप्लेट, XR Interaction Toolkit, AR Foundation, और OpenXR Plugin का इस्तेमाल करते हैं, ताकि आप जल्दी से काम शुरू कर सकें. Android XR के लिए Unity का इस्तेमाल करके ऐप्लिकेशन बनाते समय, हमारा सुझाव है कि आप रेंडर पाइपलाइन के तौर पर यूनिवर्सल रेंडर पाइपलाइन (यूआरपी) और ग्राफ़िक्स एपीआई के तौर पर Vulkan का इस्तेमाल करें. इन सुविधाओं की मदद से, Unity की कुछ ग्राफ़िक्स सुविधाओं का फ़ायदा लिया जा सकता है. ये सुविधाएं सिर्फ़ Vulkan के साथ काम करती हैं. इन सेटिंग को कॉन्फ़िगर करने के तरीके के बारे में ज़्यादा जानकारी के लिए, प्रोजेक्ट सेटअप गाइड देखें.

Unity XR की बुनियादी बातें

अगर आप Unity या XR डेवलपमेंट के लिए नए हैं, तो XR के बुनियादी कॉन्सेप्ट और वर्कफ़्लो को समझने के लिए, Unity का XR मैन्युअल देखें. XR के मैन्युअल में इनके बारे में जानकारी शामिल है:

• एक्सआर प्रोवाइडर प्लग-इन, जिनमें Unity OpenXR: Android XR और Unity के लिए Android XR एक्सटेंशन शामिल हैं
• ऐप्लिकेशन-लेवल पर अतिरिक्त सुविधाएं जोड़ने के लिए, एक्सआर सपोर्ट पैकेज
• एक्सआर आर्किटेक्चर गाइड, जिसमें Unity XR टेक स्टैक और एक्सआर सबसिस्टम के बारे में बताया गया है
• एक्सआर प्रोजेक्ट सेट अप करना
• एक्सआर ऐप्लिकेशन बनाना और चलाना
• एक्सआर ग्राफ़िक्स से जुड़े दिशा-निर्देश. इनमें यूनिवर्सल रेंडर पाइपलाइन, स्टीरियो रेंडरिंग, फ़ोविएटेड रेंडरिंग, मल्टीव्यू रेंडर रीजन, और वीआर फ़्रेम टाइमिंग शामिल हैं
• एक्सआर ऑडियो गाइडेंस, जिसमें ऑडियो स्पेशलाइज़र के लिए सहायता शामिल है

Android के लिए ऐप्लिकेशन डेवलप और पब्लिश करना

Unity, Android के लिए ऐप्लिकेशन डेवलप करने, बनाने, और पब्लिश करने के बारे में पूरी जानकारी देता है. इसमें Unity में Android की अनुमतियां, Android बिल्ड सेटिंग, Android के लिए ऐप्लिकेशन बनाना, और Google Play पर ऐप्लिकेशन उपलब्ध कराना जैसे विषय शामिल हैं.

Android XR के लिए Unity पैकेज

Android XR के लिए Unity ऐप्लिकेशन बनाने की सुविधा देने वाले दो पैकेज हैं. ये दोनों पैकेज, एक्सआर प्रोवाइडर प्लग-इन हैं. इन्हें Unity के XR प्लग-इन मैनेजमेंट पैकेज की मदद से चालू किया जा सकता है. एक्सआर प्लग-इन मैनेजर, प्रोजेक्ट सेटिंग जोड़ता है. इससे एक्सआर प्लग-इन को लोड करने, शुरू करने, सेटिंग करने, और बिल्ड करने में मदद मिलती है. रनटाइम के दौरान OpenXR की सुविधाओं को लागू करने के लिए, प्रोजेक्ट में ये सुविधाएं चालू होनी चाहिए. इसके लिए, प्लग-इन मैनेजर का इस्तेमाल करें.

इस इमेज में एक उदाहरण दिखाया गया है. इसमें बताया गया है कि Unity के एडिटर की मदद से, इन सुविधाओं के ग्रुप को कहां से चालू किया जा सकता है.

Unity OpenXR Android XR

Unity OpenXR Android XR पैकेज, एक XR प्लग-इन है. इसकी मदद से, Unity में Android XR की सुविधा जोड़ी जा सकती है. यह XR प्लग-इन, Unity के लिए Android XR की ज़्यादातर सुविधाएं उपलब्ध कराता है. साथ ही, यह AR Foundation प्रोजेक्ट के लिए, Android XR डिवाइस पर काम करने की सुविधा चालू करता है. AR Foundation को उन डेवलपर के लिए डिज़ाइन किया गया है जो एआर या मिक्स्ड रिएलिटी वाले अनुभव बनाना चाहते हैं. यह एआर की सुविधाओं के लिए इंटरफ़ेस उपलब्ध कराता है, लेकिन खुद कोई सुविधा लागू नहीं करता. Unity OpenXR Android XR पैकेज, इसे लागू करने की सुविधा देता है. इस पैकेज का इस्तेमाल शुरू करने के लिए, पैकेज का मैन्युअल देखें. इसमें, शुरुआती निर्देश मौजूद हैं.

Unity के लिए Android XR Extensions

Android XR Extensions for Unity, Unity OpenXR Android XR पैकेज के साथ काम करता है. इसमें अतिरिक्त सुविधाएं शामिल हैं, ताकि आपको इमर्सिव एक्सपीरियंस बनाने में मदद मिल सके. इसका इस्तेमाल अकेले या Unity OpenXR Android XR पैकेज के साथ किया जा सकता है.

इस पैकेज का इस्तेमाल शुरू करने के लिए, प्रोजेक्ट सेटअप करने की हमारी गाइड या Unity के लिए Android XR Extensions को इंपोर्ट करने के लिए क्विकस्टार्ट गाइड देखें.

सुविधाएं और साथ काम करने से जुड़ी ज़रूरी बातें

यहां दी गई टेबल में, Unity OpenXR: Android XR पैकेज और Android XR Extensions for Unity पैकेज के साथ काम करने वाली सुविधाओं के बारे में बताया गया है. इसका इस्तेमाल करके, यह तय किया जा सकता है कि किस पैकेज में आपकी ज़रूरत की सुविधाएं मौजूद हैं. साथ ही, यह भी पता लगाया जा सकता है कि वह पैकेज आपके डिवाइस के साथ काम करता है या नहीं.

इनपुट और इंटरैक्शन

Android XR, मल्टी-मोडल नैचुरल इनपुट के साथ काम करता है.

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

इंटरैक्शन प्रोफ़ाइलें

Unity, इंटरैक्शन प्रोफ़ाइल का इस्तेमाल करके यह मैनेज करता है कि आपका एक्सआर ऐप्लिकेशन, अलग-अलग एक्सआर डिवाइसों और प्लैटफ़ॉर्म के साथ कैसे कम्यूनिकेट करता है. ये प्रोफ़ाइलें, अलग-अलग हार्डवेयर कॉन्फ़िगरेशन के लिए ज़रूरी इनपुट और आउटपुट तय करती हैं. इससे कई प्लैटफ़ॉर्म पर, एक जैसी सुविधाएं और बेहतर परफ़ॉर्मेंस मिलती है. इंटरैक्शन प्रोफ़ाइलें चालू करके, यह पक्का किया जा सकता है कि आपका एक्सआर ऐप्लिकेशन अलग-अलग डिवाइसों के साथ सही तरीके से काम करे, इनपुट मैपिंग को एक जैसा बनाए रखे, और कुछ खास एक्सआर सुविधाओं को ऐक्सेस कर सके. इंटरैक्शन प्रोफ़ाइल सेट करने के लिए:

1. Project Settings विंडो खोलें (मेन्यू: Edit > Project Settings).
2. अगर ज़रूरी हो, तो प्लग-इन सेक्शन को बड़ा करने के लिए, XR Plug-in Management पर क्लिक करें.
3. एक्सआर प्लग-इन की सूची में, OpenXR को चुनें.
4. इंटरैक्शन प्रोफ़ाइल सेक्शन में, प्रोफ़ाइल जोड़ने के लिए + बटन को चुनें.
5. सूची से वह प्रोफ़ाइल चुनें जिसे जोड़ना है.

हाथों से इंटरैक्ट करने की सुविधा

हाथ से इंटरैक्शन (XR_EXT_hand_interaction) की सुविधा, OpenXR प्लगिन से मिलती है. हाथ से इंटरैक्शन की प्रोफ़ाइल को चालू करके, Unity इनपुट सिस्टम में <HandInteraction> डिवाइस का लेआउट दिखाया जा सकता है. हाथ से इनपुट देने के लिए, इस इंटरैक्शन प्रोफ़ाइल का इस्तेमाल करें. यह OpenXR के तय किए गए चार ऐक्शन पोज़ के साथ काम करती है: "पिंच", "पोक", "एम", और "ग्रिप". अगर आपको हाथ से इंटरैक्ट करने या हाथ ट्रैक करने की सुविधा के बारे में ज़्यादा जानकारी चाहिए, तो इस पेज पर XR Hands पर जाएं.

आई गेज़ इंटरैक्शन

आई गेज़ इंटरैक्शन (XR_EXT_eye_gaze_interaction), OpenXR प्लग इन से मिलता है. इस लेआउट का इस्तेमाल करके, आंखों के पोज़ का डेटा (पोज़िशन और रोटेशन) वापस पाया जा सकता है. यह डेटा, एक्सटेंशन से मिलता है. OpenXR इनपुट गाइड में, आई गेज़ इंटरैक्शन के बारे में ज़्यादा जानें.

कंट्रोलर इंटरैक्शन

Android XR, 6DoF कंट्रोलर के लिए Oculus Touch Controller Profile के साथ काम करता है. ये दोनों प्रोफ़ाइलें, OpenXR प्लग इन से मिलती हैं.

माउस इंटरैक्शन

Android XR Mouse Interaction Profile (XR_ANDROID_mouse_interaction), Unity के लिए Android XR एक्सटेंशन से मिलती है. यह Unity इनपुट सिस्टम में <AndroidXRMouse> डिवाइस लेआउट को दिखाता है.

हथेली के जेस्चर से इंटरैक्शन

OpenXR प्लगिन, पाम पोज़ इंटरैक्शन (XR_EXT_palm_pose) के लिए सहायता उपलब्ध कराता है. इससे Unity इनपुट सिस्टम में <PalmPose> लेआउट दिखता है. हथेली की मुद्रा का इस्तेमाल, उन एक्सटेंशन या पैकेज के विकल्प के तौर पर नहीं किया जाना चाहिए जो ज़्यादा जटिल मामलों में हाथ ट्रैक करने की सुविधा देते हैं. इसके बजाय, इसका इस्तेमाल ऐप्लिकेशन के हिसाब से विज़ुअल कॉन्टेंट दिखाने के लिए किया जा सकता है. जैसे, अवतार के विज़ुअल. हथेली के पोज़ में, हथेली की पोज़िशन और ओरिएंटेशन, दोनों शामिल होते हैं.

एक्सआर हैंड

XR Hands पैकेज की मदद से, हाथ ट्रैक करने की सुविधा का डेटा ऐक्सेस किया जा सकता है. इसके लिए, XR_EXT_hand_tracking और XR_FB_hand_tracking_aim का इस्तेमाल किया जाता है. साथ ही, यह हाथ ट्रैक करने की सुविधा से मिले हाथ के जोड़ों के डेटा को इनपुट पोज़ में बदलने के लिए, एक रैपर उपलब्ध कराता है. XR Hands पैकेज में मौजूद सुविधाओं का इस्तेमाल करने के लिए, Hand Tracking Subsystem और Meta Hand Tracking Aim OpenXR सुविधाएं चालू करें.

XR hands पैकेज तब काम आ सकता है, जब आपको हाथ की मुद्रा या हाथ के जोड़ों का ज़्यादा सटीक डेटा चाहिए या जब आपको कस्टम जेस्चर के साथ काम करना हो.

ज़्यादा जानकारी के लिए, Unity का अपने प्रोजेक्ट में XR Hands सेट अप करने के लिए दस्तावेज़ देखें

चेहरा ट्रैक करने की सुविधा के लिए कॉन्फ़िडेंस रीजन

XR_ANDROID_face_tracking एक्सटेंशन, चेहरे के तीन हिस्सों के लिए कॉन्फ़िडेंस वैल्यू उपलब्ध कराता है: ऊपर बाईं ओर, ऊपर दाईं ओर, और चेहरे का निचला हिस्सा. ये वैल्यू, 0 (कोई भरोसा नहीं) से लेकर 1 (सबसे ज़्यादा भरोसा) तक होती हैं. इनसे हर हिस्से के लिए, चेहरा ट्रैक करने की सुविधा की सटीक जानकारी मिलती है.

इन वैल्यू का इस्तेमाल करके, ब्लेंडशेप को धीरे-धीरे बंद किया जा सकता है या चेहरे के संबंधित हिस्से पर विज़ुअल फ़िल्टर (जैसे, धुंधला करना) लागू किए जा सकते हैं. बेसिक के लिए, चेहरे के संबंधित हिस्से में ब्लेंडशेप को बंद करें.

"चेहरे के निचले हिस्से" में आंखों के नीचे का पूरा हिस्सा शामिल होता है. इसमें मुंह, ठुड्डी, गाल, और नाक शामिल हैं. ऊपर के दो हिस्सों में, चेहरे के बाईं और दाईं ओर मौजूद आंखें और भौंहें शामिल हैं.

यहां दिए गए C# कोड स्निपेट से, Unity स्क्रिप्ट में कॉन्फ़िडेंस डेटा को ऐक्सेस करने और उसका इस्तेमाल करने का तरीका पता चलता है:

using UnityEngine;
using Google.XR.Extensions;

public class FaceTrackingConfidence : MonoBehaviour
{
    void Update()
    {
      if (!XRFaceTrackingFeature.IsFaceTrackingExtensionEnabled.HasValue)
      {
        DebugTextTopCenter.text = "XrInstance hasn't been initialized.";
        return;
      }
      else if (!XRFaceTrackingFeature.IsFaceTrackingExtensionEnabled.Value)
      {
        DebugTextTopCenter.text = "XR_ANDROID_face_tracking is not enabled.";
        return;
      }

      for (int x = 0; x < _faceManager.Face.ConfidenceRegions.Length; x++)
      {
        switch (x)
        {
          case (int)XRFaceConfidenceRegion.Lower:
            regionText = "Bottom";
            break;
          case (int)XRFaceConfidenceRegion.LeftUpper:
            regionText = DebugTextConfidenceLeft;
            break;
          case (int)XRFaceConfidenceRegion.RightUpper:
            regionText = DebugTextConfidenceRight;
            break;
        }
    }
}

ज़्यादा जानकारी के लिए, Unity के लिए Android XR एक्सटेंशन से जुड़ा दस्तावेज़ देखें.

हाथों को रेंडर करने का तरीका चुनें

Android XR में हाथों को रेंडर करने के दो तरीके हैं: हैंड मेश और प्रीफ़ैब विज़ुअलाइज़र.

हाथ का मेश

Android XR Unity पैकेज में हैंड मेश की सुविधा शामिल है. इससे XR_ANDROID_hand_mesh extension को ऐक्सेस किया जा सकता है. हैंड मेश की सुविधा, उपयोगकर्ता के हाथों के लिए मेश उपलब्ध कराती है. हाथ के मेश में, हाथ की ज्यामिति को दिखाने वाले त्रिभुजों के वर्टिस होते हैं. इस सुविधा का इस्तेमाल, उपयोगकर्ता के हाथों की असल ज्यामिति को दिखाने वाले, आपकी दिलचस्पी के हिसाब से बनाए गए मेश को विज़ुअलाइज़ेशन के लिए उपलब्ध कराने के लिए किया जाता है.

XR Hands prefab

XR Hands पैकेज में Hands visualizer नाम का एक सैंपल शामिल होता है. इसमें पूरी तरह से रिग किए गए बाएं और दाएं हाथ शामिल होते हैं. इनका इस्तेमाल, उपयोगकर्ता के हाथों को कॉन्टेक्स्ट के हिसाब से रेंडर करने के लिए किया जाता है.

सिस्टम जेस्चर

Android XR में एक सिस्टम जेस्चर शामिल है. इसकी मदद से, उपयोगकर्ता एक मेन्यू खोल सकते हैं. इस मेन्यू से, वे वापस जा सकते हैं, लॉन्चर खोल सकते हैं या चल रहे ऐप्लिकेशन की खास जानकारी देख सकते हैं. उपयोगकर्ता, जिस हाथ से ज़्यादातर काम किए जाते हैं उससे पिंच करके, इस सिस्टम मेन्यू को चालू कर सकता है.

जब उपयोगकर्ता सिस्टम के नेविगेशन मेन्यू से इंटरैक्ट कर रहा हो, तो ऐप्लिकेशन सिर्फ़ हेड ट्रैकिंग इवेंट के लिए जवाब देगा. XR Hands पैकेज यह पता लगा सकता है कि कोई उपयोगकर्ता कब कोई खास कार्रवाई करता है. जैसे, इस सिस्टम नेविगेशन मेन्यू से इंटरैक्ट करना. AimFlags, SystemGesture, और DominantHand को चुनने पर, आपको पता चलता है कि सिस्टम की यह कार्रवाई कब की जाती है. AimFlags के बारे में ज़्यादा जानकारी के लिए, Unity का Enum MetaAimFlags दस्तावेज़ देखें.

XR इंटरैक्शन टूलकिट

XR Interaction Toolkit पैकेज, वीआर और एआर अनुभव बनाने के लिए, कॉम्पोनेंट पर आधारित एक बेहतरीन इंटरैक्शन सिस्टम है. यह एक ऐसा फ़्रेमवर्क उपलब्ध कराता है जो Unity इनपुट इवेंट से 3D और यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन उपलब्ध कराता है. यह इंटरैक्शन टास्क के साथ काम करता है. जैसे, हैप्टिक फ़ीडबैक, विज़ुअल फ़ीडबैक, और लोकोमोशन.

OpenXR™ और OpenXR लोगो, The Khronos Group Inc. के मालिकाना हक वाले ट्रेडमार्क हैं. इन्हें चीन, यूरोपियन यूनियन, जापान, और यूनाइटेड किंगडम में ट्रेडमार्क के तौर पर रजिस्टर किया गया है.