अपने ऐप्लिकेशन की सेटिंग कॉन्फ़िगर करें, ताकि वह Geospatial API का इस्तेमाल कर सके.
ज़रूरी शर्तें
आगे बढ़ने से पहले, पक्का करें कि आपने एआर के बुनियादी कॉन्सेप्ट और ARCore सेशन को कॉन्फ़िगर करने का तरीका समझ लिया हो.
Geospatial API के बारे में ज़्यादा जानकारी के लिए, Geospatial API के बारे में जानकारी देखें.
अगर आपने ARCore का इस्तेमाल पहले कभी नहीं किया है, तो सॉफ़्टवेयर और हार्डवेयर की ज़रूरी शर्तों, ऐप्लिकेशन से जुड़ी ज़रूरतों, और इस्तेमाल किए जा रहे प्लैटफ़ॉर्म से जुड़ी अन्य जानकारी के लिए, शुरू करने का तरीका देखें.
ARCore Geospatial API का इस्तेमाल करने के लिए, आपके प्रोजेक्ट में AR Foundation और AR Foundation के लिए ARCore एक्सटेंशन काम करने चाहिए.
ARCore API चालू करना
अपने ऐप्लिकेशन में विज़ुअल पोज़िशनिंग सिस्टम (वीपीएस) का इस्तेमाल करने से पहले, आपको किसी नए या मौजूदा Google Cloud प्रोजेक्ट में ARCore API को चालू करना होगा. यह सेवा, जियोस्पेशल ऐंकर को होस्ट करने, सेव करने, और रिज़ॉल्व करने के लिए ज़िम्मेदार है.
बिना पासकोड के अनुमति देने की सुविधा को प्राथमिकता दी जाती है. हालांकि, एपीआई पासकोड की मदद से अनुमति देने की सुविधा भी काम करती है.
अपने ऐप्लिकेशन में ज़रूरी लाइब्रेरी जोड़ना
अपने ऐप्लिकेशन को ARCore API को कॉल करने की अनुमति देने के बाद, आपको अपने ऐप्लिकेशन में जियोस्पेशल सुविधाएं चालू करने के लिए लाइब्रेरी जोड़नी होंगी.
- बदलाव करें > प्रोजेक्ट सेटिंग > XR प्लग-इन मैनेजमेंट > ARCore एक्सटेंशन पर जाएं.
- ज़रूरी नहीं सुविधाएं में जाकर, भौगोलिक डेटा चुनें.
सेशन कॉन्फ़िगरेशन में, भौगोलिक डेटा से जुड़ी सुविधाएं चालू करना
अपने ऐप्लिकेशन में जियोस्पेशल फ़ंक्शन चालू करने के बाद, अपने ऐप्लिकेशन के एआर सेशन कॉन्फ़िगरेशन में जियोस्पेशल सुविधाएं चालू करें, ताकि वह ARCore API के साथ कम्यूनिकेट कर सके:
- पक्का करें कि प्रोजेक्ट Assets फ़ोल्डर में ARCoreextensionsConfig स्क्रिप्ट किया जा सकने वाला ऑब्जेक्ट है. ऐसेट बनाने के लिए, ऐसेट पैनल में राइट क्लिक करें. इसके बाद, बनाएं > XR > ARCore एक्सटेंशन कॉन्फ़िगरेशन चुनें.
अपने ऐसेट फ़ोल्डर में, स्क्रिप्ट करने लायक ARCoreExtensionsConfig ऑब्जेक्ट चुनें और जियोस्पेशल मोड को चालू है पर सेट करें.
ARCoreExtensionConfig कॉन्फ़िगरेशन का इस्तेमाल करने के लिए, ARCore एक्सटेंशन गेम ऑब्जेक्ट को कॉन्फ़िगर करें. क्रम पैनल में, ARCore एक्सटेंशन गेम ऑब्जेक्ट ढूंढें. यह वह ऑब्जेक्ट है जिसे आपने ARCore एक्सटेंशन को पहली बार सेट अप करते समय बनाया था. इसके बाद, ARCore एक्सटेंशन कॉन्फ़िगरेशन फ़ील्ड को अपने एसेट फ़ोल्डर में मौजूद, स्क्रिप्ट किए जा सकने वाले ARCoreExtensionsConfig ऑब्जेक्ट से कनेक्ट करें.
उपयोगकर्ता को डिवाइस के डेटा के इस्तेमाल की अनुमति देने के लिए कहना
ARCore Geospatial API का इस्तेमाल करने वाले ऐप्लिकेशन को उपयोगकर्ता को एक प्रॉम्प्ट दिखाना होगा, ताकि वह अपने डिवाइस के डेटा का इस्तेमाल करने की अनुमति दे सके. ज़्यादा जानकारी के लिए, उपयोगकर्ता की निजता से जुड़ी ज़रूरी शर्तें देखें.
देखें कि यह सुविधा किन डिवाइसों पर काम करती है
ARCore के साथ काम करने वाले सभी डिवाइस, Geospatial API के साथ काम नहीं करते. यह देखने के लिए कि उपयोगकर्ता का डिवाइस, AREarthManager.IsGeospatialModeSupported()
अगर आपको FeatureSupported.Unsupported दिखता है, तो सेशन को कॉन्फ़िगर करने की कोशिश न करें.
रनटाइम के दौरान, उपयोगकर्ता से जगह की जानकारी की अनुमतियां मांगना
ARCoreExtensions.Update() में जियोस्पेशल मोड चालू होने पर, ARCore एक्सटेंशन अपने-आप जगह की जानकारी से जुड़ी अनुमतियों का अनुरोध करता है. अगर उपयोगकर्ता, सटीक जगह की जानकारी की अनुमति नहीं देता है, तो सेशन फिर से शुरू नहीं हो पाता और "अनुमति नहीं दी गई" गड़बड़ी का मैसेज दिखता है. यह एक गड़बड़ी है, जिसकी वजह से प्रोसेस बंद हो गई है. अनुमति का अनुरोध फिर से ट्रिगर करने के लिए, आपको डिवाइस को फिर से चालू करना होगा.
डिवाइस की मौजूदा जगह के हिसाब से, जगह के हिसाब से उपलब्धता देखें
जियोस्पेशल पोज़ का पता लगाने के लिए, Geospatial API VPS और जीपीएस, दोनों का इस्तेमाल करता है. इसलिए, जब तक डिवाइस की जगह की जानकारी का पता चलता है, तब तक एपीआई का इस्तेमाल किया जा सकता है. जिन जगहों पर जीपीएस की सटीक जानकारी नहीं मिलती, जैसे कि इनडोर स्पेस और शहर के घने इलाके, वहां एपीआई वीपीएस कवरेज का इस्तेमाल करके सटीक पोज़ जनरेट करेगा. सामान्य स्थितियों में, वीपीएस से जगह की सटीक जानकारी करीब 5 मीटर और घूमने की सटीक जानकारी 5 डिग्री तक मिल सकती है. AREarthManager.CheckVpsAvailability() का इस्तेमाल करके पता लगाएं कि किसी जगह पर VPS की सुविधा उपलब्ध है या नहीं.
Geospatial API का इस्तेमाल उन इलाकों में भी किया जा सकता है जहां वीपीएस कवरेज नहीं है. अगर आप किसी ऐसे आउटडोर लोकेशन पर हैं जहां ऊपर से कोई रुकावट नहीं है या बहुत कम रुकावटें हैं, तो जीपीएस की मदद से पोज़ को सटीक तरीके से जनरेट किया जा सकता है.
आगे क्या करना है
- असल दुनिया में उपयोगकर्ता के डिवाइस की जगह की सटीक जानकारी का पता लगाने के लिए, डिवाइस के कैमरे की जियोस्पेशल पोज़ पाएं.
- डिवाइस की जगह की जानकारी के लिए, वीपीएस की उपलब्धता देखें.