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

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

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

  • Android SDK Platform 7.0 (एपीआई लेवल 24) या इसके बाद के वर्शन के साथ, 3.1 या उसके बाद के वर्शन के साथ Android Studio इंस्टॉल करें.

  • अगर आपने अभी-अभी Android का इस्तेमाल नहीं किया है, तो अपना पहला Android ऐप्लिकेशन बनाना देखें.

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

  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 Emulator पर एआर ऐप्लिकेशन चलाए जा सकते हैं. ऐप्लिकेशन चलाने से पहले आपको एम्युलेटर पर Google Play Services for AR को अपडेट करना होगा. ज़्यादा जानकारी के लिए, Android Emulator में AR ऐप्लिकेशन चलाएं देखें.

सैंपल चलाएं

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

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

अगर Google Play services for AR को इंस्टॉल या अपडेट नहीं किया गया है, तो आपको उन्हें इंस्टॉल या अपडेट करने के लिए कहा जा सकता है. इसे Google Play Store से इंस्टॉल करने के लिए, CONTINUE चुनें या इसे Google Play Services for AR अपडेट करें में बताए गए तरीके से मैन्युअल तरीके से अपडेट करें.

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

इंस्टैंट प्लेसमेंट की सुविधा का इस्तेमाल करें

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

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

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

इंस्टैंट प्लेसमेंट

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

इमेज 2 में, गियर आइकॉन के नीचे दिए गए मेन्यू से इंस्टैंट प्लेसमेंट चालू किया गया है.

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

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

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

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

इंस्टैंट प्लेसमेंट

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

इमेज 2 में, जब डिवाइस पूल टेबल के चारों ओर घूमता है, तब ऑब्जेक्ट, डिवाइस के साथ-साथ चलता रहता है. भले ही, सीन में कोई भी ऑब्जेक्ट न हो.

इमेज 3 में, गहराई की सुविधा चालू है.

इमेज 4 में, जब डिवाइस सीन के चारों ओर घूमता है, तब ऑब्जेक्ट अब पूल टेबल के नीचे से ढका हुआ दिखता है.

अगले चरण