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