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

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 क्लाइंट लाइब्रेरी को डिपेंडेंसी के तौर पर जोड़ें:

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

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

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

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