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

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

अपने ऐप्लिकेशन को एआर (ऑगमेंटेड रिएलिटी) ज़रूरी है या एआर (ऑगमेंटेड रिएलिटी) वैकल्पिक के तौर पर कॉन्फ़िगर करें

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

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

अपने ऐप्लिकेशन को एआर (ऑगमेंटेड रिएलिटी) को ज़रूरी बनाएं

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

आगे क्या होगा