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

इस गाइड में बताया गया है कि Android पर 'Google फ़िट' का इस्तेमाल कैसे करें.

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

सेटअप

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

कोई Google खाता प्राप्त करें

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

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

अपने डेवलपमेंट होस्ट पर Google Play सेवाओं के लिए सबसे नई क्लाइंट लाइब्रेरी पाएं:

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

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

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

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

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

'Google Play सेवाएं' क्लाइंट लाइब्रेरी जोड़ना

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

Kotlin DSL

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

...

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

ग्रूवी डीएसएल

apply plugin: 'com.android.application'

...

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

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

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

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

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

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