अपने एआर फ़ाउंडेशन ऐप्लिकेशन में एआर की सुविधा चालू करें (सिर्फ़ Android के लिए)

नए या मौजूदा ऐप्लिकेशन में ऑगमेंटेड रिएलिटी (एआर) की सुविधाओं का इस्तेमाल करने के लिए, एआर की सुविधा चालू करें.

अपने ऐप्लिकेशन को 'एआर की सुविधा ज़रूरी है' या 'एआर की सुविधा ज़रूरी नहीं है' के तौर पर कॉन्फ़िगर करना

हर डिवाइस पर जगह बचाने के लिए, एआर की सभी सुविधाएं Google Play Services for AR नाम के ऐप्लिकेशन में सेव की जाती हैं. इसे Play Store से अलग से अपडेट किया जाता है. एआर की सुविधाओं का इस्तेमाल करने वाले Android ऐप्लिकेशन, ARCore SDK टूल का इस्तेमाल करके Google Play Services for AR से कम्यूनिकेट करते हैं. एआर की सुविधाओं के साथ काम करने वाले ऐप्लिकेशन को दो तरीकों से कॉन्फ़िगर किया जा सकता है: एआर की सुविधा ज़रूरी है और एआर की सुविधा ज़रूरी नहीं है. इससे यह तय होता है कि ऐप्लिकेशन, Google Play Services for AR ऐप्लिकेशन के साथ कैसे इंटरैक्ट करता है.

एआर की सुविधा ज़रूरी है वाला ऐप्लिकेशन, ARCore के बिना काम नहीं कर सकता. इसके लिए, ऐसे डिवाइस की ज़रूरत होती है जिस पर ARCore काम करता हो और जिस पर Google Play Services for AR इंस्टॉल हो.

  • Google Play Store, एआर की सुविधा ज़रूरी है वाले ऐप्लिकेशन को सिर्फ़ उन डिवाइसों पर उपलब्ध कराएगा जिन पर ARCore काम करता है.
  • जब उपयोगकर्ता, एआर की सुविधा ज़रूरी है वाला ऐप्लिकेशन इंस्टॉल करते हैं, तो Google Play Store उनके डिवाइस पर Google Play Services for AR को अपने-आप इंस्टॉल कर देगा. हालांकि, अगर Google Play Services for AR पुराना हो गया है या उसे मैन्युअल तरीके से अनइंस्टॉल कर दिया गया है, तो आपके ऐप्लिकेशन को रनटाइम के दौरान अतिरिक्त जांचें करनी होंगी.

एआर की सुविधा ज़रूरी नहीं है वाला ऐप्लिकेशन, मौजूदा सुविधाओं को बेहतर बनाने के लिए ARCore का इस्तेमाल करता है. इसमें एआर की सुविधाएं उपलब्ध होती हैं. हालांकि, ये सुविधाएं सिर्फ़ उन डिवाइसों पर चालू होती हैं जिन पर ARCore काम करता है और जिन पर Google Play Services for AR इंस्टॉल है.

  • एआर की सुविधा ज़रूरी नहीं है वाले ऐप्लिकेशन, उन डिवाइसों पर इंस्टॉल और चलाए जा सकते हैं जिन पर ARCore काम नहीं करता.
  • जब उपयोगकर्ता, एआर की सुविधा ज़रूरी नहीं है वाला ऐप्लिकेशन इंस्टॉल करते हैं, तो Google Play Store उनके डिवाइस पर Google Play Services for AR को अपने-आप इंस्टॉल नहीं करेगा.
एआर की सुविधा ज़रूरी हैएआर की सुविधा ज़रूरी नहीं है
एआर की सुविधा का इस्तेमाल आपके ऐप्लिकेशन को बुनियादी सुविधाओं के लिए ARCore की ज़रूरत होती है. ARCore, आपके ऐप्लिकेशन की सुविधाओं को बेहतर बनाता है. आपका ऐप्लिकेशन, ARCore की सुविधा के बिना भी चल सकता है.
Play Store पर दिखने की सुविधा आपका ऐप्लिकेशन, Play Store पर सिर्फ़ उन डिवाइसों पर दिखता है जिन पर ARCore काम करता है. आपका ऐप्लिकेशन, लिस्टिंग की सामान्य प्रोसेस के तहत दिखता है.
Google Play Services for AR को इंस्टॉल करने का तरीका Play Store, आपके ऐप्लिकेशन के साथ-साथ Google Play Services for AR को भी इंस्टॉल करता है. आपका ऐप्लिकेशन, ARCore को डाउनलोड और इंस्टॉल करने के लिए ARSession.Install() कोरोटीन का इस्तेमाल करता है.
Android minSdkVersion की ज़रूरी शर्तें Android 7.0 (एपीआई लेवल 24) Android 4.4 (एपीआई लेवल 19). हालांकि, एआर की किसी भी सुविधा को चलाने के लिए, कम से कम Android 7.0 (एपीआई लेवल 24) की ज़रूरत होती है
ARCore के साथ काम करने की सुविधा और इंस्टॉल करने की स्थिति की जांच करने के लिए, ARSession.state का इस्तेमाल करना ज़रूरी है
Google Play Services for AR को इंस्टॉल करने के लिए, ARSession.Install() कोरोटीन का इस्तेमाल करना ज़रूरी है

अपने ऐप्लिकेशन को 'एआर की सुविधा ज़रूरी है' के तौर पर सेट करना

Android

  1. Edit > Project Settings > XR Plug-in Management > ARCore पर जाएं. Requirement की वैल्यू, डिफ़ॉल्ट रूप से Required पर सेट होती है.

  2. Edit > Project Settings > Player पर क्लिक करें. इसके बाद, Android के आइकॉन वाला टैब चुनें.

  3. Other Settings > Identification में जाकर, Minimum API Level की वैल्यू 24 या इससे ज़्यादा सेट करें.

iOS

  1. Edit > Project Settings > XR Plug-in Management > ARKit पर जाएं. Requirement की वैल्यू, डिफ़ॉल्ट रूप से Required पर सेट होती है.

  2. Edit > Project Settings > Player पर क्लिक करें. इसके बाद, iOS के आइकॉन वाला टैब चुनें.

  3. Other Settings > Configuration में जाकर, अपने ऐप्लिकेशन के लिए Target minimum iOS Version की वैल्यू सेट करें.

अपने ऐप्लिकेशन को 'एआर की सुविधा ज़रूरी नहीं है' के तौर पर सेट करना

Android

  1. Edit > Project Settings > XR Plug-in Management > ARCore पर जाएं.

  2. Requirement ड्रॉप-डाउन मेन्यू से, Optional को चुनें. इससे आपका ऐप्लिकेशन, 'एआर की सुविधा ज़रूरी नहीं है' के तौर पर सेट हो जाएगा.

  3. Edit > Project Settings > Player पर क्लिक करें. इसके बाद, Android के आइकॉन वाला टैब चुनें.

  4. Other Settings > Identification में जाकर, Minimum API Level की वैल्यू 24 या इससे ज़्यादा सेट करें.

iOS

  1. Edit > Project Settings > XR Plug-in Management > ARKit पर जाएं.

  2. Requirement ड्रॉप-डाउन मेन्यू से, Optional को चुनें. इससे आपका ऐप्लिकेशन, 'एआर की सुविधा ज़रूरी नहीं है' के तौर पर सेट हो जाएगा.

  3. Edit > Project Settings > Player पर क्लिक करें. इसके बाद, iOS के आइकॉन वाला टैब चुनें.

  4. Other Settings > Configuration में जाकर, अपने ऐप्लिकेशन के लिए Target minimum iOS Version की वैल्यू सेट करें.

रनटाइम के दौरान होने वाली जांचें करना

यह देखना कि Google Play Services for AR इंस्टॉल है या नहीं

एआर की सुविधा ज़रूरी है और एआर की सुविधा ज़रूरी नहीं है, दोनों तरह के ऐप्लिकेशन को ARCore सेशन बनाने से पहले, ARSession.Install() कोरोटीन का इस्तेमाल करना होगा. इससे यह पता चलेगा कि Google Play Services for AR का कोई ऐसा वर्शन इंस्टॉल है या नहीं जो आपके ऐप्लिकेशन के साथ काम करता हो. साथ ही, यह भी पक्का करना होगा कि ARCore के लिए ज़रूरी डिवाइस प्रोफ़ाइल का सारा डेटा डाउनलोड हो गया हो.

रनटाइम के दौरान, एआर की सुविधा ज़रूरी है वाले ऐप्लिकेशन, रनटाइम के दौरान होने वाली जांचें अपने-आप करेंगे. इससे यह पक्का होगा कि टारगेट डिवाइस:

  • ARCore के साथ काम करता हो
  • पर Google Play Services for AR इंस्टॉल हो. अगर यह इंस्टॉल नहीं है (ऐसा हो सकता है कि उपयोगकर्ता ने इसे हटा दिया हो) या इसका वर्शन बहुत पुराना है, तो आपका ऐप्लिकेशन, उपयोगकर्ता को इसे इंस्टॉल या अपडेट करने के लिए कहेगा.
  • पर ARCore के लिए डिवाइस प्रोफ़ाइल का नया डेटा मौजूद हो. अगर यह डेटा पुराना है, तो आपका ऐप्लिकेशन नया डेटा डाउनलोड करेगा.

डिफ़ॉल्ट रूप से होने वाली इन जांचों को बंद करने के लिए, ARSession.attemptUpdate की वैल्यू false पर सेट करें. आपके ऐप्लिकेशन को इन स्थितियों को मैनेज करना चाहिए:

शर्त कार्रवाई
डिवाइस, ARCore के साथ काम नहीं करता. एआर से जुड़ी सुविधाओं को छिपा देता है.
डिवाइस, ARCore के साथ काम करता है, लेकिन Google Play Services for AR और/या ARCore के लिए डिवाइस प्रोफ़ाइल का डेटा इंस्टॉल नहीं है या पुराना है. `ARSession.Install()` को कॉल करके, उपयोगकर्ता को `Google Play Services for AR` और/या ARCore के लिए डिवाइस प्रोफ़ाइल का डेटा इंस्टॉल या अपडेट करने के लिए कहता है.
डिवाइस, ARCore के साथ काम करता है. साथ ही, Google Play Services for AR और ARCore के लिए डिवाइस प्रोफ़ाइल का डेटा इंस्टॉल है और नया है. ARCore का Session बनाता है और ARCore का इस्तेमाल करना शुरू करता है.

इंस्टॉल करने और काम करने की स्थितियों के बारे में जानने के लिए, ARSession.state की वैल्यू भी देखी जा सकती है.

उपयोगकर्ता की निजता से जुड़ी ज़रूरी शर्तों का पालन करना

अपने ऐप्लिकेशन को Play Store पर पब्लिश करने के लिए, पक्का करें कि आपका ऐप्लिकेशन, ARCore की उपयोगकर्ता की निजता से जुड़ी ज़रूरी शर्तों का पालन करता हो.

अब क्या होगा