Google I/O के बारे में जानने के लिए धन्यवाद. सेशन देखें.

Android के लिए क्विकस्टार्ट

Android के साथ ARCore का इस्तेमाल करने के लिए, hello_ar_kotlin या hello_ar_java सैंपल ऐप्लिकेशन चलाया जा सकता है. इन नमूना ऐप्लिकेशन में OpenGL का इस्तेमाल होता है. यह 2D और 3D वेक्टर ग्राफ़िक बनाने के लिए एक प्रोग्रामिंग इंटरफ़ेस है. इन ऐप्लिकेशन की मदद से, फ़्लाइट का पता लगाया जाता है और उपयोगकर्ता 3D मॉडल रखने के लिए, हवाई जहाज़ में टैप कर सकते हैं.

अपने डेवलपमेंट एनवायरमेंट को सेट अप करना

सैंपल प्रोजेक्ट खोलना

  1. Android Studio में, ARCore SDK टूल का GitHub डेटा स्टोर करने की जगह का क्लोन बनाएं.

    ऐसा करने के कई तरीके हैं:

    • Android Studio को पहले से इंस्टॉल करने के लिए:

      • Git मेन्यू से, Clone को चुनें.
      • Version control ड्रॉप-डाउन में, वर्शन कंट्रोल सिस्टम के तौर पर Git चुनें.
      • URL फ़ील्ड में, ARCore GitHub के रिपॉज़िटरी (डेटा स्टोर की जगह) में यह यूआरएल डालें:

        https://github.com/google-ar/arcore-android-sdk.git

    • Terminal खोलने और git clone कमांड जारी करने के लिए, यह तरीका अपनाएं:

      git clone https://github.com/google-ar/arcore-android-sdk.git
  2. सैंपल प्रोजेक्ट को खोलने के लिए, यहां दिए गए तरीके का इस्तेमाल करें. प्रोजेक्ट बनाने और उसे चलाने के लिए, आपको साफ़ तौर पर प्रोजेक्ट खोलना होगा.

    • File मेन्यू से, Open चुनें.
    • arcore-android-sdk/samples फ़ोल्डर में, hello_ar_kotlin या hello_ar_java फ़ोल्डर को चुनें और Open पर क्लिक करें.

अपने डिवाइस या एम्युलेटर को तैयार करना

आप काम करने वाले डिवाइस पर या Android एम्युलेटर पर एआर (ऑगमेंटेड रिएलिटी) ऐप्लिकेशन चला सकते हैं. आपको ऐप्लिकेशन चलाने से पहले एम्युलेटर पर AR के लिए Google Play सेवाएं अपडेट करनी होंगी. ज़्यादा जानकारी के लिए, Android एम्युलेटर में AR ऐप्लिकेशन चलाएं देखें.

सैंपल चलाएं

पक्का करें कि आपका Android डिवाइस, डेवलपमेंट मशीन से कनेक्ट हो और Android Studio में Run पर क्लिक करें.

Android Studio आपके प्रोजेक्ट को डीबग करने लायक APK के तौर पर बनाता है, APK इंस्टॉल करता है, और फिर ऐप्लिकेशन को आपके डिवाइस पर चलाता है. ज़्यादा जानकारी के लिए, ऐप्लिकेशन बनाना और चलाना देखें.

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

hello_ar_java ऐप्लिकेशन की मदद से आप पता लगाए गए एआर विमान के प्लैटफ़ॉर्म पर तीन डाइमेंशन वाला ARCore गिरवी रख सकते हैं. इसे Android GL SurfaceView के साथ लागू किया जाता है. इसका इस्तेमाल कैमरा की झलक और बुनियादी AR ऑब्जेक्ट, जैसे कि हवाई जहाज़ और ऐंकर को रेंडर करने के लिए किया जाता है. hello_ar_java का सैंपल रेंडरिंग फ़्रेमवर्क com/google/ar/core/examples/java/common/samplerender में देखा जा सकता है.

में लाइफ़साइकल प्रबंधन तर्क का पालन करें

इंस्टैंट प्लेसमेंट का इस्तेमाल करें

इंस्टैंट प्लेसमेंट एपीआई, उपयोगकर्ता को स्क्रीन पर एआर (ऑगमेंटेड रिएलिटी) ऑब्जेक्ट डालने की अनुमति देता है. इसके लिए, उन्हें ARज्यामिति की सतह की ज्यामिति का पता लगाने का इंतज़ार नहीं करना पड़ता. जब उपयोगकर्ता एनवायरमेंट के आस-पास आगे बढ़ता है, तो ऑब्जेक्ट को रीयल टाइम में रखा जाता है.

ऑब्जेक्ट जोड़ने के लिए, स्क्रीन पर टैप करें. पक्का करें कि स्क्रीन पर होलोग्राफ़िक ऑब्जेक्ट दिखने के बाद, डिवाइस को इधर-उधर ले जाते रहें. इससे, ARCore, वर्चुअल ऑब्जेक्ट को ठीक से ऐंकर करने के लिए, आपके आस-पास से जुड़ा ज़रूरी डेटा इकट्ठा कर सकेगा.

जब ARCore सतह की ज्यामिति का पता लगा लेता है और उस जगह पर ट्रैक करने लायक जगह तय करता है जहां ऑब्जेक्ट रखा गया है, तो ऑब्जेक्ट की पोज़िशन सटीक होने के लिए अपने-आप अपडेट हो जाती है.

झटपट प्लेसमेंट

चित्र 1 में, झटपट प्लेसमेंट अक्षम है और सतह की ज्यामिति अपरिभाषित है. पूल टेबल की दाईं ओर फ़र्श पर रखे गए ऑब्जेक्ट (चार छोटे नीले बिंदु) नॉक-ओवर किए हुए दिखते हैं, इसलिए उनका पोज़ तय नहीं है.

चित्र 2 में, गियर आइकन के अंतर्गत मेनू से झटपट प्लेसमेंट सक्षम है.

डायग्राम 3 में, इंस्टैंट प्लेसमेंट की सुविधा चालू होने पर, नया ऑब्जेक्ट सीन में रखा जाता है. यह रंग दिखाने के बजाय ग्रेस्केल में दिखता है. इससे पता चलता है कि इसे सही पोज़ के लिए, अभी ठीक नहीं किया गया है.

चित्र 4 में, नया ऑब्जेक्ट रंगीन हो जाता है और जब सतह की ज्यामिति (जिसे ट्रैक करने लायक ग्रिड लाइनों से बताया गया है) का सटीक पता चलता है.

गहराई का इस्तेमाल करें

गहराई चालू होने पर, ARCore, सीन में मौजूद ऑब्जेक्ट की ज्यामिति और जगह की जानकारी को ध्यान में रखता है. साथ ही, सीन में मौजूद दूसरी चीज़ों के मुकाबले, ऑब्जेक्ट में शामिल ऑब्जेक्ट की जगह की जानकारी का हिसाब लगाता है. इसकी मदद से, इमेज में मौजूद ऑब्जेक्ट को सीन में छिपी होनी चाहिए. साथ ही, आपके ऐप्लिकेशन को असली जैसा बनाया जा सकता है.

झटपट प्लेसमेंट

पहली इमेज में, गहराई देखने की सुविधा बंद की गई है. किसी ऑब्जेक्ट को पूल टेबल के नीचे रखा जाता है.

दूसरी इमेज में, जैसे ही डिवाइस पूल टेबल के आस-पास घूमता है, ऑब्जेक्ट वैसे ही डिवाइस को फ़ॉलो करने लगता है, चाहे सीन में कोई भी ऑब्जेक्ट शामिल हो.

चित्र 3 में, गहराई सक्षम की गई है.

इमेज 4 में, अब ऑब्जेक्ट ऑब्जेक्ट के आस-पास, पूल टेबल के बीच में भरा हुआ दिखता है.

अगले चरण