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

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

  • एआर (ऑगमेंटेड रिएलिटी) वैकल्पिक ऐप्लिकेशन उन डिवाइस पर इंस्टॉल और चलाए जा सकते हैं जिन पर ARCore काम नहीं करता है.
  • जब उपयोगकर्ता कोई एआर (ज़रूरी नहीं) ऐप्लिकेशन इंस्टॉल करते हैं, तो Google Play Store आपके डिवाइस पर Google Play Services for AR को अपने-आप इंस्टॉल नहीं करेगा.
एआर (ऑगमेंटेड रिएलिटी) ज़रूरी हैएआर (ऑगमेंटेड रिएलिटी) वैकल्पिक
एआर (ऑगमेंटेड रिएलिटी) सुविधा का इस्तेमाल बुनियादी सुविधाओं के लिए, आपके ऐप्लिकेशन में ARCore ज़रूरी है. ARCore आपके ऐप्लिकेशन की सुविधाओं को बेहतर बनाता है. आपका ऐप्लिकेशन ARCore की सुविधा के बिना भी काम कर सकता है.
Play Store किसको दिखे आपका ऐप्लिकेशन सिर्फ़ ARCore की सुविधा वाले डिवाइसों पर Play Store में मौजूद है. आपका ऐप्लिकेशन सामान्य लिस्टिंग प्रोसेस का पालन करता है.
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 की उपयोगकर्ता की निजता से जुड़ी ज़रूरी शर्तों का पालन करता है.

आगे क्या होगा