अपने एआर फ़ाउंडेशन ऐप्लिकेशन में एआर की सुविधा चालू करें (सिर्फ़ 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 की उपयोगकर्ता की निजता से जुड़ी ज़रूरी शर्तों का पालन करता हो.

अब क्या होगा