पुराने ARCore Cloud Anchor API का इस्तेमाल रोक दिया गया है. यह 31 अगस्त, 2023 के बाद काम नहीं करेगा. अगर आपका ऐप्लिकेशन इस एपीआई का इस्तेमाल कर रहा है, तो आपको जल्द से जल्द नए ARCore API एंडपॉइंट का इस्तेमाल करने के लिए, इसे अपडेट करना होगा.

Android के लिए Cloud अनुवाद क्विकस्टार्ट

cloud_anchor_java और persistent_cloud_anchor_java ऐप्लिकेशन के नमूने के तौर पर, क्लाउड ऐंकर को होस्ट करने और ठीक करने की कोशिश करें.

आपको किस सैंपल ऐप्लिकेशन का इस्तेमाल करना चाहिए?

क्लाउड ऐंकर ऐंकर होते हैं, जो ARCore Cloud Anchor API या ARCore Cloud किराया सेवा पर होस्ट किए जाते हैं. इस एपीआई की मदद से उपयोगकर्ता एक ही ऐप्लिकेशन में अनुभवों को शेयर कर सकते हैं. स्थायी क्लाउड ऐंकर, वे क्लाउड ऐंकर हैं जिन्हें 24 घंटे से ज़्यादा होस्ट किया जा सकता है.

  • persistent_cloud_anchor_java, मिलकर काम करने के लिए प्रोजेक्ट के इस्तेमाल से जुड़ा मामला है. ARCore Cloud ऐंकर API को चालू करने के लिए, यह कुंजीलेस की अनुमति का इस्तेमाल करता है. यह Firebase ऐंकर का इस्तेमाल करके, डिवाइसों के बीच Cloud ऐंकर आईडी शेयर करता है. इसलिए, इसे चालू करना और चलाना ज़्यादा आसान है.
  • cloud_anchor_java में एक से ज़्यादा खिलाड़ियों के इस्तेमाल के उदाहरण को लागू किया गया है. यह ARCore Cloud ऐंकर API कॉल को अनुमति देने के लिए, एपीआई कुंजी का इस्तेमाल करता है.

ज़रूरी शर्तें

ज़रूरी शर्तें

हार्डवेयर

सॉफ़्टवेयर

  • Android Studio का 3.0 या इसके बाद का वर्शन, Android SDK प्लैटफ़ॉर्म 7.0 (एपीआई लेवल 24) या इसके बाद का वर्शन
  • Android के लिए ARCore SDK टूल, जिसे आप दो में से किसी एक तरीके से पा सकते हैं:
    • इसे GitHub से डाउनलोड करें और अपनी मशीन पर निकालें
    • नीचे दिए गए निर्देश से, डेटा स्टोर करने की जगह की सूची बनाएं:
      git clone https://github.com/google-ar/arcore-android-sdk.git

Android Studio में, सैंपल ऐप्लिकेशन खोलना

ARCore SDK, cloud_anchor_java और persistent_cloud_anchor_java सैंपल ऐप्लिकेशन दिखाता है, ताकि क्लाउड ऐंकर की सुविधा उपलब्ध कराई जा सके. Android Studio में ऐप्लिकेशन खोलने के लिए, यह तरीका अपनाएं.

स्थायी क्लाउड ऐंकर

  1. Android Studio में, खोलें पर क्लिक करें.

  2. उस जगह पर जाएं जहां आपकी मशीन पर arcore-android-sdk डायरेक्ट्री सेव है. पूरा SDK फ़ोल्डर न खोलें. इसके बजाय, नमूना > persistent_cloud_anchor_java पर जाएं और खोलें पर क्लिक करें.

क्लाउड ऐंकर

  1. Android Studio में, खोलें पर क्लिक करें.

  2. उस जगह पर जाएं जहां आपकी मशीन पर arcore-android-sdk डायरेक्ट्री सेव है. पूरा SDK फ़ोल्डर न खोलें. इसके बजाय, नमूना > cloud_anchor_java पर जाएं और खोलें पर क्लिक करें.

Cloud ऐंकर आईडी शेयर करने की सुविधा सेट अप करना

क्लाउड ऐंकर आईडी ऐसी स्ट्रिंग होती हैं जो होस्ट किए गए क्लाउड ऐंकर की पहचान करती हैं. इनका इस्तेमाल होस्ट किए गए ऐंकर से जुड़े 3D ऑब्जेक्ट को ठीक करने या रेंडर करने के लिए किया जाता है.

स्थायी क्लाउड ऐंकर

क्लाउड ऐंकर आईडी को शेयर करने की सुविधा, ऐप्लिकेशन में स्थानीय तौर पर मैनेज की जाती है. आपको यहां कुछ करने की ज़रूरत नहीं है.

क्लाउड ऐंकर

डिवाइस के बीच क्लाउड ऐंकर आईडी शेयर करने के लिए, cloud_anchor_java सैंपल ऐप्लिकेशन, Firebase's रीयल टाइम डेटाबेस का इस्तेमाल करता है. अपने ऐप्लिकेशन में किसी दूसरे तरीके का इस्तेमाल किया जा सकता है.

  1. Firebase को मैन्युअल तरीके से अपने ऐप्लिकेशन में जोड़ें. cloud_anchor_java पैकेज का नाम com.google.ar.core.examples.java.cloudanchor है. यह main/AndroidManifest.xml में मिल जाएगा.
  2. वह google-services.json फ़ाइल डाउनलोड करें जो आपने Firebase को ऐप्लिकेशन में जोड़ते समय जनरेट की थी.
  3. Firebase के साथ रीयल टाइम डेटाबेस बनाना.
  4. Android Studio में, अपने प्रोजेक्ट की app डायरेक्ट्री में google-services.json फ़ाइल जोड़ें.

ARCore क्लाउड ऐंकर API कॉल को अनुमति दें

अपने ऐप्लिकेशन के लिए, Cloud ऐंकर एपीआई को होस्ट करने और उसका समाधान करने के लिए, ARCore क्लाउड ऐंकर एपीआई को अनुमति दें.

स्थायी क्लाउड ऐंकर

24 घंटों से ज़्यादा की TTL (टीटीएल) वाला क्लाउड ऐंकर बनाने के लिए, persistent_cloud_anchor_java में ARCore Cloud ऐंकर API (एपीआई) का इस्तेमाल करें.

  1. नए या मौजूदा Google Cloud Platform प्रोजेक्ट के लिए, ARCore ARCore Cloud Anchor API चालू करें.
  2. ऐप्लिकेशन के ऐप्लिकेशन आईडी और साइनिंग सर्टिफ़िकेट SHA-1 फ़िंगरप्रिंट का इस्तेमाल करके, Google Cloud Console में अपने Android ऐप्लिकेशन के लिए एक OAuth क्लाइंट आईडी बनाएं. यह Android ऐप्लिकेशन को आपके Google Cloud Platform प्रोजेक्ट से जोड़ता है.

    डीबग हस्ताक्षर वाले प्रमाणपत्र का फ़िंगरप्रिंट वापस पाने के लिए:

    • अपने Android Studio प्रोजेक्ट में Gradle टूलपैन खोलें.
    • persistent_cloud_anchor_java > Tasks > android पर जाएं.
    • signreport टास्क को चलाएं.

    • डीबग वैरिएंट के लिए SHA-1 फ़िंगरप्रिंट को Google Cloud Console के SHA-1 सर्टिफ़िकेट फ़िंगरप्रिंट फ़ील्ड में कॉपी करें.

क्लाउड ऐंकर

cloud_anchor_java में एपीआई कुंजी वाले ARCore क्लाउड ऐंकर एपीआई को TTL (टीटी) होस्ट करने और उसका समाधान करने के लिए ज़्यादा से ज़्यादा 24 घंटे के लिए अनुमति दें.

  1. नए या मौजूदा Google Cloud Platform प्रोजेक्ट के लिए, ARCore ARCore Cloud Anchor API चालू करें.
  2. Google Cloud Console से इस प्रोजेक्ट के लिए, एपीआई कुंजी पाएं.
  3. Android Studio में, cloud_anchor_java प्रोजेक्ट में अपनी नई एपीआई कुंजी जोड़ें:

    • अपने ऐप्लिकेशन के <application> एलिमेंट के <meta-data> एलिमेंट में एपीआई कुंजी शामिल करें:
    <meta-data
       android:name="com.google.android.ar.API_KEY"
       android:value="API_KEY"/>
    

ऐप्लिकेशन का नमूना बनाएं और चलाएं

स्थायी क्लाउड ऐंकर

ऐप्लिकेशन चलाएं

  1. पक्का करें कि आपके डिवाइस में डेवलपर के लिए सेटिंग और यूएसबी डीबग करने की सुविधा चालू हो.
  2. अपने डिवाइस को यूएसबी की मदद से, डेवलपमेंट मशीन से कनेक्ट करें.
  3. Android Studio में, डिप्लॉयमेंट टारगेट के तौर पर अपना डिवाइस चुनें और चलाएं पर क्लिक करें.

persistent_cloud_anchor_java को आपके डिवाइस पर लॉन्च किया जाना चाहिए, ताकि ARCore, डिवाइस के कैमरे के सामने विमानों का पता लगा सके.

गड़बड़ी: ERROR_NOT_AUTHORIZED

अगर आपको यह गड़बड़ी दिखती है, तो पक्का करें कि ऐप्लिकेशन के लिए OAuth क्लाइंट आईडी सही तरीके से बनाया गया हो:


ऐंकर लगाएं

  1. जब ऐप्लिकेशन हवाई जहाज़ों का पता लगाना शुरू कर देता है, तब स्क्रीन पर टैप करके, खोजे गए किसी एक जहाज़ पर ऐंकर लगाएं.
  2. डाले गए ऐंकर को होस्ट करने के लिए, होस्ट बटन पर टैप करें. यह होस्ट को Google Cloud ऐंकर API पर भेजता है. इसमें वह डेटा शामिल होता है जो ऐंकर की पोज़िशन के बारे में बताता है.

होस्ट का जो अनुरोध किया जाता है वह मान्य जगह पर ऐंकर लागू करता है. साथ ही, उसे Cloud ऐंकर आईडी असाइन करता है. अगर होस्ट का अनुरोध स्वीकार हो जाता है, तो ऐप्लिकेशन को कमरे का कोड दिखाना चाहिए. इस कोड का इस्तेमाल किसी भी डिवाइस पर इस रूम के लिए, पहले होस्ट किए गए ऐंकर को ऐक्सेस करने के लिए किया जा सकता है.

ऐंकर का समाधान करें

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

क्लाउड ऐंकर

ऐप्लिकेशन चलाएं

  1. पक्का करें कि आपके डिवाइस में डेवलपर के लिए सेटिंग और यूएसबी डीबग करने की सुविधा चालू हो.
  2. अपने डिवाइस को यूएसबी की मदद से, डेवलपमेंट मशीन से कनेक्ट करें.
  3. Android Studio में, डिप्लॉयमेंट टारगेट के तौर पर अपना डिवाइस चुनें और चलाएं पर क्लिक करें.

cloud_anchor_java को आपके डिवाइस पर लॉन्च किया जाना चाहिए, ताकि ARCore, डिवाइस के कैमरे के सामने विमानों का पता लगा सके.

गड़बड़ी: com.google.firebase.database.DatabaseException: Failed to get FirebaseDatabase instance: Specify DatabaseURL within FirebaseApp or from your getInstance

अगर आपको यह गड़बड़ी दिखती है, तो पक्का करें कि firebase_url प्रॉपर्टी google-services.json में मौजूद हो. यह पक्का करके कि google-services.json का रीयल टाइम डेटाबेस बनाया और डाउनलोड किया जा चुका है, आप इस प्रॉपर्टी के लिए सही वैल्यू पा सकते हैं.


ऐंकर लगाएं

  1. जब ऐप्लिकेशन हवाई जहाज़ों का पता लगाना शुरू कर देता है, तब स्क्रीन पर टैप करके, खोजे गए किसी एक जहाज़ पर ऐंकर लगाएं.
  2. डाले गए ऐंकर को होस्ट करने के लिए, होस्ट बटन पर टैप करें. यह होस्ट को Google Cloud ऐंकर API पर भेजता है. इसमें वह डेटा शामिल होता है जो ऐंकर की पोज़िशन के बारे में बताता है.

होस्ट का जो अनुरोध किया गया है वह सभी पता लगाता है कि ऐंकर कहां है. साथ ही, उसे Cloud ऐंकर आईडी असाइन करता है. अगर होस्ट का अनुरोध स्वीकार हो जाता है, तो ऐप्लिकेशन को कमरे का कोड दिखाना चाहिए. इस कोड का इस्तेमाल किसी भी डिवाइस पर इस रूम के लिए, पहले होस्ट किए गए ऐंकर को ऐक्सेस करने के लिए किया जा सकता है.

ऐंकर का समाधान करें

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

अब क्या होगा