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

अपने ऐप्लिकेशन को एआर के लिए ज़रूरी बनाएं

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 इंस्टॉल है या नहीं

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

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

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

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

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

इंस्टॉलेशन और सपोर्ट की स्थितियों की जानकारी के लिए, ARSession.state पर भी जाएं.

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

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

आगे क्या होगा