Android को टारगेट करने वाले अपने Unity (AR Foundation) ऐप्लिकेशन के लिए जियोस्पेशियल एपीआई चालू करें

अपने ऐप्लिकेशन की सेटिंग कॉन्फ़िगर करें, ताकि वह Geospatial API का इस्तेमाल कर सके.

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

आगे बढ़ने से पहले, पक्का करें कि आपने बुनियादी एआर (ऑगमेंटेड रिएलिटी) सिद्धांत और ARCore सेशन को कॉन्फ़िगर करने का तरीका समझ लिया है.

भौगोलिक एपीआई के बारे में ज़्यादा जानकारी के लिए, भौगोलिक डेटा के एपीआई के बारे में जानकारी देखें.

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

ARCore Geospatial API का इस्तेमाल करने के लिए, आपके प्रोजेक्ट में AR Foundation और AR Foundation के लिए ARCore एक्सटेंशन काम करना ज़रूरी है.

ARCore API चालू करना

अपने ऐप्लिकेशन में विज़ुअल पोज़िशनिंग सिस्टम (वीपीएस) का इस्तेमाल करने से पहले, आपको Google Cloud के नए या मौजूदा प्रोजेक्ट में ARCore API चालू करना होगा. जियोस्पेशियल ऐंकर को होस्ट करने, सेव करने, और समस्या ठीक करने की ज़िम्मेदारी इस सेवा की है.

कुंजी के बिना पुष्टि करने की सुविधा को प्राथमिकता दी जाती है, लेकिन एपीआई पासकोड से अनुमति देने की सुविधा भी काम करती है.

अपने ऐप्लिकेशन में ज़रूरी लाइब्रेरी जोड़ना

ऐप्लिकेशन को ARCore एपीआई को कॉल करने की अनुमति देने के बाद, आपको अपने ऐप्लिकेशन में जियोस्पेशियल सुविधाएं चालू करने के लिए लाइब्रेरी जोड़नी होंगी.

  1. बदलाव करें > प्रोजेक्ट सेटिंग > XR प्लग-इन मैनेजमेंट > ARCore एक्सटेंशन पर जाएं.
  2. वैकल्पिक सुविधाएं में जाकर, भौगोलिक डेटा चुनें.

सेशन के कॉन्फ़िगरेशन में जियोस्पेशियल सुविधाएं चालू करें

ऐप्लिकेशन में भौगोलिक डेटा की सुविधा चालू होने के बाद, अपने ऐप्लिकेशन के एआर (ऑगमेंटेड रिएलिटी) सेशन कॉन्फ़िगरेशन में जियोस्पेशियल सुविधाओं को चालू करें, ताकि यह ARCore API के साथ काम कर सके:

  1. पक्का करें कि प्रोजेक्ट Assets फ़ोल्डर में ऐसा ARCoreExtensionConfig स्क्रिप्टेबल ऑब्जेक्ट शामिल है जिसे स्क्रिप्ट किया जा सकता है. एसेट बनाने के लिए, एसेट पैनल में राइट क्लिक करें और बनाएं > XR > ARCore एक्सटेंशन कॉन्फ़िगरेशन चुनें.

  2. अपने ARCoreExtensionsConfig फ़ोल्डर में ARCoreExtensionsConfig स्क्रिप्टेबल ऑब्जेक्ट चुनें और ARCoreExtensionsConfig को ARCoreExtensionsConfig पर सेट करें.

  3. ARCore ExtensionConfig कॉन्फ़िगरेशन का इस्तेमाल करने के लिए ARCore एक्सटेंशन गेम ऑब्जेक्ट कॉन्फ़िगर करें. क्रम पैनल में, ARCore एक्सटेंशन गेम ऑब्जेक्ट का पता लगाएं. यह ऑब्जेक्ट, शुरुआत में ARCore एक्सटेंशन सेट अप करते समय बनाया गया था. साथ ही, ARCore एक्सटेंशन कॉन्फ़िगरेशन फ़ील्ड को अपने Assets फ़ोल्डर के ARCoreTrackingConfig स्क्रिप्ट किए जा सकने वाले ऑब्जेक्ट से कनेक्ट करें.

उपयोगकर्ता को डिवाइस के डेटा के इस्तेमाल की अनुमति देने का अनुरोध करें

ARCore भौगोलिक एपीआई का इस्तेमाल करने वाले ऐप्लिकेशन को उपयोगकर्ता से यह अनुरोध करना चाहिए कि वह यह स्वीकार करे और अपने डिवाइस का डेटा इस्तेमाल करने की अनुमति दे. ज़्यादा जानकारी के लिए, उपयोगकर्ता की निजता से जुड़ी ज़रूरी शर्तें देखें.

देखें कि डिवाइस पर यह सुविधा काम करती है या नहीं

ARCore के साथ काम करने वाले सभी डिवाइस, Geospatial API के साथ काम नहीं करते. उपयोगकर्ता के डिवाइस पर यह काम करता है या नहीं, यह पता करने के लिए AREarthManager.IsGeospatialModeSupported() पर कॉल करें. अगर ऐसा करने पर FeatureSupported.Unsupported पता चलता है, तो सेशन को कॉन्फ़िगर करने की कोशिश न करें.

रनटाइम के दौरान, उपयोगकर्ता से जगह की जानकारी की अनुमतियां मांगें

ARCoreExtensions.Update() में जियोस्पेशियल मोड चालू होने पर, ARCore एक्सटेंशन अपने-आप जगह की जानकारी की सही अनुमतियों का अनुरोध करते हैं. अगर उपयोगकर्ता, जगह की सटीक जानकारी की अनुमति नहीं देता है, तो सेशन फिर से शुरू नहीं होता है और "अनुमति नहीं दी गई" गड़बड़ी दिखती है. यह एक तरह से बंद होने वाली गड़बड़ी है और अनुमति का अनुरोध फिर से ट्रिगर करने के लिए इसे फिर से शुरू करना पड़ता है.

डिवाइस की मौजूदा जगह पर भौगोलिक डेटा की उपलब्धता देखना

भौगोलिक पोज़ तय करने के लिए Geospatial API, VPS और जीपीएस को एक साथ इस्तेमाल करता है, इसलिए एपीआई का इस्तेमाल तब तक किया जा सकता है, जब तक डिवाइस, जगह की जानकारी देने के लिए तैयार है. जिन इलाकों में जीपीएस की सटीक जानकारी नहीं होती है वहां के लिए, यह एपीआई ज़्यादा सटीक पोज़ जनरेट करने के लिए, वीपीएस कवरेज का इस्तेमाल करेगा. जैसे, इनडोर स्पेस और घना शहरी माहौल. सामान्य स्थितियों में, वीपीएस करीब 5 मीटर की स्थिति सटीक और 5 डिग्री घूमने की सटीक जानकारी दे सकता है. AREarthManager.CheckVpsAvailability() का इस्तेमाल करके, पता लगाएं कि दी गई जगह में VPS कवरेज है या नहीं.

भौगोलिक एपीआई का इस्तेमाल उन इलाकों में भी किया जा सकता है जहां वीपीएस कवरेज नहीं है. अगर खुली जगह में हवाई जहाज़ में कोई रुकावट नहीं आती है या आस-पास कोई रुकावट नहीं होती है, तो बेहतर पोज़ बनाने के लिए जीपीएस काफ़ी मददगार हो सकता है.

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