Health Connect के फ़ंक्शन की समीक्षा करें

इस पेज पर, Health Connect API के मुख्य फ़ंक्शन के बारे में बताया गया है.

रिकॉर्ड पर CRUD ऑपरेशन और डेटा सिंक करने की सुविधा

यह प्लैटफ़ॉर्म, रिकॉर्ड किए गए डेटा के लिए स्टैंडर्ड इंसर्ट, अपडेट, और मिटाने के फ़ंक्शन उपलब्ध कराता है. Health Connect में एक ऐसी सुविधा भी शामिल है जिसकी मदद से क्लाइंट ऐप्लिकेशन, Health Connect से डेटा सिंक कर सकते हैं. इससे डेटा में हुए बदलावों का लॉग जनरेट होता है. इससे डेवलपर और उपयोगकर्ता को पता चलता है कि अन्य ऐप्लिकेशन ने कुछ डेटा टाइप डाले हैं या मिटाए हैं.

बुनियादी एग्रीगेशन फ़ंक्शन

क्लाइंट, इस्तेमाल किए जा रहे डेटा पर एग्रीगेशन फ़ंक्शन लागू कर सकते हैं. इससे उन्हें ये फ़ायदे मिलते हैं:

• औसत, कम से कम या ज़्यादा से ज़्यादा वैल्यू (उदाहरण के लिए, किसी गतिविधि के दौरान दिल की धड़कन की कम से कम और ज़्यादा से ज़्यादा दर).
• कुल योग (उदाहरण के लिए, हर दिन के अंतराल में कदमों की कुल संख्या).
• यह सामान्य गिनती होती है. इसमें, मेज़रमेंट की कुल संख्या शामिल होती है. उदाहरण के लिए, किसी हफ़्ते में गतिविधि वाले सेशन की संख्या.
• सपोर्ट किए गए डेटा टाइप के लिए कुल अवधि. उदाहरण के लिए, इस हफ़्ते गहरी नींद में बिताया गया समय या आज गतिविधि वाले सेशन की कुल अवधि.

उपलब्धता की जांच करना

Health Connect, Android SDK के 28 (Pie) और इसके बाद के वर्शन के साथ काम करता है. SDK की मदद से, क्लाइंट ऐप्लिकेशन यह पता लगा सकते हैं कि उपयोगकर्ता के Android डिवाइस पर Health Connect API चालू है या नहीं. अगर ऐसा नहीं है, तो Health Connect यह देखने के लिए कि उपयोगकर्ता का डिवाइस इस सुविधा के साथ काम करता है या नहीं, उपलब्धता की जांच शुरू करता है.

अनुमति की जांच

Health Connect के लिए, आपको उपयोगकर्ता से हर ऐप्लिकेशन के हिसाब से, सेहत और फ़िटनेस से जुड़े डेटा को ऐक्सेस और सेव करने की अनुमति लेनी होगी. इससे यह भी देखा जा सकता है कि उपयोगकर्ता ने कौनसी अनुमतियां पहले ही दी हैं या अस्वीकार की हैं.

Health Connect की मदद से डेटा ऐक्सेस करना

फ़ोरग्राउंड में पढ़ने की सुविधा

जब आपका ऐप्लिकेशन फ़ोरग्राउंड में होता है, तब Health Connect से डेटा पढ़ा जा सकता है. ऐसे मामलों में, इस ऑपरेशन को चलाने के लिए फ़ोरग्राउंड सेवा का इस्तेमाल किया जा सकता है. ऐसा तब करें, जब उपयोगकर्ता या सिस्टम, पढ़ने की कार्रवाई के दौरान आपके ऐप्लिकेशन को बैकग्राउंड में रख दे.

ऐसी स्थितियों में जहां आपके ऐप्लिकेशन को रुकावट की उम्मीद हो सकती है, जैसे कि आपके ऐप्लिकेशन में कोई रीडिंग दिखाना, Health Connect से सीधे अपने क्लाइंट ऐप्लिकेशन में डेटा पढ़ें.

अगर आपको ऐसी स्थितियां चाहिए जिनमें आपका ऐप्लिकेशन बिना किसी रुकावट के काम करे, तो फ़ोरग्राउंड सेवा का इस्तेमाल करें:

• FOREGROUND_SERVICE_TYPE_HEALTH: इससे ऐप्लिकेशन को फ़ोरग्राउंड में रहने की अनुमति मिलती है, ताकि वह सेंसर डेटा इकट्ठा कर सके. जैसे, कसरत करने से जुड़ा कोई ऐप्लिकेशन, जो उपयोगकर्ता के ऐप्लिकेशन को बैकग्राउंड में रखने पर भी डेटा इकट्ठा करता रहता है.

• FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: यह एक सामान्य सेवा है. इससे ऐप्लिकेशन को तीन मिनट से कम समय में पूरे होने वाले टास्क के लिए ज़रूरी डेटा इकट्ठा करने की अनुमति मिलती है. भले ही, उपयोगकर्ता ऐप्लिकेशन को पूरा होने से पहले बैकग्राउंड में रख दे.

बैकग्राउंड में पढ़ने की सुविधा

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