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. SDK टूल में जाकर, 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.2.0")
        implementation("com.google.android.gms:play-services-auth:21.3.0")
}

Groovy DSL

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

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

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