इस पेज पर, 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 से अपने क्लाइंट ऐप्लिकेशन में डेटा पढ़ें.
अगर आपको ऐप्लिकेशन को बिना किसी रुकावट के चलाना है, तो ForegroundService का इस्तेमाल करें. जैसे, Health Connect से डेटा पढ़ना, उसे कहीं और लिखना, और अपलोड करना. ऐसा करने के लिए, आसानी से खारिज की जा सकने वाली गतिविधि का इस्तेमाल न करें.
बैकग्राउंड में पढ़ने की सुविधा
आपके पास यह अनुरोध करने का विकल्प है कि आपका ऐप्लिकेशन बैकग्राउंड में चलता रहे और Health Connect से डेटा पढ़ता रहे. अगर आपने बैकग्राउंड में डेटा पढ़ने की अनुमति का अनुरोध किया है, तो आपका उपयोगकर्ता आपके ऐप्लिकेशन को बैकग्राउंड में डेटा पढ़ने का ऐक्सेस दे सकता है.