अपने ऐप्लिकेशन की सेटिंग कॉन्फ़िगर करें, ताकि वह 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 के साथ कम्यूनिकेट कर सके:
- पक्का करें कि प्रोजेक्ट के ऐसेट फ़ोल्डर में, स्क्रिप्ट करने लायक ARCoreExtensionsConfig ऑब्जेक्ट मौजूद हो. इसे बनाने के लिए, ऐसेट पैनल में राइट क्लिक करें. इसके बाद, बनाएं > XR > ARCore एक्सटेंशन कॉन्फ़िगरेशन को चुनें.
अपने ऐसेट फ़ोल्डर में, स्क्रिप्ट करने लायक ARCoreExtensionsConfig ऑब्जेक्ट चुनें और जियोस्पेशल मोड को चालू है पर सेट करें.
ARCoreExtensionsConfig कॉन्फ़िगरेशन का इस्तेमाल करने के लिए, ARCore Extensions गेम ऑब्जेक्ट को कॉन्फ़िगर करें. क्रम पैनल में, 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 की सुविधा उपलब्ध है या नहीं.
जियोस्पेशल एपीआई का इस्तेमाल उन इलाकों में भी किया जा सकता है जहां वीपीएस की सुविधा उपलब्ध नहीं है. अगर आप किसी ऐसे आउटडोर लोकेशन पर हैं जहां ऊपर से कोई रुकावट नहीं है या बहुत कम रुकावटें हैं, तो जीपीएस की मदद से, पोज़ को सटीक तरीके से जनरेट किया जा सकता है.
आगे क्या करना है
- डिवाइस के कैमरे की जियोस्पेशल पोज़िशन की जानकारी पाना, ताकि असल दुनिया में उपयोगकर्ता के डिवाइस की सटीक जगह की जानकारी मिल सके.
- किसी डिवाइस की दी गई जगह पर वीपीएस की उपलब्धता देखना.