ARCore Cloud Anchor API या ARCore Cloud Anchor सेवा में, आपके iOS ऐप्लिकेशन के लिए क्लाउड ऐंकर सुविधाएं उपलब्ध हैं इसमें iOS और Android, दोनों डिवाइसों का इस्तेमाल करने वाले लोग एआर के अनुभव शेयर कर सकते हैं.
इस गाइड में आपको ये काम करने का तरीका बताया गया है:
- Cloud Anchors के साथ काम करने के लिए, अपने डेवलपमेंट एनवायरमेंट को सेट अप करें
- सैंपल ऐप्लिकेशन में ऐंकर और होस्ट से जुड़ी समस्याओं को ठीक करने की कोशिश करें
ज़रूरी शर्तें
- Xcode का 13.0 या इसके बाद का वर्शन
- अगर Cocoapods का इस्तेमाल किया जा रहा है, तो Cocoapods 1.4.0 या उसके बाद का वर्शन
- iOS 12.0 या इसके बाद के वर्शन पर चलने वाला ARKit के साथ काम करने वाला Apple डिवाइस (iOS 12.0 या इसके बाद के वर्शन का डिप्लॉयमेंट टारगेट ज़रूरी है)
Cloud ऐंकर का इस्तेमाल करना
नीचे दिए गए चरण, क्लाउड ऐंकर सैंपल ऐप्लिकेशन का इस्तेमाल करके, आपको ज़रूरी जानकारी ARCore Cloud Anchors के साथ काम करने वाले ऐप्लिकेशन को कॉन्फ़िगर करने और बनाने के टास्क हैं.
Cloud Anchors का सैंपल ऐप्लिकेशन डाउनलोड करें
GitHub से iOS के लिए ARCore SDK टूल का क्लोन बनाएं या उसे डाउनलोड करें सैंपल कोड पाने के लिए.
Terminal या Finder विंडो खोलें और उस फ़ोल्डर पर जाएं जहां आपने क्लोन किया है या SDK टूल डाउनलोड किया है.
ऐप्लिकेशन का सैंपल कोड,
में देखा जा सकता है/arcore-ios-sdk-master/Examples/CloudAnchorExample.परसिस्टेंट क्लाउड ऐंकर के ऐप्लिकेशन का सैंपल कोड यह है
में/arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample.
सेशन सेटअप
सैंपल ऐप्लिकेशन, सेशन:
GARSessionबनाया जा रहा हैARSessionबनाया जा रहा है और बिना किसी रुकावट के चलाया जा सकता हैARSessionDelegateको सेट किया जा रहा है.- पास होने वाले
ARFrameसे॰session:didUpdateFrame:तरीके मेंGARSessionतक.
क्लाउड ऐंकर आईडी शेयर करने की सुविधा सेट अप करें
Cloud Anchors का नमूना ऐप्लिकेशन, Firebase का इस्तेमाल करता है, ताकि उनके बीच Cloud एंकर आईडी शेयर किए जा सकें डिवाइस. अपने ऐप्लिकेशन में किसी दूसरे तरीके का इस्तेमाल किया जा सकता है.
सैंपल ऐप्लिकेशन में Firebase डेटाबेस सेट अप करने के लिए:
- अपने ऐप्लिकेशन में Firebase जोड़ने के लिए, Firebase के निर्देशों का पालन करें.
- फ़ाइल जोड़ते समय जनरेट हुई
GoogleService-Info.plistफ़ाइल डाउनलोड करें Firebase को आपके ऐप्लिकेशन से जोड़ना. - सैंपल के लिए Firebase स्टोरेज चालू करें:
- Firebase कंसोल पर जाएं और वह प्रोजेक्ट चुनें जिसके लिए आपने सेट अप किया है सैंपल के तौर पर मार्क किया गया है.
- Database पैनल चुनें.
- Realtime Database विकल्प में, Get Started पर क्लिक करें.
- Security rules for Realtime Database मेन्यू खुलता है.
- सैंपल चलाने के लिए, Start in test mode चुनें.
- ध्यान दें कि अगर आपको किसी ऐसे ऐप्लिकेशन के लिए Firebase का इस्तेमाल करना है जिसे पब्लिश करना है, आपको ज़्यादा पाबंदी वाले सुरक्षा नियमों का इस्तेमाल करना चाहिए.
- Xcode में, अपने ऐप्लिकेशन में
GoogleService-Info.plistफ़ाइल जोड़ें. इसके आगे,Info.plist.
ARCore API सेट अप करना
Cloud Anchors का इस्तेमाल करने के लिए, आपको सबसे पहले ARCore API का इस्तेमाल करना होगा.
पॉड अपडेट चलाएं
CloudAnchorExample ऐप्लिकेशन, Podfile के साथ पहले से कॉन्फ़िगर किया गया है.
आपको इन ARCore SDK टूल और iOS वर्शन की ज़रूरत पड़ेगी. इन डिपेंडेंसी को इंस्टॉल करने के लिए:
- Terminal विंडो खोलें और उस फ़ोल्डर से
pod updateचलाएं जहां Xcode प्रोजेक्ट मौजूद है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इससे एक.xcworkspaceफ़ाइल जनरेट होगी, जिसका इस्तेमाल आप बाद में अपने ऐप्लिकेशन चलाना.
अपने ऐप्लिकेशन में ARCore SDK टूल जोड़ना लेख पढ़ें
Podfile को अपने ऐप्लिकेशन में कॉन्फ़िगर करने के बारे में जानकारी के लिए.
प्रोजेक्ट की
.xcworkspaceफ़ाइल को Xcode में खोलें.बिल्ड से जुड़ी गड़बड़ियों से बचने के लिए, पक्का करें कि आपको
.xcworkspaceसे बिल्डिंग बनाना हो फ़ाइल है, न कि.xcodeprojफ़ाइल.
ऐप्लिकेशन बंडल का आईडी बदलना
Xcode में, ऐप्लिकेशन का बंडल आईडी बदलें, ताकि आप अपनी टीम के साथ ऐप्लिकेशन पर हस्ताक्षर कर सकें.
ऐप्लिकेशन बनाएं और चलाएं
अपने डिवाइस को कनेक्ट करें और ऐप्लिकेशन को Xcode में लॉन्च करें.
(ज़रूरी नहीं) अगर सैंपल ऐप्लिकेशन बनाया और चलाया जा रहा है, तो ये देखें सेक्शन पढ़ें.
सैंपल ऐप्लिकेशन आज़माएं
लॉन्च करने के लिए,
.xcworkspaceफ़ाइल से सैंपल ऐप्लिकेशन बनाएं और चलाएं अपने डिवाइस पर रखते हैं.अगर कहा जाए, तो ऐप्लिकेशन को कैमरा इस्तेमाल करने की अनुमति दें. ARKit फिर आपके कैमरे के सामने मौजूद हवाई जहाज़ों का पता लगाना शुरू कर देता है.
होस्टिंग मोड में जाने के लिए HOST पर टैप करें. होस्ट किए गए ऐंकर शेयर करने के लिए रूम कोड जनरेट होता है और आपकी स्क्रीन पर दिखता है.
किसी हवाई जहाज़ पर टैप करके, वहां क्लाउड ऐंकर शो होस्ट करें.
- यह ऐप्लिकेशन हवाई जहाज़ में एक एंडी Android ऑब्जेक्ट लगाता है और एक ऐंकर जोड़ता है करना है.
- ARCore API के क्लाउड एंडपॉइंट पर, होस्ट करने का अनुरोध भेजा गया है. होस्ट अनुरोध में वह डेटा शामिल होता है जो आस-पास मौजूद विज़ुअल सुविधाएँ.
- ऐंकर के होस्ट हो जाने के बाद, इसे एक आईडी मिलता है. इसका इस्तेमाल क्लाउड समस्याओं को ठीक करने के लिए किया जाता है ऐंकर के तौर पर जोड़ें.
RESOLVE पर टैप करें और पहले से ऐक्सेस करने के लिए रूम कोड डालें इस रूम के लिए, उसी या किसी दूसरे डिवाइस का इस्तेमाल करके Cloud Anchors होस्ट किया गया है.
- समाधान का अनुरोध, ARCore API के क्लाउड एंडपॉइंट पर भेजा जाता है.
- समाधान के अनुरोध में एक क्लाउड ऐंकर आईडी शामिल होता है. अगर आईडी होस्ट किया गया ऐंकर और स्थानीय भाषा के अनुसार लिखना सफल होता है, तो सर्वर अपने स्थानीय निर्देशांकों में लंगर का रूपांतरण.
- सैंपल ऐप्लिकेशन, ऐंकर को आपके सीन में जोड़ने के लिए ट्रांसफ़ॉर्म ऐक्शन का इस्तेमाल करता है और उसके साथ जुड़े वर्चुअल ऑब्जेक्ट को रेंडर करने में मदद करता है.
अपने ऐप्लिकेशन में ARCore SDK टूल जोड़ें
अपने ऐप्लिकेशन में, आपको अपने Podfile को अपडेट करना होगा, ताकि
ARCore SDK टूल और इसके साथ काम करने वाले iOS वर्शन. ऐसा करने के लिए:
अपने
platformpodप्रोजेक्ट काPodfile:platform :ios, '11.0' pod 'ARCore/CloudAnchors', '~> 1.45.0'
- टर्मिनल विंडो खोलें और उस फ़ोल्डर से
pod updateको चलाएं जहां आपका Xcode प्रोजेक्ट मौजूद है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इससे एक.xcworkspaceफ़ाइल जनरेट होगी, जिसका इस्तेमाल करके ऐप्लिकेशन चलाना.
स्थायी क्लाउड ऐंकर
जैसा कि परसिस्टेंस के साथ क्लाउड ऐंकर होस्ट करें में बताया गया है,
क्लाउड ऐंकर को 365 दिनों तक लाइव रहने का समय दिया जा सकता है. इसके लिए सैंपल कोड
/arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample में स्थायी क्लाउड ऐंकर का इस्तेमाल करने की सुविधा उपलब्ध है
GitHub से iOS के लिए ARCore SDK टूल की डायरेक्ट्री मिलेगी.
अगले चरण
iOS के लिए Cloud Anchors डेवलपर गाइड देखें ऐप्लिकेशन कोड का नमूना एक्सप्लोर करने और Cloud Anchors के साथ काम करने के बारे में ज़्यादा जानने के लिए ऐसा कर सकते हैं आपके ऐप्लिकेशन में दिखते हैं.
जानकारी देखने के लिए, ARCore iOS API का संदर्भ देखें.