ARCore Cloud Anchor API या ARCore Cloud Anchor सेवा में, आपके iOS ऐप्लिकेशन के लिए क्लाउड ऐंकर सुविधाएं उपलब्ध हैं इसमें iOS और Android, दोनों डिवाइसों का इस्तेमाल करने वाले लोग एआर के अनुभव शेयर कर सकते हैं.
इस गाइड में आपको ये काम करने का तरीका बताया गया है:
- Cloud Anchors के साथ काम करने के लिए, अपने डेवलपमेंट एनवायरमेंट को सेट अप करें
- सैंपल ऐप्लिकेशन में ऐंकर और होस्ट से जुड़ी समस्याओं को ठीक करने की कोशिश करें
ज़रूरी शर्तें
- Xcode का 13.0 या इसके बाद का वर्शन
- Cocoapods का इस्तेमाल करने पर, Cocoapods 1.4.0 या इसके बाद का वर्शन
- ARKit के साथ काम करने वाला Apple डिवाइस, जिसमें iOS 12.0 या इसके बाद का वर्शन हो (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 का सैंपल ऐप्लिकेशन, डिवाइसों के बीच Cloud Anchor आईडी शेयर करने के लिए Firebase का इस्तेमाल करता है. अपने ऐप्लिकेशन में किसी दूसरे तरीके का इस्तेमाल किया जा सकता है.
सैंपल ऐप्लिकेशन में 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 सेट अप करना
क्लाउड ऐंकर का इस्तेमाल करने के लिए, आपको सबसे पहले अपने ऐप्लिकेशन के लिए ARCore API सेट अप करना होगा.
पॉड अपडेट चलाएं
CloudAnchorExample ऐप्लिकेशन, Podfile के साथ पहले से कॉन्फ़िगर किया गया है.
आपको इन ARCore SDK टूल और iOS वर्शन की ज़रूरत पड़ेगी. इन डिपेंडेंसी को इंस्टॉल करने के लिए:
- Terminal विंडो खोलें और उस फ़ोल्डर से
pod updateचलाएं जहां Xcode प्रोजेक्ट मौजूद है.
इससे एक.xcworkspaceफ़ाइल जनरेट होती है. इसका इस्तेमाल, बाद में ऐप्लिकेशन बनाने और उसे चलाने के लिए किया जाएगा.
अपने ऐप्लिकेशन में Podfile को कॉन्फ़िगर करने के बारे में जानने के लिए, अपने ऐप्लिकेशन में ARCore SDK टूल जोड़ना देखें.
Xcode में प्रोजेक्ट के लिए
.xcworkspaceफ़ाइल खोलें.बिल्ड करने से जुड़ी गड़बड़ियों से बचने के लिए, पक्का करें कि आपने
.xcworkspaceफ़ाइल से बिल्ड किया हो, न कि.xcodeprojफ़ाइल से.
ऐप्लिकेशन बंडल आईडी बदलना
Xcode में, ऐप्लिकेशन का बंडल आईडी बदलें, ताकि आप अपनी टीम के साथ ऐप्लिकेशन पर हस्ताक्षर कर सकें.
ऐप्लिकेशन बनाना और चलाना
अपना डिवाइस कनेक्ट करें और Xcode में ऐप्लिकेशन लॉन्च करें.
(ज़रूरी नहीं) अगर सैंपल ऐप्लिकेशन बनाया जा रहा है और उसे चलाया जा रहा है, तो Cloud Anchors को होस्ट करने और उन्हें रिज़ॉल्व करने के लिए, ऐप्लिकेशन का इस्तेमाल करने के बारे में जानने के लिए यहां दिया गया सेक्शन देखें.
सैंपल ऐप्लिकेशन आज़माएं
.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.46.0'
- टर्मिनल विंडो खोलें और उस फ़ोल्डर से
pod updateको चलाएं जहां आपका Xcode प्रोजेक्ट मौजूद है.
इससे एक.xcworkspaceफ़ाइल जनरेट होती है. इसका इस्तेमाल, ऐप्लिकेशन को बनाने और चलाने के लिए किया जाता है.
हमेशा दिखने वाले क्लाउड ऐंकर
परसिस्टेंस के साथ क्लाउड ऐंकर होस्ट करना में बताए गए तरीके के मुताबिक, क्लाउड ऐंकर के लिए 365 दिन तक का टाइम-टू-लाइव सेट किया जा सकता है. इसके लिए सैंपल कोड
/arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample में स्थायी क्लाउड ऐंकर का इस्तेमाल करने की सुविधा उपलब्ध है
GitHub से iOS के लिए ARCore SDK टूल की डायरेक्ट्री मिलेगी.
अगले चरण
iOS के लिए Cloud Anchors डेवलपर गाइड देखें ऐप्लिकेशन कोड का नमूना एक्सप्लोर करने और Cloud Anchors के साथ काम करने के बारे में ज़्यादा जानने के लिए ऐसा कर सकते हैं आपके ऐप्लिकेशन में दिखते हैं.
ARCore iOS API रेफ़रंस में जानकारी देखें.