ARCore चालू करें

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

  1. Unity 2019.4.3f1 या इसके बाद के वर्शन इंस्टॉल करें
  2. एआर (ऑगमेंटेड रिएलिटी) फ़ाउंडेशन का इस्तेमाल करके काम करने वाला कोई प्रोजेक्ट हो
  3. ARCore एक्सटेंशन पैकेज इंस्टॉल करना
  4. अपने ऐप्लिकेशन को एआर (ऑगमेंटेड रिएलिटी) ज़रूरी बनाने या एआर (ऑगमेंटेड रिएलिटी) के लिए कॉन्फ़िगर करना
  5. रनटाइम के दौरान जांच करें
  6. अपने ऐप्लिकेशन को डेप्थ ज़रूरी या गहराई वाले विकल्प के तौर पर कॉन्फ़िगर करें
  7. पक्का करें कि आपका ऐप्लिकेशन, ARCore&#39s की उपयोगकर्ता निजता की ज़रूरी शर्तों का पालन करता हो

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

ऐसा ऐप्लिकेशन जो एआर (ऑगमेंटेड रिएलिटी) सुविधाओं के साथ काम करता है, उसे दो तरीकों से कॉन्फ़िगर किया जा सकता है:AR Required या AR Optional.

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

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

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

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

ज़्यादा जानकारी के लिए, हमारा ऐप्लिकेशन डिस्ट्रिब्यूशन की खास जानकारी देखें.

अपना ऐप्लिकेशन AR Required बनाएं

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 बताएं.

अपना ऐप्लिकेशन AR Optional बनाएं

Android:

  1. Edit > Project Settings > XR Plug-in Management > ARCore पर नेविगेट करें.

  2. अपने ऐप्लिकेशन को AR पर सेट नहीं करने के लिए, Requirement ड्रॉप-डाउन मेन्यू में, Optional चुनें.

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

  4. Other Settings > Identification में जाकर, Minimum API Level को 19 या इससे ज़्यादा के तौर पर सेट करें.

iOS:

  1. Edit > Project Settings > XR Plug-in Management > ARKit पर नेविगेट करें.

  2. अपने ऐप्लिकेशन को AR पर सेट नहीं करने के लिए, Requirement ड्रॉप-डाउन मेन्यू में, Optional चुनें.

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

  4. Other Settings > Configuration में, अपने ऐप्लिकेशन के लिए Target minimum iOS Version बताएं.

रनटाइम के दौरान जांच करें

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

  • 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 भी देख सकते हैं.

अपने ऐप्लिकेशन को Depth Required या Depth Optional (सिर्फ़ Android के लिए) कॉन्फ़िगर करें

अगर आपके ऐप्लिकेशन के लिए, डेप्थ एपीआई सहायता ज़रूरी है, तो एआर अनुभव का मुख्य हिस्सा गहराई से निर्भर करता है. इसलिए, हो सकता है कि डेप्थ का इस्तेमाल करने वाले ऐप्लिकेशन के कुछ हिस्सों पर कोई फ़ॉलबैक न दिया जाए. ऐसे में, Google Play Store में अपने ऐप्लिकेशन के डिस्ट्रिब्यूशन पर पाबंदी लगाई जा सकती है. ऐसे डिवाइसों पर जो गहराई वाले एपीआई के साथ काम करते हैं.

अपना ऐप्लिकेशन Depth Required बनाएं

Edit > Project Settings > XR Plug-in Management > ARCore पर नेविगेट करें.

Depth डिफ़ॉल्ट रूप से Required पर सेट है.

अपना ऐप्लिकेशन Depth Optional बनाएं

  1. Edit > Project Settings > XR Plug-in Management > ARCore पर नेविगेट करें.

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

निजता की ज़रूरी शर्तें

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

अगले चरण