Android के लिए ARCore चालू करें

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

  1. Unity के लिए ARCore SDK टूल इंपोर्ट करें
  2. अपने ऐप्लिकेशन को एआर (ऑगमेंटेड रिएलिटी) की ज़रूरत के हिसाब से कॉन्फ़िगर करना या एआर (ऑगमेंटेड रिएलिटी) की सुविधा के लिए कॉन्फ़िगर करना
  3. पक्का करें कि आपका ऐप्लिकेशन ARCore'उपयोगकर्ता की निजता से जुड़ी ज़रूरी शर्तों का पालन करता हो

Google Play Services for AR

ARCore SDK टूल, ARCore की सुविधा वाले डिवाइसों पर उपलब्ध कराता है. इन डिवाइसों में AR के लिए Google Play सेवाएं (ARCore) इंस्टॉल किया गया है.

Google Play Services for AR, उन ज़्यादातर डिवाइसों पर अपने-आप इंस्टॉल और अप-टू-डेट हो जाता है जिन पर यह सुविधा काम करती है.

एआर (ऑगमेंटेड रिएलिटी) सेशन शुरू करने से पहले, ऐप्लिकेशन को:

  1. CheckApkAvailability को कॉल करके देखें कि ARCore काम करता है या नहीं.
  2. जांचें कि AR के लिए Google Play सेवाएं इंस्टॉल और अप टू डेट हैं या नहीं और यह कि Session.RequestApkInstallation(bool userRequested)को कॉल करके ज़रूरी ARCore डिवाइस प्रोफ़ाइल डेटा डाउनलोड किया गया है या नहीं.

Unity के लिए ARCore SDK टूल इंपोर्ट करें

  1. Unity खोलें और एक नया 3D प्रोजेक्ट बनाएं.

  2. वर्शन के हिसाब से पैकेज इंस्टॉल करें.

    यूनिटी 2020

    विंडो > पैकेज मैनेजर चुनें और नीचे दिए गए पैकेज इंस्टॉल करें:

    • मल्टीप्लेयर HLAPI (क्लाउड ऐंकर नमूना के लिए ज़रूरी)
    • XR प्लग इन मैनेजमेंट ('इंस्टैंट झलक' के लिए ज़रूरी, जो TrackedPoseDriver का इस्तेमाल करता है)

    एकता 2019

    विंडो > पैकेज मैनेजर चुनें और नीचे दिए गए पैकेज इंस्टॉल करें:

    • मल्टीप्लेयर HLAPI (क्लाउड ऐंकर नमूना के लिए ज़रूरी)
    • XR लीगेसी इनपुट हेल्पर ('तुरंत झलक देखें' के लिए ज़रूरी है, जो TrackedPoseDriver का इस्तेमाल करता है)

    एकता 2018

    इसके लिए किसी और पैकेज की ज़रूरत नहीं है. अगला चरण प्रोसेस करें.

    एकता 2017

    इसके लिए किसी और पैकेज की ज़रूरत नहीं है. अगला चरण प्रोसेस करें.

  3. Unity के लिए ARCore SDK टूल इंपोर्ट करें:

    1. एसेट > पैकेज इंपोर्ट करें; कस्टम पैकेज को चुनें.

    2. डाउनलोड किया गया arcore-unity-sdk-1.25.0.unitypackage चुनें.

    3. पैकेज इंपोर्ट करना डायलॉग में, पक्का करें कि पैकेज के सभी विकल्प चुने गए हों. इसके बाद, इंपोर्ट करें पर क्लिक करें.

Unity's प्रोजेक्ट विंडो में, आपको Assets/GoogleARCore/Examples/HelloAR/ में SDK टूल फ़ाइलें और HelloAR के सैंपल ऐप्लिकेशन, दोनों दिखेंगे.

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

एआर (ऑगमेंटेड रिएलिटी) सुविधाओं के साथ काम करने वाले ऐप्लिकेशन को दो तरीकों से कॉन्फ़िगर किया जा सकता है: एआर (ऑगमेंटेड रिएलिटी) और एआर (ऑगमेंटेड रिएलिटी) ज़रूरी नहीं. अगर आपको यह चुनने में मदद चाहिए कि आपको किसे चुनना है, तो Google Play स्टोर में एआर (ऑगमेंटेड रिएलिटी) ऐप्लिकेशन प्रकाशित करें देखें.

एआर (ऑगमेंटेड रिएलिटी) ज़रूरी है

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

  • Google Play Store, एआर (ऑगमेंटेड रिएलिटी) ज़रूरी ऐप्लिकेशन को सिर्फ़ ऐसे डिवाइसों पर उपलब्ध कराता है जिन पर ARCore काम करता है.

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

ज़्यादा जानकारी के लिए, Google Play Store में AR ऐप्लिकेशन प्रकाशित करना देखें.

किसी ऐप्लिकेशन को एआर (ऑगमेंटेड रिएलिटी) बनाने के लिए, यह तरीका अपनाएं.

यूनिटी 2020

  1. बदलाव करें ; प्रोजेक्ट सेटिंग खोलें. Google ARCore चुनें और पुष्टि करें कि ARCore ज़रूरी है को चुना गया है.

  2. बदलाव करने के लिए कम से कम एपीआई लेवल सेट करें. इसके लिए, > प्रोजेक्ट सेटिंग > प्लेयर पर क्लिक करें और Android आइकॉन वाला टैब चुनें. अन्य सेटिंग &पहचान के तहत, कम से कम एपीआई लेवल चुनें जो 24 या उससे ज़्यादा हो.

एकता 2019

  1. बदलाव करें ; प्रोजेक्ट सेटिंग खोलें. Google ARCore चुनें और पुष्टि करें कि ARCore ज़रूरी है को चुना गया है.

  2. बदलाव करने के लिए कम से कम एपीआई लेवल सेट करें. इसके लिए, > प्रोजेक्ट सेटिंग > प्लेयर पर क्लिक करें और Android आइकॉन वाला टैब चुनें. अन्य सेटिंग &पहचान के तहत, कम से कम एपीआई लेवल चुनें जो 24 या उससे ज़्यादा हो.

एकता 2018

  1. बदलाव करें ; प्रोजेक्ट सेटिंग खोलें. Google ARCore चुनें और पुष्टि करें कि ARCore ज़रूरी है को चुना गया है.

  2. बदलाव करने के लिए कम से कम एपीआई लेवल सेट करें. इसके लिए, > प्रोजेक्ट सेटिंग > प्लेयर पर क्लिक करें और Android आइकॉन वाला टैब चुनें. अन्य सेटिंग &पहचान के तहत, कम से कम एपीआई लेवल चुनें जो 24 या उससे ज़्यादा हो.

एकता 2017

  1. > प्रोजेक्ट सेटिंग > Google ARCore खोलें और पुष्टि करें कि ARCore ज़रूरी है पर सही का निशान लगाया गया है.

  2. बदलाव करने के लिए कम से कम एपीआई लेवल सेट करें. इसके लिए, > प्रोजेक्ट सेटिंग > प्लेयर पर क्लिक करें और Android आइकॉन वाला टैब चुनें. अन्य सेटिंग &पहचान के तहत, कम से कम एपीआई लेवल चुनें जो 24 या उससे ज़्यादा हो.

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

एआर (ऑगमेंटेड रिएलिटी) ज़रूरी नहीं है

एआर (ऑगमेंटेड रिएलिटी) ऐप्लिकेशन में वैकल्पिक एआर (ऑगमेंटेड रिएलिटी) की सुविधाएं हैं, जो सिर्फ़ उन डिवाइस पर चालू हैं जिन पर एआर (ऑगमेंटेड रिएलिटी) के लिए Google Play सेवाएं इंस्टॉल की गई हैं.

  • AR वैकल्पिक ऐप्लिकेशन इंस्टॉल किए जा सकते हैं और ऐसे डिवाइस पर चलाए जा सकते हैं जिन पर ARCore काम नहीं करता.

  • जब उपयोगकर्ता किसी एआर (ऑगमेंटेड रिएलिटी) ऐप्लिकेशन को इंस्टॉल करते हैं, तो Google Play स्टोर, उस ऐप्लिकेशन से Google Play Services for AR को अपने-आप इंस्टॉल नहीं करता.

किसी ऐप्लिकेशन को AR वैकल्पिक बनाने के लिए, यह तरीका अपनाएं.

यूनिटी 2020

  1. बदलाव करें ; प्रोजेक्ट सेटिंग खोलें. Google ARCore चुनें और ARCore ज़रूरी है से सही का निशान हटाएं.

  2. बदलाव करने के लिए कम से कम एपीआई लेवल सेट करें. इसके लिए, > प्रोजेक्ट सेटिंग > प्लेयर पर क्लिक करें और Android आइकॉन वाला टैब चुनें. अन्य सेटिंग &पहचान के तहत, कम से कम एपीआई लेवल चुनें जो 18 या उससे ज़्यादा हो.

एकता 2019

  1. बदलाव करें ; प्रोजेक्ट सेटिंग खोलें. Google ARCore चुनें और ARCore ज़रूरी है से सही का निशान हटाएं.

  2. बदलाव करने के लिए कम से कम एपीआई लेवल सेट करें. इसके लिए, > प्रोजेक्ट सेटिंग > प्लेयर पर क्लिक करें और Android आइकॉन वाला टैब चुनें. अन्य सेटिंग &पहचान के तहत, कम से कम एपीआई लेवल चुनें जो 18 या उससे ज़्यादा हो.

एकता 2018

  1. बदलाव करें ; प्रोजेक्ट सेटिंग खोलें. Google ARCore चुनें और ARCore ज़रूरी है से सही का निशान हटाएं.

  2. बदलाव करने के लिए कम से कम एपीआई लेवल सेट करें. इसके लिए, > प्रोजेक्ट सेटिंग > प्लेयर पर क्लिक करें और Android आइकॉन वाला टैब चुनें. अन्य सेटिंग &पहचान के तहत, कम से कम एपीआई लेवल चुनें जो 18 या उससे ज़्यादा हो.

एकता 2017

  1. > प्रोजेक्ट सेटिंग > Google ARCore खोलें और ARCore ज़रूरी है से सही का निशान हटाएं.

  2. बदलाव करने के लिए कम से कम एपीआई लेवल सेट करें. इसके लिए, > प्रोजेक्ट सेटिंग > प्लेयर पर क्लिक करें और Android आइकॉन वाला टैब चुनें. अन्य सेटिंग &पहचान के तहत, कम से कम एपीआई लेवल चुनें जो 18 या उससे ज़्यादा हो.

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

लॉन्च होने के बाद, आपके ऐप्लिकेशन को Session.CheckApkAvailability() पर कॉल करके यह पता लगाना होगा कि डिवाइस ARCore पर काम करता है या नहीं. अगर ऐसा है, तो क्या यह ज़रूरी है कि एआर (ऑगमेंटेड रिएलिटी) और ARCore डिवाइस प्रोफ़ाइल डेटा के लिए Google Play सेवाएं इंस्टॉल हों और अप-टू-डेट हों.

आपके ऐप्लिकेशन को इन शर्तों को पूरा करना चाहिए:

शर्त कार्रवाई
इस डिवाइस पर ARCore की सुविधा नहीं है. एआर से जुड़े फ़ंक्शन छिपाता है.
डिवाइस, ARCore के साथ काम करता है. हालांकि, एआर (ऑगमेंटेड रिएलिटी) और/या ARCore डिवाइस की प्रोफ़ाइल के डेटा के लिए, Google Play सेवाएं इंस्टॉल या पुरानी नहीं हैं. उपयोगकर्ता से, Session.RequestApkInstallation() को कॉल करके, एआर (ऑगमेंटेड रिएलिटी) और/या ARCore डिवाइस की प्रोफ़ाइल के डेटा के लिए, Google Play सेवाओं को इंस्टॉल या अपडेट करने की सूचना दें.
ARAR और ARCore डिवाइस प्रोफ़ाइल डेटा के लिए, ARCore और Google Play सेवाओं का इस्तेमाल किया जा सकता है. ARCore Session बनाता है और ARCore का इस्तेमाल करना शुरू करता है.

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

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

अगले चरण

कोड को ऐप्लिकेशन के नमूने और ARCore for Unity API के रेफ़रंस में पढ़ें.