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

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

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

सेटअप

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

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

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

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

अपने डेवलपमेंट से जुड़ी Google Play सेवाओं के लिए, क्लाइंट लाइब्रेरी का नया वर्शन पाएं होस्ट:

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

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

फ़िटनेस एपीआई को चालू करने के लिए, 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")
}

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

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 टूल को अपने-आप डाउनलोड कर लेता है आपका ऐप्लिकेशन बनाता है.

अपना ऐप्लिकेशन बनाएं और उसकी जांच करें

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

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

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

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

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

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

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

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

Fitness API क्लाइंट बनाने का उदाहरण देखें.

नतीजे में मिलने वाला उपयोगकर्ता का ऑथराइज़ेशन फ़्लो

नीचे दिए गए कार्ड से पता चलता है कि उपयोगकर्ताओं को किस तरह का ऑथराइज़ेशन फ़्लो मिलता है जब उनसे अनुमति मांगी जाती है:

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

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

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

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