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 |
| BasalBodyTemperature |
android.permission.health.READ_BASAL_BODY_TEMPERATURE
android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
| BasalMetabolicRate |
android.permission.health.READ_BASAL_METABOLIC_RATE
android.permission.health.WRITE_BASAL_METABOLIC_RATE |
| BloodGlucose |
android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE |
| BloodPressure |
android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE |
| BodyFat |
android.permission.health.READ_BODY_FAT
android.permission.health.WRITE_BODY_FAT |
| BodyTemperature |
android.permission.health.READ_BODY_TEMPERATURE
android.permission.health.WRITE_BODY_TEMPERATURE |
| BodyWaterMass |
android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS |
| BoneMass |
android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS |
| CervicalMucus |
android.permission.health.READ_CERVICAL_MUCUS
android.permission.health.WRITE_CERVICAL_MUCUS |
| CyclingPedalingCadence |
android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE |
| दूरी |
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 android.permission.health.READ_EXERCISE_ROUTE android.permission.health.WRITE_EXERCISE android.permission.health.WRITE_EXERCISE_ROUTE |
| 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 |
| HeartRateVariabilityRmssd |
android.permission.health.READ_HEART_RATE_VARIABILITY
android.permission.health.WRITE_HEART_RATE_VARIABILITY |
| ऊंचाई |
android.permission.health.READ_HEIGHT
android.permission.health.WRITE_HEIGHT |
| हाइड्रेशन |
android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION |
| IntermenstrualBleeding |
android.permission.health.READ_INTERMENSTRUAL_BLEEDING
android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
| LeanBodyMass |
android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS |
| MenstruationFlow |
android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION |
| MenstruationPeriod |
android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION |
| पोषण |
android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION |
| OvulationTest |
android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST |
| OxygenSaturation |
android.permission.health.READ_OXYGEN_SATURATION
android.permission.health.WRITE_OXYGEN_SATURATION |
| PlannedExercise |
android.permission.health.READ_PLANNED_EXERCISE
android.permission.health.WRITE_PLANNED_EXERCISE |
| पावर |
android.permission.health.READ_POWER
android.permission.health.WRITE_POWER |
| RespiratoryRate |
android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE |
| RestingHeartRate |
android.permission.health.READ_RESTING_HEART_RATE
android.permission.health.WRITE_RESTING_HEART_RATE |
| SexualActivity |
android.permission.health.READ_SEXUAL_ACTIVITY
android.permission.health.WRITE_SEXUAL_ACTIVITY |
| SkinTemperature |
android.permission.health.READ_SKIN_TEMPERATURE
android.permission.health.WRITE_SKIN_TEMPERATURE |
| SleepSession |
android.permission.health.READ_SLEEP
android.permission.health.WRITE_SLEEP |
| स्पीड |
android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED |
| StepsCadence |
android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS |
| चरण |
android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS |
| TotalCaloriesBurned |
android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRITE_TOTAL_CALORIES_BURNED |
| Vo2Max |
android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX |
| वज़न |
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 |
| BasalBodyTemperature |
androidx.health.permission.BasalBodyTemperature.READ
androidx.health.permission.BasalBodyTemperature.WRITE |
| BasalMetabolicRate |
androidx.health.permission.BasalMetabolicRate.READ
androidx.health.permission.BasalMetabolicRate.WRITE |
| BloodGlucose |
androidx.health.permission.BloodGlucose.READ
androidx.health.permission.BloodGlucose.WRITE |
| BloodPressure |
androidx.health.permission.BloodPressure.READ
androidx.health.permission.BloodPressure.WRITE |
| BodyFat |
androidx.health.permission.BodyFat.READ
androidx.health.permission.BodyFat.WRITE |
| BodyTemperature |
androidx.health.permission.BodyTemperature.READ
androidx.health.permission.BodyTemperature.WRITE |
| BodyWaterMass |
androidx.health.permission.BodyWaterMass.READ
androidx.health.permission.BodyWaterMass.WRITE |
| BoneMass |
androidx.health.permission.BoneMass.READ
androidx.health.permission.BoneMass.WRITE |
| CervicalMucus |
androidx.health.permission.CervicalMucus.READ
androidx.health.permission.CervicalMucus.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 |
| HeartRateVariabilityRmssd |
androidx.health.permission.HeartRateVariabilityRmssd.READ
androidx.health.permission.HeartRateVariabilityRmssd.WRITE |
| ऊंचाई |
androidx.health.permission.Height.READ
androidx.health.permission.Height.WRITE |
| हाइड्रेशन |
androidx.health.permission.Hydration.READ
androidx.health.permission.Hydration.WRITE |
| IntermenstrualBleeding |
androidx.health.permission.IntermenstrualBleeding.READ
androidx.health.permission.IntermenstrualBleeding.WRITE |
| LeanBodyMass |
androidx.health.permission.LeanBodyMass.READ
androidx.health.permission.LeanBodyMass.WRITE |
| MenstruationFlow |
androidx.health.permission.MenstruationFlow.READ
androidx.health.permission.MenstruationFlow.WRITE |
| पोषण |
androidx.health.permission.Nutrition.READ
androidx.health.permission.Nutrition.WRITE |
| OvulationTest |
androidx.health.permission.OvulationTest.READ
androidx.health.permission.OvulationTest.WRITE |
| OxygenSaturation |
androidx.health.permission.OxygenSaturation.READ
androidx.health.permission.OxygenSaturation.WRITE |
| पावर |
androidx.health.permission.Power.READ
androidx.health.permission.Power.WRITE |
| RespiratoryRate |
androidx.health.permission.RespiratoryRate.READ
androidx.health.permission.RespiratoryRate.WRITE |
| RestingHeartRate |
androidx.health.permission.RestingHeartRate.READ
androidx.health.permission.RestingHeartRate.WRITE |
| SexualActivity |
androidx.health.permission.SexualActivity.READ
androidx.health.permission.SexualActivity.WRITE |
| SleepSession |
androidx.health.permission.SleepSession.READ
androidx.health.permission.SleepSession.WRITE |
| स्पीड |
androidx.health.permission.Speed.READ
androidx.health.permission.Speed.WRITE |
| StepsCadence |
androidx.health.permission.StepsCadence.READ
androidx.health.permission.StepsCadence.WRITE |
| चरण |
androidx.health.permission.Steps.READ
androidx.health.permission.Steps.WRITE |
| TotalCaloriesBurned |
androidx.health.permission.TotalCaloriesBurned.READ
androidx.health.permission.TotalCaloriesBurned.WRITE |
| Vo2Max |
androidx.health.permission.Vo2Max.READ
androidx.health.permission.Vo2Max.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 के अलग-अलग तरह के डेटा को ऐक्सेस नहीं कर सकता, क्योंकि इसके लिए खास अनुमति की ज़रूरत होती है.