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