Health Connect का डेटा टाइप प्लान करें और उनकी समीक्षा करें

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