एआर फ़ाउंडेशन के लिए ARCore एक्सटेंशन का इस्तेमाल शुरू करना

एआर फ़ाउंडेशन पैकेज के लिए वैकल्पिक ARCore एक्सटेंशन, Unity के AR Foundation पैकेज में काम करता है. इससे आपको अपने ऐप्लिकेशन में क्लाउड ऐंकर, कैमरा कॉन्फ़िगरेशन फ़िल्टर, रिकॉर्डिंग और वीडियो चलाने जैसी सुविधाओं का इस्तेमाल करने की सुविधा मिलती है.

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

एआर फ़ाउंडेशन के लिए ARCore एक्सटेंशन को डेवलप करने के लिए, आपको इनकी ज़रूरत होगी:

Android

हार्डवेयर

  • ऐसा Android डिवाइस जिस पर ARCore काम करता हो
  • आपके डिवाइस को डेवलपमेंट मशीन से कनेक्ट करने के लिए यूएसबी केबल

सॉफ़्टवेयर

iOS

हार्डवेयर

  • ARKit के साथ काम करने वाला, ARCore वाला डिवाइस
  • आपके डिवाइस को डेवलपमेंट मशीन से कनेक्ट करने के लिए यूएसबी केबल

सॉफ़्टवेयर

ARCore एक्सटेंशन पैकेज इंस्टॉल करें

एआर फ़ाउंडेशन के लिए ARCore एक्सटेंशन इंस्टॉल करने के लिए, यह तरीका अपनाएं.

बंडल की गई डिपेंडेंसी

  1. पक्का करें कि आपने डेवलपमेंट एनवायरमेंट में एआर फ़ाउंडेशन इंस्टॉल और कॉन्फ़िगर किया हो.
  2. कोई नया Unity प्रोजेक्ट खोलें या नया प्रोजेक्ट बनाएं.
  3. टारगेट बनाने के लिए अपनी पसंद का प्लैटफ़ॉर्म चुनें:
    1. File मेन्यू से, Build Settings को चुनें.
    2. अपनी पसंद के टारगेट प्लैटफ़ॉर्म के मुताबिक, Android या iOS चुनें.
    3. Switch Platform पर क्लिक करें.
  4. सबसे नया ARCore एक्सटेंशन पैकेज इंपोर्ट करें:

    1. Window > Package Manager पर नेविगेट करें.
    2. बटन पर क्लिक करें और ड्रॉप-डाउन मेन्यू से Add package from git URL... विकल्प चुनें.

    3. इस यूआरएल को टेक्स्ट फ़ील्ड में चिपकाएं:

      https://github.com/google-ar/arcore-unity-extensions.git
      
    4. Add पर क्लिक करें.

EDM4U के बिना

डिफ़ॉल्ट रूप से, ARCore एक्सटेंशन कई दूसरी डिपेंडेंसी के साथ बंडल किए गए होते हैं. Unity के लिए बाहरी डिपेंडेंस मैनेजर के अलग-अलग वर्शन पर निर्भर अन्य लाइब्रेरी (उदाहरण के लिए, Firebase Analytics) का इस्तेमाल करने पर, तय नहीं की गई कार्रवाई हो सकती है. इसकी वजह से, डिपेंडेंट सही तरीके से काम करना बंद कर सकते हैं.

लाइब्रेरी वर्शनिंग के बीच टकराव रोकने के लिए, बंडल की गई डिपेंडेंसी के बिना ARCore एक्सटेंशन इंस्टॉल करें:

  1. EDM4U रिलीज़ के बिना ARCore एक्सटेंशन और com.google.external-dependency-manager को डाउनलोड करें,
  2. .tgz फ़ाइलों के साथ यूपीएम पैकेज इंपोर्ट करने और इस क्रम में पैकेज इंस्टॉल करने से जुड़े निर्देशों का पालन करें:
    1. com.google.external-dependency-manager,
    2. ARCore एक्सटेंशन (EDM4U के बिना).

ARCore Extensions इंस्टॉल करने पर, Unity ज़रूरी डिपेंडेंसी का सही वर्शन भी अपने-आप इंस्टॉल कर देगा:

  • AR Foundation
  • ARCore XR Plugin (Android को टारगेट करते समय इस्तेमाल किया जाता है)
  • ARKit XR Plugin (iOS को टारगेट करते समय इस्तेमाल किया जाता है)

यह डिपेंडेंसी, हो सकता है कि Package Manager > Package: In project व्यू में न दिखे. हालांकि, पैकेज को Packages में मौजूद Project विंडो में देखा जा सकता है

ARCore एक्सटेंशन सेट अप करें

एआर फ़ाउंडेशन 4.x

  1. Hierarchy पैनल में, राइट क्लिक करें और नीचे दिए गए गेम ऑब्जेक्ट (अगर पहले से जोड़े नहीं गए हैं) जोड़ें:

    • XR > AR Session
    • XR > AR Session Origin
    • XR > ARCore Extensions
  2. Hierarchy पैनल में, ARCore Extensions पैकेज चुनें.

  3. Inspector पैनल में, इनमें से हर फ़ील्ड के लिए, टारगेट बटन पर क्लिक करें और हर फ़ील्ड को उससे जुड़े गेम ऑब्जेक्ट से जोड़ने का तरीका नीचे बताया गया है:

    • Session: अपने सीन के AR Session का इस्तेमाल करें.
    • AR Session Origin: अपने सीन के AR Session Origin का इस्तेमाल करें.
    • Camera Manager: अपने सीन के AR Camera का इस्तेमाल करें.
  4. इसके अलावा, क्लाउड ऐंकर और कैमरा कॉन्फ़िगरेशन फ़िल्टर के लिए, इन ऐसेट को बनाया और कनेक्ट किया जा सकता है.

    1. Project > Assets पैनल में राइट क्लिक करके, Create > XR > ARCore Extensions Config को चुनें.

    2. Project > Assets पैनल में राइट क्लिक करके, Create > XR > Camera Config Filter को चुनें.

    3. Hierarchy पैनल में, ARCore Extensions पैकेज चुनें.

    4. Inspector पैनल के ARCore Extensions Config फ़ील्ड में, टारगेट बटन पर क्लिक करें और ARCoreExtensionsConfigऐसेट से कनेक्ट करें.

    5. Inspector पैनल के Camera Config Filter फ़ील्ड में, टारगेट बटन पर क्लिक करें और ARCoreExtensionsCameraConfigFilterऐसेट से कनेक्ट करें.

      ज़्यादा जानने के लिए, क्लाउड ऐंकर डेवलपर की गाइड और कैमरा कॉन्फ़िगर करने से जुड़ी गाइड देखें.

    6. अगर Unity वर्शन 2020.3 से पहले का वर्शन इस्तेमाल किया जा रहा है, तो:

      • प्रोजेक्ट सेटिंग > प्लेयर > Android > पब्लिश करने की सेटिंग > बिल्ड में कस्टम ग्रेडल प्रॉपर्टी टेंप्लेट चुनें.

ऊपर दिए गए सभी ARCore एक्सटेंशन फ़ील्ड को सही तरीके से कनेक्ट करने के बाद, आपका ARCore एक्सटेंशन Inspector पैनल ऐसा दिखता है:

एआर फ़ाउंडेशन 5.x

  1. Hierarchy पैनल में, राइट क्लिक करें और नीचे दिए गए गेम ऑब्जेक्ट (अगर पहले से जोड़े नहीं गए हैं) जोड़ें:

    • XR > AR Session
    • XR > XR Origin (Mobile AR)
    • XR > ARCore Extensions
  2. Hierarchy पैनल में, ARCore Extensions पैकेज चुनें.

  3. Inspector पैनल में, इनमें से हर फ़ील्ड के लिए, टारगेट बटन पर क्लिक करें और हर फ़ील्ड को उससे जुड़े गेम ऑब्जेक्ट से जोड़ने का तरीका नीचे बताया गया है:

    • Session: अपने सीन के AR Session का इस्तेमाल करें.
    • XR Origin: अपने सीन के XR Origin का इस्तेमाल करें.
    • Camera Manager: अपने सीन के AR Camera का इस्तेमाल करें.
  4. इसके अलावा, क्लाउड ऐंकर और कैमरा कॉन्फ़िगरेशन फ़िल्टर के लिए, इन ऐसेट को बनाया और कनेक्ट किया जा सकता है.

    1. Project > Assets पैनल में राइट क्लिक करके, Create > XR > ARCore Extensions Config को चुनें.

    2. Project > Assets पैनल में राइट क्लिक करके, Create > XR > Camera Config Filter को चुनें.

    3. Hierarchy पैनल में, ARCore Extensions पैकेज चुनें.

    4. Inspector पैनल के ARCore Extensions Config फ़ील्ड में, टारगेट बटन पर क्लिक करें और ARCoreExtensionsConfigऐसेट से कनेक्ट करें.

    5. Inspector पैनल के Camera Config Filter फ़ील्ड में, टारगेट बटन पर क्लिक करें और ARCoreExtensionsCameraConfigFilterऐसेट से कनेक्ट करें.

      ज़्यादा जानने के लिए, क्लाउड ऐंकर डेवलपर की गाइड और कैमरा कॉन्फ़िगर करने से जुड़ी गाइड देखें.

    6. अगर Unity वर्शन 2020.3 से पहले का वर्शन इस्तेमाल किया जा रहा है, तो:

      • प्रोजेक्ट सेटिंग > प्लेयर > Android > पब्लिश करने की सेटिंग > बिल्ड में कस्टम ग्रेडल प्रॉपर्टी टेंप्लेट चुनें.

ऊपर दिए गए सभी ARCore एक्सटेंशन फ़ील्ड को सही तरीके से कनेक्ट करने के बाद, आपका ARCore एक्सटेंशन Inspector पैनल ऐसा दिखता है:

प्रॉपर्टी सेट अप करने के बारे में ज़्यादा जानकारी के लिए, Unity की प्रॉपर्टी में बदलाव करने की गाइड देखें.

सैंपल प्रोजेक्ट

एआर फ़ाउंडेशन के लिए ARCore एक्सटेंशन के साथ बंडल किए गए ऐसे सैंपल प्रोजेक्ट हैं जिनका इस्तेमाल करके आप अपने प्रोजेक्ट बनाना शुरू कर सकते हैं.

  1. Window मेन्यू में जाकर, Package Manager खोलें और ARCore Extensions पैकेज चुनें.

  2. Samples में जाकर, नीचे दिए गए सैंपल प्रोजेक्ट के लिए, Import पर क्लिक करें.

नीचे दिए गए सैंपल प्रोजेक्ट, GitHub के डेटा स्टोर करने की जगह से इंपोर्ट किए गए हैं:

  • भौगोलिक डेटा (सिर्फ़ Android के लिए) - दुनिया भर में एआर (ऑगमेंटेड रिएलिटी) का इस्तेमाल करें. साथ ही, Google Street View के दायरे में आने वाले किसी भी इलाके से, रिमोट तरीके से कॉन्टेंट अटैच करें. ज़्यादा जानकारी के लिए, Geospatial API के बारे में जानकारी देखें.

  • PersistentCloudAnchors (Android और iOS) - असली जगहों पर आधारित डिजिटल जानकारी की इंटरैक्टिव लेयर से असली दुनिया में लगातार एआर (ऑगमेंटेड रिएलिटी) अनुभव बनाएं. साथ ही, डिज़ाइन के ऐसे अनुभव तैयार करें जिन्हें समय के साथ कई लोग अलग-अलग डिवाइस पर शेयर कर सकते हैं. ज़्यादा जानकारी के लिए, Cloud ऐंकर के बारे में जानकारी देखें.

आगे क्या करना है

एआर फ़ाउंडेशन के लिए ARCore एक्सटेंशन की मदद से, अब आप अपने ऐप्लिकेशन में क्लाउड ऐंकर और कैमरा कॉन्फ़िगरेशन का इस्तेमाल कर सकते हैं.