Android पर इस्तेमाल शुरू करना

इस गाइड में, Android पर Google Fit के साथ डेवलपमेंट शुरू करने का तरीका बताया गया है.

ध्यान दें: Google Fit, Google Play services का हिस्सा है. Google Play services का इस्तेमाल करने से, आपके ऐप्लिकेशन को मिलने वाले फ़ायदों के बारे में जानें.

सेटअप

अपना ऐप्लिकेशन बनाने से पहले, यहां दिए गए सेक्शन में बताए गए चरणों को पूरा करें.

Google खाता पाएं

Google Fit के एपीआई का इस्तेमाल करने के लिए, आपके पास एक Google खाता होना चाहिए. नया खाता बनाया जा सकता है या किसी मौजूदा खाते का इस्तेमाल किया जा सकता है. हो सकता है कि आपको उपयोगकर्ता के नज़रिए से अपने ऐप्लिकेशन को टेस्ट करने के लिए, कोई अलग खाता बनाना पड़े.

Google Play सेवाएं पाएं

अपने डेवलपमेंट होस्ट पर, Google Play services की क्लाइंट लाइब्रेरी का नया वर्शन डाउनलोड करें:

1. Android SDK Manager खोलें.
2. **एसडीके टूल** में जाकर, **Google Play services** ढूंढें.
3. अगर इन पैकेज की स्थिति इंस्टॉल नहीं किया गया नहीं है, तो दोनों को चुनें और **पैकेज इंस्टॉल करें** पर क्लिक करें.

OAuth 2.0 क्लाइंट आईडी पाएं

Fitness API को चालू करने के लिए, OAuth 2.0 क्लाइंट आईडी पाएं.

अपना प्रोजेक्ट बनाना और उसे कॉन्फ़िगर करना

हमारा सुझाव है कि Fitness API की मदद से ऐप्लिकेशन बनाने के लिए, Android Studio डेवलपमेंट एनवायरमेंट का इस्तेमाल करें. Android Studio में नया प्रोजेक्ट बनाने और उसे कॉन्फ़िगर करने के बारे में जानने के लिए, कोई प्रोजेक्ट बनाना लेख पढ़ें.

Google Play services की क्लाइंट लाइब्रेरी जोड़ना

Android Studio में, अपने मॉड्यूल के लिए build.gradle फ़ाइल खोलें और Google Play services की क्लाइंट लाइब्रेरी को डिपेंडेंसी के तौर पर जोड़ें:

Kotlin DSL

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:21.6.0")
}

Groovy DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:21.6.0'
}

इससे यह पक्का होता है कि Gradle, आपका ऐप्लिकेशन बनाते समय, फ़िटनेस एसडीके को अपने-आप डाउनलोड कर ले.

अपना ऐप्लिकेशन बनाना और उसे टेस्ट करना

सेटअप के चरण पूरे करने के बाद, अपना ऐप्लिकेशन बनाया जा सकता है. शुरू करने के लिए, यह जानें कि आपका ऐप्लिकेशन किस तरह का डेटा सेव और पढ़ सकता है. Google Fit में डेटा के साथ काम करने के बारे में ज़्यादा जानें.

Android की ज़रूरी अनुमतियां पाना

कुछ तरह का डेटा पढ़ने और उसमें बदलाव करने के लिए, आपके ऐप्लिकेशन को Android की अनुमतियों का अनुरोध करना होगा.

OAuth की अनुमतियां पाना

आपका ऐप्लिकेशन, जिन डेटा टाइप को ऐक्सेस करने की अनुमति मांगता है वे ऑथराइज़ेशन स्कोप से जुड़े होते हैं. इन अनुमतियों का अनुरोध करने के लिए, आपको यह जोड़ना होगा कि आपके ऐप्लिकेशन को किन डेटा टाइप को ऐक्सेस करने की ज़रूरत है FitnessOptions इंस्टेंस में. जब आपका ऐप्लिकेशन, Google Fit के किसी भी डेटा टाइप का इस्तेमाल करने का अनुरोध करता है, तो Android SDK अपने-आप यह जांच करता है कि वे किस स्कोप से जुड़े हैं. इसके बाद, वह उपयोगकर्ता से उन स्कोप के लिए अनुमति मांगता है.

एपीआई क्लाइंट बनाना

कोई एपीआई क्लाइंट बनाएं और उसमें उन डेटा टाइप को जोड़ें जिन्हें आपके ऐप्लिकेशन को डेटा लिखने या पढ़ने के लिए ऐक्सेस करने की ज़रूरत है. ये एंडपॉइंट उपलब्ध हैं:

• SensorsClient: स्थानीय डिवाइस और कंपैनियन डिवाइसों में मौजूद हार्डवेयर सेंसर से, सेहत और तंदुरुस्ती से जुड़ा डेटा के अलग-अलग सोर्स ऐक्सेस करें.
• RecordingClient: सेंसर डेटा को कम पावर में, हमेशा चालू रहने वाले बैकग्राउंड में इकट्ठा करने के लिए.
• HistoryClient: Google Fit में, पुराना डेटा डालें, मिटाएं, और पढ़ें.
• SessionsClient: उपयोगकर्ता गतिविधि के सेशन बनाएं और मैनेज करें.
• GoalsClient: Google Fit में, उपयोगकर्ताओं के बनाए गए हार्ट पॉइंट और कदमों के लक्ष्यों को पढ़ें.
• ConfigClient: Google Fit प्लैटफ़ॉर्म में, कस्टम डेटा टाइप और सेटिंग ऐक्सेस करें.

Fitness API क्लाइंट बनाने का तरीका जानने के लिए, यह उदाहरण देखें.

उपयोगकर्ता की अनुमति का फ़्लो

यहां अनुमति के उस फ़्लो के बारे में बताया गया है जो उपयोगकर्ताओं को तब दिखता है, जब उनसे अनुमतियां मांगी जाती हैं:

पहली इमेज.उपयोगकर्ताओं के लिए अनुमति का फ़्लो.

1. Android की अनुमतियां: उपयोगकर्ता, आपका ऐप्लिकेशन डाउनलोड करने से पहले यह देख पाते हैं कि उसने Android की किन अनुमतियों का अनुरोध किया है. आपका ऐप्लिकेशन डाउनलोड होने के बाद, वह रनटाइम की उन अनुमतियों का अनुरोध करता है जिनकी उसे ज़रूरत होती है. इसके बाद, उपयोगकर्ता इन अनुमतियों को स्वीकार या अस्वीकार करते हैं.
2. जांच करना और कनेक्ट करना: आपका ऐप्लिकेशन, अन्य डेटा टाइप को ऐक्सेस करने का अनुरोध करने से पहले यह जांच करता है कि अनुमतियां दी गई हैं या नहीं.
3. OAuth स्कोप का अनुरोध: Google, उपयोगकर्ता को यह सूचना दिखाता है कि वह आपके ऐप्लिकेशन को उन डेटा टाइप के लिए OAuth स्कोप की अनुमति दे जिन्हें वह ऐक्सेस करना चाहता है.
4. ऐक्सेस लागू किया गया: उपयोगकर्ता की ओर से अनुमतियां देने के बाद, आपका ऐप्लिकेशन उन डेटा टाइप को ऐक्सेस कर सकता है जो उन स्कोप से जुड़े हैं जिनके लिए उपयोगकर्ता ने अनुमति दी है.

पुष्टि के लिए आवेदन करना

अपना ऐप्लिकेशन बनाने और उसे टेस्ट करने के बाद, आपको पुष्टि के लिए आवेदन करना होगा . इसके लिए, संवेदनशील और पाबंदियों वाले स्कोप के लिए, अलग-अलग लेवल पर वजह बतानी होगी .