Google Cloud पर ARCore API का इस्तेमाल करना

प्लैटफ़ॉर्म चुनें: Android Unity (AR Foundation) iOS

भौगोलिक डेटा से जुड़े एपीआई और क्लाउड ऐंकर जैसी ARCore की सुविधाएं, Google Cloud पर होस्ट किए गए ARCore API का इस्तेमाल करती हैं. इन सुविधाओं का इस्तेमाल करते समय, आपका ऐप्लिकेशन ARCore API सेवा को ऐक्सेस करने के लिए क्रेडेंशियल का इस्तेमाल करता है.

इस क्विकस्टार्ट में बताया गया है कि ऐप्लिकेशन को कैसे सेट अप किया जाए, ताकि वह Google Cloud पर होस्ट की गई ARCore API सेवा से इंटरैक्ट कर सके.

नया Google Cloud प्रोजेक्ट बनाएं या किसी मौजूदा प्रोजेक्ट का इस्तेमाल करें

अगर आपके पास कोई मौजूदा प्रोजेक्ट है, तो उसे चुनें.

प्रोजेक्ट सिलेक्टर पर जाएं

अगर आपके पास Google Cloud का कोई मौजूदा प्रोजेक्ट नहीं है, तो एक प्रोजेक्ट बनाएं.

नया प्रोजेक्ट बनाना

ARCore API चालू करना

ARCore API का इस्तेमाल करने के लिए, आपको इसे अपने प्रोजेक्ट में चालू करना होगा.

ARCore API चालू करना

अनुमति देने का तरीका सेट अप करना

एक Android ऐप्लिकेशन अनुमति देने के दो अलग-अलग तरीकों का इस्तेमाल करके ARCore API से संपर्क कर सकता है: कुंजी के बिना अनुमति देना (OAuth 2.0), जो सुझाया गया तरीका है और API Key को अनुमति देना:

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

चाबी के बिना

कीलेस ऑथेंटिकेशन सुविधा का इस्तेमाल करके अपने ऐप्लिकेशन को अनुमति देने के लिए, OAuth 2.0 क्लाइंट आईडी बनाएं.

साइनिंग कुंजी के फ़िंगरप्रिंट का पता लगाएं

OAuth 2.0 क्लाइंट आईडी, आपके ऐप्लिकेशन की पहचान करने के लिए, ऐप्लिकेशन के साइनिंग पासकोड के फ़िंगरप्रिंट का इस्तेमाल करता है.

अहम जानकारी: ऐप्लिकेशन पर, अलग-अलग साइनिंग कुंजियों से हस्ताक्षर करना आम बात है. आपको हर साइनिंग पासकोड के लिए, Client-ID बनाना होगा. आम तौर पर, यह डीबग साइनिंग की और रिलीज़ साइनिंग पासकोड का इस्तेमाल करता है.

डीबग साइनिंग फ़िंगरप्रिंट पाने का तरीका

अपने प्रोजेक्ट को चलाते या डीबग करते समय, Android SDK टूल आपके ऐप्लिकेशन को अपने-आप जनरेट किए गए डीबग सर्टिफ़िकेट की मदद से साइन करते हैं.

• Android Studio में, gradle टूलपैन खोलें.
• project-name > Tasks > android पर जाएं.
• signingReport टास्क को चलाएं.

  

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

कीस्टोर से साइनिंग फ़िंगरप्रिंट पाने का तरीका

अगर आपके पास कीस्टोर फ़ाइल है, तो फ़िंगरप्रिंट का पता लगाने के लिए keytool यूटिलिटी का इस्तेमाल करें.

keytool -list -v -alias your-key-name -keystore path-to-production-keystore

इसके बाद, keytool यूटिलिटी फ़िंगरप्रिंट को टर्मिनल पर प्रिंट करती है. उदाहरण के लिए:

   Certificate fingerprint: SHA1: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09

'Play ऐप्लिकेशन साइनिंग' से अपने ऐप्लिकेशन का साइनिंग पासकोड पाने का तरीका

Play ऐप्लिकेशन साइनिंग का इस्तेमाल करते समय, Google आपके ऐप्लिकेशन के साइनिंग पासकोड को मैनेज करता है और उसका इस्तेमाल आपके APKs पर साइन करने के लिए करता है. इस डिजिटल बटन का इस्तेमाल, साइनिंग फ़िंगरप्रिंट के लिए किया जाना चाहिए.

1. Google Play Console में ऐप्लिकेशन साइनिंग पेज पर, स्क्रोल करके ऐप्लिकेशन साइनिंग पासकोड के सर्टिफ़िकेट पर जाएं.
2. SHA-1 प्रमाणपत्र फ़िंगरप्रिंट का इस्तेमाल करें.

OAuth 2.0 क्लाइंट आईडी बनाना

पिछले चरणों में लागू किए गए हर साइनिंग पासकोड के लिए, अपने Google Cloud प्रोजेक्ट के क्रेडेंशियल में OAuth 2.0 क्लाइंट आईडी बनाएं.

• Google Cloud में, क्रेडेंशियल पेज खोलें.

  क्रेडेंशियल

• क्रेडेंशियल बनाएं पर क्लिक करें. इसके बाद, मेन्यू से OAuth क्लाइंट आईडी चुनें.

• ज़रूरी फ़ील्ड इस तरह भरें:

  • ऐप्लिकेशन का प्रकार: Android चुनें.
  • पैकेज का नाम: अपने AndroidManifest.xml में बताए गए तरीके से पैकेज के नाम का इस्तेमाल करें.
  • SHA-1 सर्टिफ़िकेट फ़िंगरप्रिंट: पिछले चरणों में मिले फ़िंगरप्रिंट का इस्तेमाल करें.

• बनाएं दबाएं.

ज़रूरी लाइब्रेरी शामिल करें

1. अपने ऐप्लिकेशन की डिपेंडेंसी में com.google.android.gms:play-services-auth:16+ शामिल करें.

2. अगर कोड छोटा करने का इस्तेमाल किया जा रहा है, तो इसे अपने ऐप्लिकेशन की build.gradle फ़ाइल में जोड़ें:

   buildTypes {
     release {
       ...
       proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
     }
   }
   

3. अपने ऐप्लिकेशन की proguard-rules.pro फ़ाइल में यह जोड़ें:

   -keep class com.google.android.gms.common.** { *; }
   -keep class com.google.android.gms.location.** { *; }
   -keep class com.google.android.gms.auth.** { *; }
   -keep class com.google.android.gms.tasks.** { *; }
   

आपके ऐप्लिकेशन को अब बिना चाबी के पुष्टि करने की सुविधा का इस्तेमाल करने के लिए कॉन्फ़िगर कर दिया गया है.

API (एपीआई) कुंजी

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

3. Android Studio में, अपने प्रोजेक्ट में नई एपीआई पासकोड जोड़ें. एपीआई पासकोड को अपने ऐप्लिकेशन के AndroidManifest.xml के <application> एलिमेंट में मौजूद <meta-data> एलिमेंट में शामिल करें:

   <meta-data
     android:name="com.google.android.ar.API_KEY"
     android:value="API_KEY"/>
   

4. अपनी एपीआई पासकोड को सुरक्षित रखने के लिए, एपीआई पासकोड से जुड़ी पाबंदियों से जुड़ा दस्तावेज़ देखें.

आपका ऐप्लिकेशन अब एपीआई पासकोड का इस्तेमाल करने के लिए कॉन्फ़िगर हो गया है.

आगे क्या करना है

अनुमति कॉन्फ़िगर होने के बाद, ARCore की ये सुविधाएं देखें, जो इसका इस्तेमाल करती हैं:

• भौगोलिक डेटा का एपीआई
• Cloud ऐंकर एपीआई