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