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

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

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

सेटअप

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

Google खाता पाएं

Google Fit API का इस्तेमाल करने के लिए, आपके पास एक 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 डीएसएल

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.5.1")
}

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.5.1'
}

इससे यह पक्का होता है कि 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. ऐक्सेस लागू किया गया: उपयोगकर्ता की ओर से अनुमतियां देने के बाद, आपका ऐप्लिकेशन उन स्कोप से जुड़े डेटा टाइप ऐक्सेस कर सकता है जिनके लिए उपयोगकर्ता ने अनुमति दी है.

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

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