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

Android के साथ ARCore का इस्तेमाल करना शुरू करने के लिए, आप ARCore SDK टूल के साथ शामिल 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 एम्युलेटर पर भी इन ऐप्लिकेशन को चला सकते हैं. ऐप्लिकेशन चलाने से पहले आपको एम्युलेटर पर एआर (ऑगमेंटेड रिएलिटी) के लिए Google Play सेवाएं अपडेट करनी होंगी. ज़्यादा जानकारी के लिए Android एम्युलेटर में एआर (ऑगमेंटेड रिएलिटी) ऐप्लिकेशन चलाएं देखें.

सैंपल चलाएं

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

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

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

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

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

Instant Placement API, उपयोगकर्ता को एआर (ऑगमेंटेड रिएलिटी) ऑब्जेक्ट को स्क्रीन पर रखने की सुविधा देता है. इसके लिए, आपको ARCore को सरफ़ेस ज्यामिति का पता लगाने का इंतज़ार नहीं करना पड़ता. जैसे-जैसे उपयोगकर्ता एनवायरनमेंट में घूमने लगता है, वैसे-वैसे ऑब्जेक्ट को रीयल-टाइम में बेहतर तरीके से दिखाया जाता है. जब ARCore को उस क्षेत्र में सही पोज़ (हाव-भाव) का पता चलता है जहां एआर (ऑगमेंटेड रिएलिटी) ऑब्जेक्ट रखा गया है, तो सफ़ेद ऑब्जेक्ट अपने-आप पोज़ (सटीक) होने के लिए अपडेट हो जाता है. साथ ही, वह अपारदर्शिता हो जाता है.

झटपट प्लेसमेंट का उपयोग करके वर्चुअल ऑब्जेक्ट रखना

hello_ar_java में झटपट प्लेसमेंट अपने आप चालू हो जाता है. स्क्रीन पर गियर आइकॉन पर टैप करें और ड्रॉप-डाउन मेन्यू में Instant Placement चुनें. Enable Instant Placement चेकबॉक्स पहले से ही चुना हुआ होना चाहिए.

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

अगले चरण