Health Connect, सेहत और फ़िटनेस से जुड़ा डेटा सेव और व्यवस्थित करता है. इसमें यह भी ध्यान रखा जाता है कि अलग-अलग तरह के डेटा को कैसे मेज़र किया जाता है. इस तरह के डेटा में, तुरंत ली गई दिल की धड़कन की दर, समय के साथ कदमों की संख्या, और सेशन के दौरान ली गई नींद का डेटा शामिल होता है.
सबसे पहले यह समझना ज़रूरी है कि Health Connect पर किस तरह का डेटा और अनुमतियां मिलती हैं. इससे, आपको अपने ऐप्लिकेशन की ज़रूरतों के हिसाब से प्लान बनाने में मदद मिलेगी. साथ ही, अपनी ज़रूरतों को तय करने से पहले, आपको अपने डेटा टाइप की समीक्षा करनी होगी.
डेटा टाइप की कैटगरी
Health Connect में ऐसे डेटा टाइप काम करते हैं जिनका इस्तेमाल ज़्यादातर सेहत और फ़िटनेस ऐप्लिकेशन में किया जाता है. इससे, आपको ज़्यादा से ज़्यादा डेटा टाइप मिल पाते हैं. Health Connect का मकसद, सेहत और फ़िटनेस से जुड़े डेटा को एक ही जगह सेव करना और उसे बेहतर तरीके से दिखाना है. ये डेटा टाइप इन कैटगरी में आते हैं:
- गतिविधि: यह उपयोगकर्ता की किसी भी गतिविधि को कैप्चर करता है. इसमें दौड़ने और तैरने जैसी सेहत और फ़िटनेस से जुड़ी गतिविधियां शामिल हो सकती हैं.
- शरीर की मेज़रमेंट: यह शरीर से जुड़ा सामान्य डेटा कैप्चर करता है. जैसे, उपयोगकर्ता का वज़न और उसका बेसल मेटाबॉलिक रेट.
- पीरियड साइकल ट्रैकिंग: इससे माहवारी के साइकल और उससे जुड़े डेटा पॉइंट कैप्चर किए जाते हैं. जैसे, ऑव्युलेशन टेस्ट का बाइनरी नतीजा.
- पोषण: इसमें हाइड्रेशन और पोषण से जुड़ा डेटा टाइप शामिल होता है. पहले मेट्रिक से पता चलता है कि कोई उपयोगकर्ता एक बार में कितना पानी पीता है. बाद वाले में, कैलोरी, चीनी, और मैग्नीशियम जैसे वैकल्पिक फ़ील्ड शामिल होते हैं.
- नींद: यह उपयोगकर्ता की नींद के समय और टाइप से जुड़ा इंटरवल डेटा कैप्चर करता है.
- ज़रूरी जानकारी: इसमें उपयोगकर्ता की सामान्य सेहत के बारे में अहम जानकारी कैप्चर की जाती है. इसमें शरीर का तापमान, ब्लड ग्लूकोज़, रक्तचाप, और खून में ऑक्सीजन की मात्रा जैसा डेटा शामिल होता है.
डेटा टाइप का फ़ॉर्मैट
Health Connect में डेटा टाइप, ऐसे ऑब्जेक्ट में सेव होते हैं जो Record
के सबक्लास होते हैं.
हर डेटा टाइप के लिए, उससे जुड़े फ़ील्ड होते हैं. ये फ़ील्ड, time
और zoneOffset
जैसे सामान्य या title
, count
, और percentage
जैसे खास हो सकते हैं.
कुछ फ़ील्ड, आसान टाइप का इस्तेमाल करते हैं, जैसे कि long, double या string. वहीं, कुछ फ़ील्ड, एनोटेशन और क्लास जैसे मुश्किल टाइप का इस्तेमाल करते हैं, जैसे कि Instant
और ZoneOffset
. इन फ़ील्ड के एट्रिब्यूट ज़रूरी या वैकल्पिक हो सकते हैं. कुछ एट्रिब्यूट रीड-ओनली होते हैं और कुछ एट्रिब्यूट की वैल्यू तय सीमा में होनी चाहिए.
उपलब्ध डेटा टाइप और उनके फ़ील्ड की पूरी सूची के लिए, Jetpack में मौजूद क्लास देखें.
अन्य डेटा एट्रिब्यूट
Health Connect API के डेटा में, यहां दी गई सूची में बताए गए मेटाडेटा एट्रिब्यूट भी शामिल होते हैं:
- Health Connect आईडी: डेटा बनाने पर, हर पॉइंट को एक यूनीक आइडेंटिफ़ायर (यूआईडी) असाइन किया जाता है. यह स्टैंडर्ड रीड और राइट ऑपरेशन के लिए फ़ायदेमंद है. ज़्यादा जानकारी के लिए, Health Connect आईडी देखें.
- पिछली बार बदलाव किए जाने का समय: यह टाइमस्टैंप, रिकॉर्ड में आखिरी बार किए गए बदलाव को दिखाता है. यह रिकॉर्ड बनाने या हर अपडेट पर अपने-आप जनरेट होता है.
- डेटा का सोर्स: Health Connect उस ऐप्लिकेशन के बारे में जानकारी सेव करता है जहां से डेटा आया है. इसमें उस ऑरिजिन का पैकेज नाम होता है, जो बनाने पर अपने-आप जुड़ जाता है.
- डिवाइस: Health Connect उस डिवाइस की जानकारी सेव करता है जिससे डेटा मिला है. इसमें उस डिवाइस के मैन्युफ़ैक्चरर और मॉडल की जानकारी होती है. इसकी वैल्यू मैन्युअल तरीके से डाली जाती है.
- क्लाइंट आईडी: Health Connect, क्लाइंट आईडी उपलब्ध कराता है, ताकि क्लाइंट ऐप्लिकेशन अपने आईडी का इस्तेमाल करके डेटा को रेफ़र कर सकें. इससे, डेटा में होने वाली गड़बड़ियों को ठीक करने और डेटा को सिंक करने में मदद मिलती है. इसे रिकॉर्ड में मैन्युअल तरीके से डाला जाता है.
- क्लाइंट रिकॉर्ड का वर्शन: क्लाइंट आईडी के साथ-साथ, Health Connect में वर्शन की सुविधा भी मिलती है. इससे डेटा सिंक करने के दौरान होने वाले बदलावों को ट्रैक करने में मदद मिलती है. इसे रिकॉर्ड में मैन्युअल तरीके से डाला जाता है.
- डेटा रिकॉर्ड करने का तरीका: Health Connect की मदद से, यह समझा जा सकता है कि डेटा कैसे रिकॉर्ड किया जाता है. इन तरीकों में, ऐप्लिकेशन के अपने-आप डेटा रिकॉर्ड करने के साथ-साथ, उपयोगकर्ताओं के मैन्युअल तरीके से या सक्रिय रूप से डेटा रिकॉर्ड करने की सुविधा शामिल है.
Health Connect आईडी
Health Connect, नए डेटा ऑब्जेक्ट को यूनीक आइडेंटिफ़ायर (यूआईडी) असाइन करता है. इससे डेटा ऑब्जेक्ट की पहचान की जाती है और उन्हें दूसरे ऑब्जेक्ट से अलग किया जाता है. Health Connect आईडी, डेटा पढ़ने या उसमें बदलाव करने के अनुरोधों के लिए काम के होते हैं. Health Connect आईडी, क्लाइंट आईडी से अलग होते हैं. क्लाइंट ऐप्लिकेशन, क्लाइंट आईडी असाइन करता है, जबकि Health Connect सिर्फ़ Health Connect आईडी असाइन करता है.
Health Connect आईडी का इस्तेमाल करते समय, इन बातों का ध्यान रखें:
- सेशन का एक Health Connect आईडी होता है, लेकिन सेशन में मौजूद डेटा के अपने Health Connect आईडी होते हैं.
- Health Connect आईडी, टाइमस्टैंप से जुड़े नहीं होते.
- कुछ इस्तेमाल के उदाहरणों में, वर्कफ़्लो के दौरान किसी खास Health Connect आईडी को सेव करना पड़ सकता है. उदाहरण के लिए, उपयोगकर्ता ने जो डेटा एंट्री अभी-अभी लॉग की है उसे वापस पाने और उसे उपयोगकर्ता को दिखाने के लिए, किसी खास आईडी की ज़रूरत होती है.
Health Connect में समय
Health Connect में जोड़े गए सभी डेटा में ज़ोन ऑफ़सेट की जानकारी होनी चाहिए. ज़ोन ऑफ़सेट की जानकारी देने से, ऐप्लिकेशन को डेटा पढ़ने में मदद मिलती है, ताकि उसे सिविल टाइम में दिखाया जा सके. सिविल टाइम, उपयोगकर्ता के लिए स्थानीय और काम का समय होता है. हालांकि, यह ज़रूरी नहीं है कि यह समय, कोऑर्डिनेटेड यूनिवर्सल टाइम (यूटीसी) में हो.
कुछ मामलों में, ज़ोन ऑफ़सेट उपलब्ध नहीं हो सकता. Android 14 (एपीआई लेवल 34) में ऐसा होने पर, Health Connect डिवाइस के सिस्टम के डिफ़ॉल्ट टाइम ज़ोन के आधार पर ज़ोन ऑफ़सेट सेट करता है. Android 13 और उससे पहले के वर्शन (एपीआई लेवल 33 और उससे पहले के वर्शन) में, ज़ोन ऑफ़सेट की जानकारी दिए बिना भी Health Connect में डेटा सेव किया जा सकता है. हालांकि, ऐसा करने से बचना चाहिए.
समय और टाइम ज़ोन की सेटिंग
डेटा लिखते समय ज़ोन ऑफ़सेट की जानकारी देने पर, Health Connect में डेटा पढ़ते समय टाइम ज़ोन की जानकारी मिलती है. हालांकि, कुछ मामलों में ऐसा नहीं हो सकता, जैसे कि ज़ोन ऑफ़सेट न दिया गया हो. आपके ऐप्लिकेशन को दोनों तरह के डेटा को इस तरह मैनेज करने के लिए तैयार होना चाहिए कि वह आपकी खास परिस्थितियों के हिसाब से सही हो.
अनुमतियां
किसी भी अनुमति का अनुरोध करने से पहले, आपके ऐप्लिकेशन को मैनिफ़ेस्ट में उन अनुमतियों के बारे में बताना होगा. डेटा टाइप और उनकी अनुमतियों की पूरी मैपिंग के लिए, नीचे दी गई टेबल देखें.
1.0.0-alpha10 और इसके बाद के वर्शन के लिए
अनुमति का रेफ़रंस | अनुमति का एलान पढ़ें |
---|---|
बैकग्राउंड में पढ़ने की सुविधा |
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND
|
इतिहास पढ़ने की सुविधा |
android.permission.health.READ_HEALTH_DATA_HISTORY
|
रिकॉर्ड क्लास का टाइप | अनुमति का एलान पढ़ना और उसमें बदलाव करना |
---|---|
ActiveCaloriesBurned |
android.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
BasalMetabolicRate |
android.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE |
BloodPressure |
android.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE |
CyclingPedalingCadence |
android.permission.health.READ_CYCLING_PEDALING_CADENCE android.permission.health.WRITE_CYCLING_PEDALING_CADENCE |
दूरी |
android.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE |
ElevationGained |
android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED |
ExerciseSession |
android.permission.health.READ_EXERCISE_ROUTE android.permission.health.READ_EXERCISE_SESSION android.permission.health.WRITE_EXERCISE_ROUTE android.permission.health.WRITE_EXERCISE_SESSION |
FloorsClimbed |
android.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED |
HeartRate |
android.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE |
ऊंचाई |
android.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT |
हाइड्रेशन |
android.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION |
MindfulnessSession |
android.permission.health.READ_MINDFULNESS android.permission.health.WRITE_MINDFULNESS |
पोषण |
android.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION |
पावर |
android.permission.health.READ_POWER android.permission.health.WRITE_POWER |
RestingHeartRate |
android.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE |
SkinTemperature |
android.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE |
SleepSession |
android.permission.health.READ_SLEEP_SESSION android.permission.health.WRITE_SLEEP_SESSION |
स्पीड |
android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED |
चरण |
android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS |
StepsCadence |
android.permission.health.READ_STEPS_CADENCE android.permission.health.WRITE_STEPS_CADENCE |
TotalCaloriesBurned |
android.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED |
वज़न |
android.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT |
WheelchairPushes |
android.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES |
1.0.0-alpha09 और इससे पहले के वर्शन के लिए
रिकॉर्ड क्लास का टाइप | अनुमति का एलान पढ़ना और उसमें बदलाव करना |
---|---|
ActiveCaloriesBurned |
androidx.health.permission.ActiveCaloriesBurned.READ androidx.health.permission.ActiveCaloriesBurned.WRITE |
BasalMetabolicRate |
androidx.health.permission.BasalMetabolicRate.READ androidx.health.permission.BasalMetabolicRate.WRITE |
BloodPressure |
androidx.health.permission.BloodPressure.READ androidx.health.permission.BloodPressure.WRITE |
CyclingPedalingCadence |
androidx.health.permission.CyclingPedalingCadence.READ androidx.health.permission.CyclingPedalingCadence.WRITE |
दूरी |
androidx.health.permission.Distance.READ androidx.health.permission.Distance.WRITE |
ElevationGained |
androidx.health.permission.ElevationGained.READ androidx.health.permission.ElevationGained.WRITE |
ExerciseSession |
androidx.health.permission.ExerciseSession.READ androidx.health.permission.ExerciseSession.WRITE |
FloorsClimbed |
androidx.health.permission.FloorsClimbed.READ androidx.health.permission.FloorsClimbed.WRITE |
HeartRate |
androidx.health.permission.HeartRate.READ androidx.health.permission.HeartRate.WRITE |
ऊंचाई |
androidx.health.permission.Height.READ androidx.health.permission.Height.WRITE |
हाइड्रेशन |
androidx.health.permission.Hydration.READ androidx.health.permission.Hydration.WRITE |
पोषण |
androidx.health.permission.Nutrition.READ androidx.health.permission.Nutrition.WRITE |
पावर |
androidx.health.permission.Power.READ androidx.health.permission.Power.WRITE |
RestingHeartRate |
androidx.health.permission.RestingHeartRate.READ androidx.health.permission.RestingHeartRate.WRITE |
SleepSession |
androidx.health.permission.SleepSession.READ androidx.health.permission.SleepSession.WRITE |
स्पीड |
androidx.health.permission.Speed.READ androidx.health.permission.Speed.WRITE |
चरण |
androidx.health.permission.Steps.READ androidx.health.permission.Steps.WRITE |
StepsCadence |
androidx.health.permission.StepsCadence.READ androidx.health.permission.StepsCadence.WRITE |
TotalCaloriesBurned |
androidx.health.permission.TotalCaloriesBurned.READ androidx.health.permission.TotalCaloriesBurned.WRITE |
वज़न |
androidx.health.permission.Weight.READ androidx.health.permission.Weight.WRITE |
WheelchairPushes |
androidx.health.permission.WheelchairPushes.READ androidx.health.permission.WheelchairPushes.WRITE |
डेटा टाइप और अनुमतियों की समीक्षा करना
अब आपके पास डेटा टाइप और अनुमतियों की योजना है. इसलिए, डेवलपमेंट के दौरान उन्हें लागू किया जा सकता है.
Play Store पर अपलोड करने से पहले, अपने ऐप्लिकेशन की समीक्षा करते समय, डेटा टाइप और अनुमतियों की सूची की दोबारा जांच करें. इससे, अपने ऐप्लिकेशन के डेटा के इस्तेमाल के बारे में सटीक जानकारी दी जा सकती है.
अपने ऐप्लिकेशन को Play Store पर पब्लिश करने से पहले, Health Connect के उन डेटा टाइप के ऐक्सेस का एलान करें जिनका इस्तेमाल आपका ऐप्लिकेशन करता है. ऐसा न करने पर, उपयोगकर्ताओं को गड़बड़ी का एक मैसेज दिख सकता है. इसमें बताया जाएगा कि आपका ऐप्लिकेशन, Health Connect के अलग-अलग तरह के डेटा को ऐक्सेस नहीं कर सकता, क्योंकि इसके लिए खास अनुमति की ज़रूरत होती है.