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

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

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

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

Geospatial API के बारे में ज़्यादा जानकारी के लिए, Geospatial API के बारे में जानकारी देखें.

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

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

ARCore API चालू करना

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

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

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

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

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

सेशन कॉन्फ़िगरेशन में, भौगोलिक डेटा से जुड़ी सुविधाएं चालू करना

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

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

  2. अपने ऐसेट फ़ोल्डर में, स्क्रिप्ट करने लायक ARCoreExtensionsConfig ऑब्जेक्ट चुनें और जियोस्पेशल मोड को चालू है पर सेट करें.

  3. ARCoreExtensionsConfig कॉन्फ़िगरेशन का इस्तेमाल करने के लिए, ARCore Extensions गेम ऑब्जेक्ट को कॉन्फ़िगर करें. क्रम पैनल में, ARCore एक्सटेंशन गेम ऑब्जेक्ट ढूंढें. यह वह ऑब्जेक्ट है जिसे आपने ARCore एक्सटेंशन को पहली बार सेट अप करते समय बनाया था. इसके बाद, ARCore एक्सटेंशन कॉन्फ़िगरेशन फ़ील्ड को अपने एसेट फ़ोल्डर में मौजूद, स्क्रिप्ट किए जा सकने वाले ARCoreExtensionsConfig ऑब्जेक्ट से कनेक्ट करें.

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

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

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

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

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

रनटाइम की अनुमति के अनुरोधों को ट्रिगर करने वाली स्क्रिप्ट में, Unity की जगह की जानकारी से जुड़ी सेवाओं को चालू करने के लिए, यह तरीका अपनाएं:

  1. Project Settings > iOS > Other Settings > Location Usage Description में, उस ऐप्लिकेशन का नाम डालें जो अनुमतियों का अनुरोध कर रहा है.

  2. रनटाइम के दौरान अनुमति का अनुरोध ट्रिगर करने के लिए, Unity की जगह की जानकारी की सेवाएं चालू करें. इसके लिए, यह तरीका अपनाएं:

    public void OnEnable()
{
    Input.location.Start();
}

public void OnDisable()
{
    Input.location.Stop();
}

    ज़्यादा जानकारी के लिए, Unity का LocationService दस्तावेज़ देखें.

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

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

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

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