एआर फ़ाउंडेशन की मदद से शुरुआत करें

Unity का AR Foundation, एक क्रॉस-प्लैटफ़ॉर्म फ़्रेमवर्क है. इसकी मदद से, ऑगमेंटेड रिएलिटी (एआर) के अनुभवों को एक बार लिखा जा सकता है. इसके बाद, बिना किसी बदलाव के Android या iOS डिवाइसों के लिए इसे बनाया जा सकता है. यह फ़्रेमवर्क, Unity के AR Foundation पैकेज के ज़रिए उपलब्ध है.

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

मौजूदा प्रोजेक्ट को माइग्रेट या अपग्रेड करना

• किसी मौजूदा प्रोजेक्ट को Unity के लिए, (अब काम नहीं करने वाले) ARCore SDK टूल से, Unity के AR Foundation और ARCore एक्सटेंशन पर माइग्रेट करने के लिए, डेटा को दूसरी जगह भेजने से जुड़ी गाइड देखें.
• किसी मौजूदा प्रोजेक्ट को AR Foundation के पुराने वर्शन से अपग्रेड करने के लिए, Unity की अपग्रेड और माइग्रेशन गाइड देखें.

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

टारगेट किए गए प्लैटफ़ॉर्म के हिसाब से, AR Foundation पैकेज के लिए ये ज़रूरी हैं:

AndroidiOS

हार्डवेयर

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

सॉफ़्टवेयर

• Unity 2019.4.3f1 या इसके बाद का वर्शन, जिसमें Android Build Support हो

हार्डवेयर

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

सॉफ़्टवेयर

• Unity 2019.4.3f1 या इसके बाद का वर्शन, जिसमें iOS के लिए बने वर्शन बनाने की सुविधा हो
• Xcode 11.0 या इसके बाद का वर्शन

AR Foundation इंस्टॉल करना

AR Foundation Unity पैकेज इंस्टॉल करने के लिए, यह तरीका अपनाएं.

1. कोई मौजूदा Unity प्रोजेक्ट खोलें या नया 3D प्रोजेक्ट बनाएं.
2. Window > Package Manager पर नेविगेट करें.

3. Packages के बगल में, Unity Registry को चुनें.

   

4. खोज बार में, "AR Foundation" लिखें.

   

5. Install पर क्लिक करें.

   

6. रेंडर पाइपलाइन कॉन्फ़िगर करना

   AR Foundation 4.xAR Foundation 5.xAR Foundation 6.x
   ध्यान दें: पहले से मौजूद रेंडर पाइपलाइन और यूनिवर्सल रेंडर पाइपलाइन, दोनों ही AR Foundation पैकेज के साथ काम करती हैं. हालांकि, यूनिवर्सल रेंडर पाइपलाइन को कॉन्फ़िगर करने के लिए, कुछ और चरण पूरे करने पड़ते हैं.
   ध्यान दें: पहले से मौजूद रेंडर पाइपलाइन और यूनिवर्सल रेंडर पाइपलाइन, दोनों ही AR Foundation पैकेज के साथ काम करती हैं. हालांकि, यूनिवर्सल रेंडर पाइपलाइन को कॉन्फ़िगर करने के लिए, कुछ और चरण पूरे करने पड़ते हैं.
   ध्यान दें: डिफ़ॉल्ट यूनिवर्सल रेंडर पाइपलाइन को कॉन्फ़िगर करने के लिए, कुछ और चरण पूरे करने होंगे. अगर आप चाहें, तो पहले से मौजूद रेंडर पाइपलाइन पर स्विच किया जा सकता है. ऐसा इसलिए, क्योंकि दोनों ही एआर फ़ाउंडेशन पैकेज के साथ काम करते हैं.

प्लैटफ़ॉर्म के हिसाब से प्लगिन पैकेज इंस्टॉल और चालू करना

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

AndroidiOS

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

1. अपने प्रोजेक्ट में, Window > Package Manager पर जाएं.

2. Packages के बगल में, Unity Registry को चुनें.

   

3. खोज बार में, "ARCore XR प्लग इन" टाइप करें.

   

4. Install पर क्लिक करें.

   

5. Edit > Project Settings पर नेविगेट करें. XR Plug-in Management में, Android टैब खोलें और ARCore को चालू करें.

   

ARKit XR प्लग इन की मदद से, iOS डिवाइसों के लिए ऑगमेंटेड रिएलिटी ऐप्लिकेशन बनाए जा सकते हैं. अगर आपका ऐप्लिकेशन iOS डिवाइसों को टारगेट करता है, तो इसे अपने Unity प्रोजेक्ट में इंस्टॉल करने के लिए यह तरीका अपनाएं. काम करने से जुड़ी किसी भी समस्या से बचने के लिए, AR Foundation पैकेज के वर्शन का ही इस्तेमाल करें.

1. अपने प्रोजेक्ट में, Window > Package Manager पर जाएं.

2. Packages के बगल में, Unity Registry को चुनें.

   

3. खोज बार में, "ARKit XR प्लग इन" टाइप करें.

   

4. Install पर क्लिक करें.

   

5. Edit > Project Settings पर नेविगेट करें. XR Plug-in Management में, iOS टैब खोलें और ARKit को चालू करें.

   

एआर सेशन कॉन्फ़िगर करना और अपने सीन में AR Foundation कॉम्पोनेंट जोड़ना

किसी सीन में एआर प्रोसेस चालू करने के लिए, एआर सेशन की ज़रूरत होती है. जैसे, मोशन ट्रैकिंग, आस-पास के माहौल को समझना, और रोशनी का अनुमान लगाना. एआर सेशन के साथ काम करने के लिए, आपको गेम में ये ऑब्जेक्ट जोड़ने होंगे:

AR Foundation 4.xAR Foundation 5.xAR Foundation 6.x

• AR Session: एआर अनुभव के लाइफ़साइकल को कंट्रोल करता है.

• AR Session Origin: एआर निर्देशांक को Unity के वर्ल्ड निर्देशांक में बदलता है.

नए गेम ऑब्जेक्ट जोड़ने से पहले, डिफ़ॉल्ट Main Camera मिटाएं. इसे AR Session Origin में नए AR Camera से बदल दिया जाएगा.

अपने सीन में नए एआर गेम आइटम जोड़ें: Hierarchy पैनल पर राइट क्लिक करें और XR चुनें. नया AR Session और नया AR Session Origin गेम ऑब्जेक्ट जोड़ें.

• AR Session: एआर अनुभव के लाइफ़साइकल को कंट्रोल करता है.

• XR Origin: एआर निर्देशांक को Unity के वर्ल्ड निर्देशांक में बदलता है.

नए गेम ऑब्जेक्ट जोड़ने से पहले, डिफ़ॉल्ट Main Camera मिटाएं. इसे XR Origin में नए AR Camera से बदल दिया जाएगा.

अपने सीन में नए एआर गेम आइटम जोड़ें: Hierarchy पैनल पर राइट क्लिक करें और XR चुनें. नया AR Session और नया XR Origin गेम ऑब्जेक्ट जोड़ें.

• AR Session: एआर अनुभव के लाइफ़साइकल को कंट्रोल करता है.

• XR Origin: एआर निर्देशांक को Unity के वर्ल्ड निर्देशांक में बदलता है.

नए गेम ऑब्जेक्ट जोड़ने से पहले, डिफ़ॉल्ट Main Camera मिटाएं. इसे XR Origin में नए AR Camera से बदल दिया जाएगा.

अपने सीन में नए एआर गेम आइटम जोड़ें: Hierarchy पैनल पर राइट क्लिक करें और XR चुनें. नया AR Session और नया XR Origin गेम ऑब्जेक्ट जोड़ें.

प्लेयर की सेटिंग कॉन्फ़िगर करना

AndroidiOS

1. Build Settings विंडो खोलने के लिए, File > Build Settings पर जाएं.
2. Platform में जाकर, Android चुनें और Switch Platform पर क्लिक करें.
3. Player Settings पर क्लिक करें.

4. ये बदलाव लागू करें:

   Player Settings > …	मान
   Other Settings > Rendering	Auto Graphics API से सही का निशान हटाएं. अगर Vulkan, Graphics APIs में शामिल है, तो उसे हटा दें. ऐसा इसलिए, क्योंकि फ़िलहाल ARCore में Vulkan का इस्तेमाल नहीं किया जा सकता.
   Other Settings > Package Name	Java पैकेज के नाम के फ़ॉर्मैट का इस्तेमाल करके, एक यूनीक ऐप्लिकेशन आईडी बनाएं. उदाहरण के लिए, com.example.helloAR का इस्तेमाल करें.
   Other Settings > Minimum API Level	अगर आपने एआर की ज़रूरत है वाला ऐप्लिकेशन बनाया है, तो Android 7.0 'Nougat' (API Level 24) or higher की जानकारी दें. अगर एआर की सुविधा का इस्तेमाल करना ज़रूरी नहीं है, तो Android API Level 19 or higher की वैल्यू सबमिट करें.
   Other Settings > Scripting Backend	अगले चरण में ARM64 के साथ काम करने की सुविधा चालू करने के लिए, Mono के बजाय IL2CPP चुनें. ऐप्लिकेशन डेवलप करने के दौरान: Mono + 32-बिट (ARMv7) का इस्तेमाल करें FAT (32-बिट + 64-बिट) ARCore APK इंस्टॉल करना Play Store पर शिप करते समय: IL2CPP का इस्तेमाल करें Play Store के 64-बिट वर्शन की ज़रूरी शर्तों को पूरा करने के लिए, 32-बिट (ARMv7) और 64-बिट (ARM64) दोनों को चालू करना ज़रूरी नहीं (2018.3 और उसके बाद के वर्शन में काम करता है): Build Settings में, Android App Bundles को चालू करें
   Other Settings > Target Architectures	Google Play के 64-बिट वर्शन की ज़रूरी शर्त को पूरा करने के लिए, ARM64 (64-बिट ARM) को चालू करें. 32-बिट वाले डिवाइसों के साथ काम करने के लिए, ARMv7 (32-बिट ARM) को चालू रखें.

1. Build Settings विंडो खोलने के लिए, File > Build Settings पर जाएं.
2. Platform में जाकर, iOS चुनें और Switch Platform पर क्लिक करें.
3. Player Settings पर क्लिक करें.

4. ये सेटिंग कॉन्फ़िगर करें:

   Player Settings > …	मान
   Other Settings > Bundle Identifier	अपने ऐप्लिकेशन का नाम, रिवर्स डीएनएस फ़ॉर्मैट में जोड़ें. उदाहरण के लिए, com.mycompany.myapp का इस्तेमाल करें.
   Other Settings > Camera usage description	एआर (उदाहरण के लिए, ARKit) के इस्तेमाल के बारे में बताने के लिए ब्यौरा डालें.
   Other Settings > Target minimum iOS version	11.0 या उससे ज़्यादा
   Other Settings > Architecture	ARM64

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

• ARCore एक्सटेंशन पैकेज का इस्तेमाल शुरू करें. यह पैकेज ज़रूरी नहीं है. यह AR Foundation फ़्रेमवर्क के लिए, ARCore की अतिरिक्त सुविधाएं उपलब्ध कराता है.
• Unity के AR Foundation का इस्तेमाल करके, एआर गेम बनाएं (कोडलैब).