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

iOS में क्लाउड एंकर के लिए क्विकस्टार्ट

ARCore क्लाउड ऐंकर एपीआई या ARCore क्लाउड ऐंकर सेवा, आपके iOS ऐप्लिकेशन के लिए क्लाउड ऐंकर सुविधा देती है. इससे iOS और Android डिवाइस का इस्तेमाल करने वाले लोग, एआर (ऑगमेंटेड रिएलिटी) वाले अनुभव शेयर कर सकते हैं.

इस गाइड से, आपको इन कामों के बारे में जानकारी मिलेगी:

  • Cloud ऐंकर्स के साथ काम करने के लिए, अपने डेवलपमेंट एनवायरमेंट को सेट अप करें
  • ऐप्लिकेशन के नमूने में होस्ट करने और ऐंकर का इस्तेमाल करने की कोशिश करें

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

क्लाउड ऐंकर का इस्तेमाल करने के लिए, आपको इनकी ज़रूरत होगी:{0/}

  • Xcode 10.1 या इसके बाद का वर्शन

  • Cocoapods 1.4.0 या उसके बाद के वर्शन

  • iOS 11.0 या इसके बाद के वर्शन पर काम करने वाला, ARKit के साथ काम करने वाला Apple डिवाइस (iOS 10.0 या इसके बाद के वर्शन को डिप्लॉय करने का टारगेट होना ज़रूरी है)

क्लाउड ऐंकर का इस्तेमाल करना

क्लाउड ऐंकर के साथ काम करने वाले ऐप्लिकेशन को बनाने और बनाने से जुड़े ज़रूरी टास्क दिखाने के लिए, नीचे दिए गए ऐंकर ऐंकर ऐप्लिकेशन ऐप्लिकेशन का इस्तेमाल करें.

Cloud जोकरों के नमूने वाला ऐप्लिकेशन डाउनलोड करें

  1. ऐप्लिकेशन कोड का नमूना पाने के लिए, GitHub से iOS के लिए ARCore SDK टूल का क्लोन बनाएं या डाउनलोड करें.

  2. एक Terminal या फ़ाइंडर विंडो खोलें और उस फ़ोल्डर पर जाएं जहां आपने SDK टूल का इस्तेमाल किया या डाउनलोड किया था.

  3. आप ऐप्लिकेशन कोड का नमूना
    /arcore-ios-sdk-master/Examples/CloudAnchorExample में देख सकते हैं.

    स्थायी क्लाउड ऐंकर का सैंपल ऐप्लिकेशन कोड,
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample में है.

सेशन सेट अप

सेशन सेट अप करने के दौरान, सैंपल ऐप्लिकेशन इन अहम कामों को करता है:

  • GARSession बनाया जा रहा है
  • कॉलबैक को होस्ट करने और कार्रवाइयों से जुड़ी समस्याओं को हल करने के लिए, GARSessionDelegate सेट करना.
  • एक ARSession बनाना और उसे चलाना
  • ARSessionDelegate सेट करना.
  • session:didUpdateFrame: तरीके से ARFrame को GARSession में पास किया जा रहा है.

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

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

सैंपल ऐप्लिकेशन में Firebase डेटाबेस सेट अप करने के लिए:

  1. अपने ऐप्लिकेशन में Firebase जोड़ने के लिए Firebase निर्देशों का पालन करें.
  2. अपने ऐप्लिकेशन में Firebase जोड़ने के बाद, जनरेट की गई GoogleService-Info.plist फ़ाइल डाउनलोड करें.
  3. सैंपल के लिए Firebase स्टोरेज चालू करें:
    • Firebase कंसोल पर जाएं और वह प्रोजेक्ट चुनें जो आपने नमूना ऐप्लिकेशन के लिए सेट अप किया है.
    • Database पैनल चुनें.
    • Realtime Database विकल्प पर जाकर, Get Started पर क्लिक करें.
    • Security rules for Realtime Database मेन्यू खुलता है.
      • सैंपल चलाने के लिए, Start in test mode चुनें.
      • ध्यान दें कि अगर आप किसी ऐसे ऐप्लिकेशन के लिए Firebase का इस्तेमाल कर रहे हैं जिसे आप प्रकाशित करना चाहते हैं, तो आपको सुरक्षा से जुड़े ज़्यादा नियमों का इस्तेमाल करना चाहिए.
  4. Xcode में, Info.plist फ़ाइल के बगल में, अपने ऐप्लिकेशन में GoogleService-Info.plist फ़ाइल जोड़ें.

कोई API (एपीआई) कुंजी जोड़ें

क्लाउड ऐंकर का इस्तेमाल करने के लिए, आपको ऐप्लिकेशन में एक एपीआई कुंजी जोड़नी होगी.

  1. एपीआई कुंजी पाएं. अगर आप API (एपीआई) कुंजियों के साथ काम कर रहे हैं, तो Google Cloud Platform के सहायता केंद्र में एपीआई कुंजियां सेट अप करना देखें.

  2. अपने Google Cloud Platform प्रोजेक्ट के लिए ARCore Cloud ऐंकर API चालू करें.

  3. Xcode में, अपनी एपीआई कुंजी को ऐप्लिकेशन में जोड़ें. ऐसा करने के लिए, CloudAnchorManager.m में इस कोड को कुंजी के तौर पर जोड़ें:

    self.gSession = [GARSession sessionWithAPIKey:@"Replace me with your API key."
                                 bundleIdentifier:nil
                                            error:nil];
    

पॉड अपडेट चलाएं

Cloudenउदाहरण ऐप्लिकेशन Podfile के साथ शिप किया जाता है, जिसे ARCore SDK टूल और iOS के वर्शन के लिए पहले से कॉन्फ़िगर किया गया है. इन डिपेंडेंसी को इंस्टॉल करने के लिए:

  1. टर्मिनल विंडो खोलें और उस फ़ोल्डर से pod update चलाएं जहां Xcode प्रोजेक्ट मौजूद है.
    यह .xcworkspace फ़ाइल जनरेट करता है जिसका इस्तेमाल आप बाद में ऐप्लिकेशन को बनाने और चलाने के लिए करेंगे.

अपने ऐप्लिकेशन में Podfile कॉन्फ़िगर करने से जुड़ी जानकारी पाने के लिए, अपने ऐप्लिकेशन में ARCore SDK टूल जोड़ें देखें.

  1. प्रोजेक्ट की .xcworkspace फ़ाइल को Xcode में खोलें.

    बिल्ड गड़बड़ियों से बचने के लिए, पक्का करें कि आप .xcodeproj फ़ाइल के बजाय .xcworkspace फ़ाइल से बना रहे हों.

ऐप्लिकेशन बंडल आईडी बदलना

Xcode में, ऐप्लिकेशन का बंडल आईडी बदलें, ताकि आप अपनी टीम के साथ ऐप्लिकेशन पर साइन कर सकें.

ऐप्लिकेशन बनाना और चलाना

  1. अपने डिवाइस को कनेक्ट करें और ऐप्लिकेशन को Xcode में लॉन्च करें.

  2. (ज़रूरी नहीं) अगर आप सैंपल ऐप्लिकेशन बना रहे हैं और चला रहे हैं, तो क्लाउड ऐंकर को होस्ट करने और उनका समाधान करने के लिए ऐप्लिकेशन का इस्तेमाल करने के बारे में जानकारी के लिए नीचे दिया गया सेक्शन देखें.

सैंपल ऐप्लिकेशन आज़माएं

  1. .xcworkspace फ़ाइल को अपने डिवाइस पर लॉन्च करने के लिए उसे बनाएं और चलाएं.

  2. संकेत मिलने पर, ऐप्लिकेशन को कैमरे की अनुमतियां दें. इसके बाद, ARKit आपके कैमरे के सामने जहाज़ों का पता लगाना शुरू करता है.

  3. होस्टिंग मोड में जाने के लिए, HOST पर टैप करें. होस्ट किए गए ऐंकर को शेयर करने के लिए, एक चैट रूम जनरेट किया जाता है. यह कोड आपकी स्क्रीन पर दिखता है.

  4. क्लाउड ऐंकर को होस्ट करने के लिए, प्लेन पर टैप करें.

    • ऐप्लिकेशन प्लेन पर एक एंडी Android ऑब्जेक्ट रखता है और उसे एक ऐंकर जोड़ता है.
    • ARCore क्लाउड ऐंकर एपीआई को एक होस्ट अनुरोध भेजा जाता है. होस्ट के अनुरोध में, आस-पास की विज़ुअल सुविधाओं के हिसाब से ऐंकर की स्थिति से जुड़ा डेटा होता है.
    • ऐंकर को होस्ट करने के बाद, उसे एक आईडी मिलता है. इसका इस्तेमाल, इस स्पेस में क्लाउड ऐंकर को ठीक करने के लिए किया जाता है.
  5. RESOLVE पर टैप करें और रूम कोड डालें. इससे आप पहले या होस्ट किए गए क्लाउड ऐंकर को इस रूम के लिए या किसी दूसरे डिवाइस का इस्तेमाल करके ऐक्सेस कर सकेंगे.

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

अपने ऐप्लिकेशन में ARCore SDK टूल जोड़ें

अपने ऐप्लिकेशन में, आपको #39;ARCore SDK टूल और काम करने वाले iOS वर्शन को शामिल करने के लिए, अपना Podfile अपडेट करना होगा. ऐसा करने के लिए:

  1. नीचे दिए गएplatform और pod अपने प्रोजेक्ट में जोड़ें Podfile:

        platform :ios, '11.0'
        pod 'ARCore/CloudAnchors', '~> 1.33.0'
    
  1. टर्मिनल विंडो खोलें और उस फ़ोल्डर से pod update चलाएं जहां आपका Xcode प्रोजेक्ट मौजूद है.
    यह .xcworkspace फ़ाइल जनरेट करता है, जिसका इस्तेमाल ऐप्लिकेशन बनाने और चलाने के लिए किया जाता है.

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

क्लाउड ऐंकर को लगातार बनाए रखने के हिसाब से, आप क्लाउड ऐंकर को 365 दिनों तक लाइव रहने का समय दे सकते हैं. स्थायी क्लाउड ऐंकर का इस्तेमाल करने के लिए सैंपल कोड /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample GitHub में iOS के लिए ARCore SDK टूल में मौजूद है.

अगले चरण