यदि आप अपने एंड्रॉइड फोन पर कई व्यायाम, नींद, पोषण या स्वास्थ्य संबंधी ऐप्स का उपयोग करते हैं, तो बहुत संभावना है कि आपके पास अपना खुद का ऐप होगा। डेटा हर जगह बिखरा हुआ है और फिर उन्हें मैनेज करना झंझट भरा हो जाता है। हेल्थ कनेक्ट इसी समस्या के लिए है: व्यवस्था बनाए रखने, जानकारी को केंद्रीकृत करने और आपको स्पष्ट गोपनीयता नियंत्रण प्रदान करने के लिए, ताकि आपको एक ऐप से दूसरे ऐप पर जाने की परेशानी न हो।
इसके अलावा, डेवलपर्स और स्वास्थ्य सेवा कंपनियों के लिए, हेल्थ कनेक्ट एक महत्वपूर्ण भूमिका निभा रहा है। स्वास्थ्य डेटा के एकीकरण का एकल बिंदु जो सिंक्रोनाइज़ेशन को सरल बनाता है, अंतरसंचालनीयता में सुधार करता है और बेहतर उपयोगकर्ता अनुभवों के द्वार खोलता है, जबकि नियंत्रण और सुरक्षा को मूल में रखता है।
हेल्थ कनेक्ट क्या है और यह किस समस्या का समाधान करता है?
हेल्थ कनेक्ट बाय एंड्रॉइड एक ऐसा सिस्टम है जो एक स्वास्थ्य और शारीरिक गतिविधि संबंधी आंकड़ों के लिए केंद्रीय केंद्रप्रत्येक ऐप द्वारा अपनी जानकारी को अलग-थलग रूप से संग्रहीत और प्रबंधित करने के बजाय, हेल्थ कनेक्ट डिवाइस पर एक सामान्य स्टोरेज के रूप में कार्य करता है, जिसमें विभिन्न ऐप आपकी अनुमति से डेटा पढ़ और लिख सकते हैं।
इसका उद्देश्य उस पारंपरिक स्थिति को समाप्त करना है जिसमें कदमों की संख्या, हृदय गति, नींद, पोषण या मासिक धर्म चक्र का रिकॉर्ड ये जानकारी ऐप्स, डिवाइसों और सेवाओं में बिखरी हुई है। हेल्थ कनेक्ट के साथ, यह सारी जानकारी आपके फ़ोन में स्थानीय रूप से संग्रहीत होती है, और आप तय करते हैं कि क्या, किसके साथ और किस उद्देश्य से साझा किया जाएगा।
गूगल के दृष्टिकोण से, यह प्रणाली अनुमति देती है गोपनीयता का उल्लंघन किए बिना ऐप्स के बीच डेटा साझा करेंउपयोगकर्ता के लिए, इसका अर्थ है अधिक सुविधा और अपने स्वास्थ्य का बेहतर समग्र अवलोकन; डेवलपर्स के लिए, इसका अर्थ है स्वास्थ्य डेटा के साथ काम करने के लिए एक एकीकृत एपीआई, जिससे प्रत्येक एकीकरण के साथ नए सिरे से काम करने की आवश्यकता नहीं होगी।
हेल्थ कनेक्ट तक पहुंच एंड्रॉइड संस्करण पर निर्भर करती है।
हेल्थ कनेक्ट तक पहुंचने का तरीका इस पर निर्भर करता है कि... डिवाइस में मौजूद एंड्रॉइड संस्करणक्योंकि एंड्रॉइड 14 के बाद से यह सिस्टम का ही हिस्सा बन जाता है।
हेल्थ कनेक्ट एंड्रॉइड 14 और उसके बाद के संस्करणों पर उपलब्ध है।
एंड्रॉइड 14 (एपीआई स्तर 34) के बाद से, हेल्थ कनेक्ट एक एंड्रॉइड फ्रेमवर्क में एकीकृत मॉड्यूलयह अब सिर्फ एक स्टैंडअलोन ऐप नहीं है। इसका मतलब है कि इसे चलाने के लिए आपको Google Play से कुछ भी डाउनलोड करने की आवश्यकता नहीं है, और इसे सीधे सिस्टम सेटिंग्स से प्रबंधित किया जा सकता है।
इसे Android 14 या उससे ऊपर के संस्करण पर खोलने के लिए, ऐप पर जाएं। उपकरण सेटिंग्स और सुरक्षा और गोपनीयता सेटिंग्स पर जाएं। सामान्य तरीका है: सेटिंग्स > सुरक्षा और गोपनीयता > गोपनीयता नियंत्रण > हेल्थ कनेक्ट (या हेल्थ कनेक्टेड, अनुवाद और निर्माता के आधार पर)। आप यह भी कर सकते हैं सेटिंग्स सर्च बार में “हेल्थ कनेक्ट” खोजें वहां जल्दी पहुंचने के लिए।
इस संस्करण में, जब आप अपने फ़ोन को अपडेट करते हैं, तो सिस्टम यह ऐप के पिछले संस्करण में मौजूद आपके डेटा को स्वचालित रूप से स्थानांतरित कर देता है। हेल्थ कनेक्ट (यदि आपने पहले इसका उपयोग किया है) से लेकर एकीकृत सिस्टम मॉड्यूल तक, जिसमें पहले से दी गई सभी अनुमतियाँ शामिल हैं। इस तरह आप सेवा बाधित हुए बिना पुराने ऐप को अनइंस्टॉल भी कर सकते हैं।
एंड्रॉइड 13 और उससे पहले के संस्करणों पर हेल्थ कनेक्ट
एंड्रॉइड 13 (एपीआई 33) और उससे पहले के संस्करणों में, हेल्थ कनेक्ट सिस्टम में शामिल नहीं है, इसलिए इसे अलग से इंस्टॉल करना आवश्यक है। ऐप को गूगल प्ले स्टोर से इंस्टॉल करें। इसका उपयोग करने में सक्षम होने के लिए।
ऐप इंस्टॉल हो जाने के बाद, आप इसे सेटिंग्स > ऐप्स > हेल्थ कनेक्ट से खोल सकते हैं, या इसे मेनू में जोड़कर भी खोल सकते हैं। त्वरित सेटिंग अधिक सीधे एक्सेस के लिए। इन डिवाइसों पर, वे डेवलपर जिन्होंने पहले ही अपने ऐप को हेल्थ कनेक्ट के साथ एकीकृत कर लिया है, वे ऐसा कर सकते हैं। अनुभव को बाधित किए बिना माइग्रेट करें जब उपयोगकर्ता विशिष्ट माइग्रेशन गाइड की मदद से एंड्रॉइड 14 और उससे ऊपर के संस्करण में अपग्रेड करता है।
इस पर ध्यान देना जरूरी है हेल्थ कनेक्ट मल्टी-यूज़र प्रोफाइल को सपोर्ट नहीं करता है। यह एंड्रॉइड वर्क प्रोफाइल के साथ भी काम नहीं करता है। यह केवल उपयोगकर्ता के मुख्य प्रोफाइल पर ही काम करता है, ताकि डेटा के मालिक पर स्पष्ट नियंत्रण बना रहे।
अपने स्वास्थ्य और फिटनेस ऐप्स को एक जगह इकट्ठा करें और आपस में जोड़ें
औसत उपयोगकर्ता के लिए हेल्थ कनेक्ट की मुख्य विशेषता यह है कि यह अनुमति देता है विभिन्न स्वास्थ्य और कल्याण ऐप्स को आपस में जोड़ें ताकि वे एक-दूसरे के साथ डेटा साझा कर सकें। इस तरह, एक फिटनेस ऐप दूसरे द्वारा रिकॉर्ड किए गए नींद के डेटा का उपयोग कर सकता है, या एक पोषण ऐप आपके कदमों और खर्च की गई कैलोरी को ट्रैक कर सकता है।
सामान्य प्रक्रिया में आपके डिवाइस पर हेल्थ कनेक्ट खोलना, प्रारंभिक प्रवाह पर टैप करना आदि शामिल है। “प्रारंभ करें” या सेटिंग्स और, अनुमतियाँ और डेटा अनुभाग के भीतर, एप्लिकेशन अनुमतियों तक पहुँचें। वहाँ से आप उन ऐप्स को सक्षम कर सकते हैं जिन्हें आप एकीकृत करना चाहते हैं और, सबसे महत्वपूर्ण बात, यह चुनें कि प्रत्येक व्यक्ति डेटा की किन श्रेणियों को पढ़ या लिख सकता है। (उदाहरण के लिए, कदमों की संख्या हाँ लेकिन वजन नहीं, या हृदय गति हाँ लेकिन मासिक धर्म चक्र नहीं)।
हेल्थ कनेक्ट जानकारी को समूहों में बांटता है। विषयगत श्रेणियाँशारीरिक गतिविधि, शरीर के माप, मासिक धर्म चक्र, नींद, पोषण, महत्वपूर्ण संकेत, चिकित्सा रिकॉर्ड आदि। इससे यह देखना आसान हो जाता है कि क्या साझा किया जा रहा है, किन ऐप्स के साथ और किन उद्देश्यों के लिए। आप यह भी देख सकते हैं कि किन ऐप्स ने हाल ही में आपके डेटा तक पहुंच बनाई है।
यह ध्यान देने योग्य है कि कुछ ऐप्स में, सिंक्रोनाइज़ेशन शुरू होने से पहले आपको इसे सक्षम करना होगा। संबंधित एप्लिकेशन के भीतर ही हेल्थ कनेक्ट के अलावा। अगर कुछ सिंक नहीं हो रहा है, तो हेल्थ कनेक्ट के विकल्पों और संबंधित प्रत्येक ऐप की आंतरिक सेटिंग्स की जांच करना उचित होगा।
कौन सा डेटा साझा किया जाता है और इसे कैसे प्रबंधित किया जाता है?
जब कोई ऐप हेल्थ कनेक्ट से जुड़ता है और आप उसे एक्सेस देते हैं, तो वह ऐप एक्सेस प्राप्त कर लेता है। कुछ प्रकार के डेटा को पढ़ने और लिखने की अनुमति केंद्रीय गोदाम में, हमेशा उन श्रेणियों के भीतर जिन्हें आपने अनुमोदित किया है।
एक बार एक्सेस मिल जाने के बाद, ऐप एक्सेस कर सकता है पिछले 30 दिनों का डेटा और उस बिंदु से आगे उत्पन्न होने वाली कोई भी नई जानकारी। इस मामले में मेडिकल रिकॉर्ड (चिकित्सा इतिहास, रिपोर्ट आदि) के मामले में, यह 30-दिन की सीमा लागू नहीं होती: आपकी स्पष्ट स्वीकृति से, आवेदनों को आगे भेजा जा सकता है। अपना पूरा उपलब्ध चिकित्सा इतिहास देखें हेल्थ कनेक्ट में।
तकनीकी स्तर पर, डेटा को इसमें संग्रहीत किया जाता है। एंड्रॉइड डिवाइस पर ही स्थानीय रूप सेआप यह नियंत्रित कर सकते हैं कि कौन से ऐप्स कौन सी जानकारी देख सकते हैं, और आप किसी भी समय अनुमतियाँ रद्द कर सकते हैं या कुछ प्रकार के डेटा को साझा करना बंद कर सकते हैं। हालाँकि, कनेक्टेड ऐप्स की सेवाएँ अभी भी जानकारी बनाए रख सकती हैं... पहले से सिंक्रनाइज़ किए गए डेटा की प्रतियां आपके द्वारा अनुमति रद्द करने से पहले वे अपने स्वयं के सर्वरों का उपयोग कर रहे थे।
यह मॉडल एंड्रॉइड इकोसिस्टम के भीतर सूचना के अलगाव की समस्या को कम करने में मदद करता है: चरणों को एक जगह, भार को दूसरी जगह और स्लीप को तीसरी जगह रखने के बजाय, ये सभी भाग एक ही प्रक्रिया से गुजरते हैं। सामान्य भंडारण और ऑर्केस्ट्रेशन बिंदुइससे उपयोगकर्ता अनुभव और बाद के विश्लेषणों की गुणवत्ता दोनों में सुधार होता है।
स्वास्थ्य अंतरसंचालनीयता परिप्रेक्ष्य: मोबाइल से परे
डेटा का विखंडन केवल फिटनेस ऐप्स के लिए ही समस्या नहीं है: यह सामान्य रूप से स्वास्थ्य सेवा क्षेत्र में भी मौजूद है। अंतरसंचालनीयता का ऐतिहासिक अभावचिकित्सा संबंधी डेटा को अक्सर क्षेत्र, अस्पताल, बीमाकर्ता, प्रयोगशाला या यहां तक कि विशिष्ट अनुसंधान परियोजनाओं के आधार पर अलग-अलग वर्गों में विभाजित किया जाता है, जिससे सूचना के वास्तविक भंडार बन जाते हैं।
इस विखंडन की भारी कीमत चुकानी पड़ती है। कई विश्लेषणों का अनुमान है कि अंतरसंचालनीयता की कमी से निम्न परिणाम हो सकते हैं। किसी देश के वार्षिक स्वास्थ्य व्यय का लगभग 4,7% हिस्साइसका परिणाम यह होता है कि दोहराव, अक्षमता, बार-बार परीक्षण और पेशेवरों के बीच खराब समन्वय के कारण अरबों यूरो का नुकसान होता है।
स्वास्थ्य संबंधी आंकड़ों को केंद्रीकृत करना और सही ढंग से सूचीबद्ध करना संभव बनाता है। निदान और उपचार में सुधार करेंइससे देरी कम होती है, अनावश्यक दोहराव वाले परीक्षणों से बचा जा सकता है, और पेशेवरों को किसी मरीज के प्रासंगिक चिकित्सा इतिहास तक पहुंच आसान हो जाती है, भले ही वह किसी अन्य क्षेत्र या प्रणाली से आया हो। इसके अलावा, यह सुव्यवस्थित डेटा निम्नलिखित के लिए अमूल्य है। जैवचिकित्सा अनुसंधान और नई दवाओं का विकास.
इस व्यापक संदर्भ में कनेक्ट हेल्थ और इसके यूनिवर्सल हेल्थ चेन (यूएचसी) प्लेटफॉर्म जैसी परियोजनाओं का दर्शन उभरता है, जिसका उद्देश्य है... विभिन्न प्रकार के नैदानिक डेटा को एकीकृत, केंद्रीकृत और आपस में जोड़ना अंतर्राष्ट्रीय मानकों (HL7 FHIR, IPS, USCDI, SNOMED, LOINC), ब्लॉकचेन, कृत्रिम बुद्धिमत्ता और IoT का उपयोग करके बड़े पैमाने पर काम करना। हालांकि वे अलग-अलग क्षेत्रों में काम करते हैं (मैक्रो-हेल्थकेयर सिस्टम बनाम एंड्रॉइड का स्थानीय डेटा स्टोर), लेकिन उनका मूल विचार एक ही है: डेटा साइलो को खत्म करना और उपयोगकर्ता को उनकी चिकित्सा संबंधी जानकारी पर अधिक नियंत्रण प्रदान करने के लिए.
डेवलपर्स के लिए हेल्थ कनेक्ट: ऐप तैयार करना
तकनीकी दृष्टिकोण से, हेल्थ कनेक्ट निम्नलिखित सुविधाएँ प्रदान करता है: जेटपैक में एसडीके (androidx.health.connect) इससे एप्लिकेशन हेल्थ कनेक्ट डेटा स्टोर के साथ एकीकृत हो सकते हैं, जिससे वे रिकॉर्ड पढ़ और लिख सकते हैं। इस एकीकरण के लिए कुछ कॉन्फ़िगरेशन चरणों और सर्वोत्तम प्रक्रियाओं का पालन करना आवश्यक है।
हेल्थ कनेक्ट ऐप और इसकी उपलब्धता
हेल्थ कनेक्ट ऐप या मॉड्यूल इसके लिए ज़िम्मेदार है आपके ऐप द्वारा SDK के माध्यम से भेजे गए सभी अनुरोधों को संसाधित करेंइसमें डेटा स्टोरेज, अनुमति नियंत्रण और पढ़ने और लिखने की पहुंच शामिल है।
इसका उपयोग उपयोगकर्ता के डिवाइस पर मौजूद एंड्रॉइड संस्करण पर निर्भर करता है: एंड्रॉइड 14 और उसके बाद के संस्करणों में, मॉड्यूल डिफ़ॉल्ट रूप से शामिल होता है; एंड्रॉइड 13 और उससे पहले के संस्करणों में, यह आवश्यक है। Google Play से Health Connect ऐप इंस्टॉल करेंSDK एंड्रॉइड 8 (API 26) और उसके बाद के संस्करणों को सपोर्ट करता है, लेकिन हेल्थ कनेक्ट ऐप केवल एंड्रॉइड 9 (API 28) और उसके बाद के संस्करणों पर ही काम करता है। इसका मतलब है कि आप इंटीग्रेशन तैयार करके एंड्रॉइड 8 के उपयोगकर्ताओं को सपोर्ट कर सकते हैं, लेकिन हेल्थ कनेक्ट का उपयोग वास्तव में केवल एंड्रॉइड 9 या उससे ऊपर के संस्करण वाले उपयोगकर्ता ही कर पाएंगे।
यह जानने के लिए कि हेल्थ कनेक्ट उपलब्ध है या नहीं और उसकी क्या स्थिति है, ग्राहक कॉल कर सकते हैं। HealthConnectClient.getSdkStatus और तदनुसार कार्रवाई करें: यदि उपलब्ध हो तो जारी रखें, या यदि आवश्यक हो तो उपयोगकर्ता को प्रदाता को स्थापित या अपडेट करने के लिए Google Play पर पुनर्निर्देशित करें।
हेल्थ कनेक्ट एसडीके जोड़ें
API का उपयोग करने के लिए, आपको संबंधित निर्भरता को जोड़ना होगा। मॉड्यूल build.gradleआमतौर पर, इसमें पुस्तकालय जैसी कोई सुविधा शामिल होती है। androidx.health.connect:connect-client निर्भरता अनुभाग में। आदर्श रूप से, परामर्श लें। नवीनतम संस्करण के उपयोग के लिए आधिकारिक दस्तावेज़जैसे-जैसे SDK में नई सुविधाएं, अनुमति में बदलाव और स्थिरता में सुधार होते रहते हैं।
फ़ीचर उपलब्धता API का उपयोग करना
चूंकि उपयोगकर्ता हमेशा अपने हेल्थ कनेक्ट संस्करण को अपडेट नहीं करते हैं, इसलिए एसडीके एक एपीआई प्रदान करता है। जांचें कि कुछ सुविधाएं उपलब्ध हैं या नहीं। डिवाइस पर, उपयोग करके healthConnectClient.features.getFeatureStatus()यह कॉल FEATURE_STATUS_AVAILABLE या FEATURE_STATUS_UNAVAILABLE जैसे स्थिरांक लौटाता है।
यदि कोई सुविधा अनुपलब्ध है, तो इसकी अनुशंसा की जाती है उपयोगकर्ता को हेल्थ कनेक्ट अपडेट करने के लिए आमंत्रित करेंकृपया ध्यान दें कि सिस्टम मॉड्यूल से जुड़ी कुछ क्षमताएं एंड्रॉइड 13 और उससे पहले के संस्करणों में मौजूद नहीं होंगी, भले ही उपयोगकर्ता हेल्थ कनेक्ट एपीके इंस्टॉल कर ले, क्योंकि वे स्वयं फ्रेमवर्क पर निर्भर करती हैं।
हेल्थ कनेक्ट में अनुमतियाँ और गोपनीयता
स्वास्थ्य और शारीरिक गतिविधि संबंधी डेटा तक पहुंच अत्यंत संवेदनशील है, इसलिए हेल्थ कनेक्ट इसमें अतिरिक्त सुविधाएँ जोड़ता है। रीड और राइट ऑपरेशन्स पर सुरक्षा की एक अतिरिक्त परतइससे डेवलपर्स को अपनी आवश्यकताओं के बारे में पारदर्शी, स्पष्ट और बहुत सटीक होने के लिए मजबूर होना पड़ता है।
घोषणापत्र में अनुमतियों की घोषणा
फ़ाइल में AndroidManifest.xmlऐप को स्पष्ट रूप से घोषित करना होगा अनुमतियाँ पढ़ें और लिखें मानक लेबलों का उपयोग करके, जिनकी आपको आवश्यकता है। <uses-permission> अंदर <manifest>इन अनुमतियों को डेटा प्रकार के आधार पर समूहीकृत किया गया है, उदाहरण के लिए:
<uses-permission android:name="android.permission.health.READ_HEART_RATE"/>
<uses-permission android:name="android.permission.health.WRITE_HEART_RATE"/>
<uses-permission android:name="android.permission.health.READ_STEPS"/>
<uses-permission android:name="android.permission.health.WRITE_STEPS"/>
इसके अलावा, इन परमिटों को अवश्य ही Google Play Console में आपके द्वारा घोषित जानकारी के साथ संरेखित करें हेल्थ कनेक्ट ऐप द्वारा पढ़े या लिखे जाने वाले डेटा के प्रकारों के संबंध में, पारदर्शिता महत्वपूर्ण है: यदि भविष्य में आपको अधिक श्रेणियों के डेटा की आवश्यकता होने के कारण नई अनुमतियों का अनुरोध करना पड़े, तो आपको... नए और पहले से इस्तेमाल किए गए दोनों को शामिल करें।केवल उन्हीं चीजों को छोड़कर जिनकी अब आपको आवश्यकता नहीं है।
विशिष्ट गोपनीयता नीति संवाद
घोषणापत्र में एक ऐसी गतिविधि का भी उल्लेख होना चाहिए जो इसे प्रदर्शित करने में सक्षम हो। गोपनीयता नीति और अनुमतियों का औचित्य हेल्थ कनेक्ट से, जब उपयोगकर्ता हेल्थ कनेक्ट अनुमतियों स्क्रीन पर संबंधित लिंक पर क्लिक करता है।
एंड्रॉइड 13 तक के संस्करणों के लिए, एक एक्टिविटी परिभाषित की जाती है जो इंटेंट प्राप्त करती है। ACTION_SHOW_PERMISSIONS_RATIONALEऔर एंड्रॉइड 14 से शुरू होकर, एक गतिविधि-उपनाम जो प्रतिक्रिया देता है android.intent.action.VIEW_PERMISSION_USAGE उपयुक्त श्रेणी के साथ, हेल्थ कनेक्ट उपयोगकर्ता को यह दिखा सकता है कि आपके ऐप को उस डेटा की आवश्यकता क्यों है, आप इसका उपयोग कैसे करते हैं और वे इसे कैसे नियंत्रित कर सकते हैं।
परमिटों के लिए गतिशील अनुरोध और प्रबंधन
एक बार आपके पास HealthConnectClientआपके ऐप को अवश्य रनटाइम अनुमतियों का अनुरोध करेंआवश्यक सुविधाओं को एक समूह में रखना (उदाहरण के लिए, कदमों की संख्या और हृदय गति को पढ़ना और लिखना)। कुछ भी अनुरोध करने से पहले, बेहतर होगा कि आप किसी विशेषज्ञ से सलाह लें। getGrantedPermissions() यदि उन्हें पहले ही मंजूरी मिल चुकी हो।
इन्हें अनुरोध करने के लिए, SDK एक परिणाम अनुबंध प्रदान करता है। PermissionController.createRequestPermissionResultContract()यह उपयोगकर्ता को दिखाता है हेल्थ कनेक्ट मानक प्रदर्शन जहां आप प्रत्येक अनुमति को स्वीकार या अस्वीकार कर सकते हैं। आपके ऐप को दोनों स्थितियों के लिए तैयार रहना चाहिए: यदि महत्वपूर्ण अनुमतियां अस्वीकार कर दी जाती हैं, तो कार्यक्षमता के प्रवाह को समायोजित या सीमित करना होगा।
चूंकि उपयोगकर्ता कर सकता है किसी भी समय अनुमतियाँ रद्द करें हेल्थ कनेक्ट के अनुसार, समय-समय पर यह सत्यापित करना अच्छा अभ्यास है कि कौन सी अनुमतियाँ अभी भी सक्रिय हैं, विशेष रूप से उन पर निर्भर पढ़ने या लिखने के कार्यों को करने से पहले।
हेल्थ कनेक्ट से ऑनबोर्डिंग और शुरुआत
कई ऐप्स में एक ऑनबोर्डिंग प्रक्रिया शामिल होती है, जिसमें वे सुविधाओं की व्याख्या करते हैं, सहमति मांगते हैं और प्रारंभिक प्राथमिकताएं कॉन्फ़िगर करते हैं। हेल्थ कनेक्ट इस प्रक्रिया को सरल बनाने की सुविधा देता है... इसे सीधे इसके अपने इंटरफ़ेस से लॉन्च करेंताकि उपयोगकर्ता आपके ऐप को केवल ऐप से ही नहीं, बल्कि हेल्थ कनेक्ट से भी कनेक्ट कर सके।
ऐसा करने के लिए, विशिष्ट इरादों के साथ एक ऑनबोर्डिंग गतिविधि घोषित की जाती है (androidx.health.ACTION_SHOW_ONBOARDING APK और वाले संस्करणों के लिए android.health.connect.action.SHOW_ONBOARDING (एंड्रॉइड 14 और उसके बाद के संस्करणों के लिए), उचित अनुमतियों द्वारा सुरक्षित। कृपया ध्यान दें कि इस गतिविधि को कई बार शुरू किया जा सकता है।उदाहरण के लिए, यदि उपयोगकर्ता ऐप को डिस्कनेक्ट कर देता है और बाद में इसे फिर से कनेक्ट करने का निर्णय लेता है।
बुनियादी कार्य: हेल्थ कनेक्ट में डेटा पढ़ना और लिखना
एक बार एकीकरण स्थापित हो जाने के बाद, आपका ऐप नए रिकॉर्ड डालें हेल्थ कनेक्ट में जाकर या मौजूदा डेटा को व्यक्तिगत रूप से और सामूहिक रूप से पढ़ें।
डेटा लेखन: रिकॉर्ड और मेटाडेटा
डेटा को ऑब्जेक्ट के रूप में दर्शाया जाता है। Record प्रत्येक प्रकार (कदम, हृदय गति, वजन, आदि) के लिए विशिष्ट। उदाहरण के लिए, कदमों की गिनती करने के लिए, एक व्यक्ति निम्नलिखित का उपयोग करता है: StepsRecordजिसमें चरणों की संख्या, प्रारंभ और समाप्ति समय, समय क्षेत्र और मेटाडेटा जैसे फ़ील्ड शामिल हैं।
आपका ऐप उपयुक्त मानों के साथ एक रिकॉर्ड बनाता है और उसे सम्मिलित करता है। insertRecords()रिकॉर्ड में ऑब्जेक्ट जोड़ना आम बात है। Metadata यह निर्दिष्ट करें कि क्या यह डेटा है किसी उपकरण द्वारा स्वतः पंजीकृत (उदाहरण के लिए, एक घड़ी) या मैन्युअल रूप से दर्ज की गई जानकारी, जिसमें डिवाइस की जानकारी (प्रकार, उत्पत्ति आदि) शामिल है।
जब डेटा स्रोत आपका अपना डेटा वेयरहाउस (उदाहरण के लिए, एक बैकएंड या स्थानीय डेटाबेस) होता है, तो आप इसका लाभ उठा सकते हैं। clientRecordId y clientRecordVersion नियंत्रण करने के लिए आइडम्पोटेंट इंसर्शन और अपडेटयदि आप मौजूदा ग्राहक आईडी और उच्चतर संस्करण के साथ कोई रिकॉर्ड सबमिट करते हैं, तो हेल्थ कनेक्ट पिछले डेटा को बदल देता है; अन्यथा, एक नया रिकॉर्ड बनाया जाता है।
सम्मिलन के बाद, प्रतिक्रिया insertRecords() इसमें हेल्थ कनेक्ट द्वारा जनरेट की गई आईडी की सूची शामिल है। यह अत्यंत आवश्यक है। इन आंतरिक आईडी को स्टोर करें यदि आप डेटा को पढ़ने और सिंक्रनाइज़ करने जा रहे हैं, तो इसे अपने सिस्टम पर ही करें, क्योंकि विलोपन और परिवर्तनों को संसाधित करने के लिए यह आवश्यक होगा।
व्यक्तिगत और एकत्रित डेटा को पढ़ना
विशिष्ट डेटा को पढ़ने के लिए, व्यक्ति निम्नलिखित का उपयोग करता है: readRecords() इस प्रकार के अनुरोध के साथ ReadRecordsRequestजहां रिकॉर्ड का प्रकार और समय सीमा के अनुसार फ़िल्टर दर्शाया गया है (TimeRangeFilterयह एक लौटाता है विस्तृत अभिलेखों की सूची जिसे आपका ऐप एक-एक करके प्रोसेस कर सके।
हालाँकि, चरणों जैसे संचयी प्रकारों के लिए, इसका उपयोग करने की अनुशंसा की जाती है। aggregate() के बजाय readRecords()एकत्रीकरण से निम्नलिखित समस्याओं से बचा जा सकता है: एकाधिक स्रोतों के मामले में दोहरी गणना (उदाहरण के लिए, मोबाइल और घड़ी एक ही समय में) और यह अधिक विश्वसनीय मेट्रिक्स प्रदान करता है, जैसे कि एक निश्चित अवधि में कुल कदमों की संख्या।
यह ध्यान रखना महत्वपूर्ण है कि हेल्थ कनेक्ट डेटा पढ़ सकता है। परमिट जारी होने की तारीख से 30 दिन पहले तकयदि आपके आवेदन को पुराने इतिहासों से परामर्श करने की आवश्यकता है, तो उसे विशेष अनुमति का अनुरोध करना होगा, जैसे कि PERMISSION_READ_HEALTH_DATA_HISTORYजानकारी की संवेदनशीलता को देखते हुए, इसके लिए सख्त औचित्य और समीक्षा की आवश्यकता होगी।
आपके ऐप और हेल्थ कनेक्ट के बीच उन्नत सिंक्रोनाइज़ेशन
कई हेल्थ ऐप्स के अपने-अपने फीचर्स होते हैं। आंतरिक डेटा गोदाम (स्थानीय या क्लाउड में) जो प्राथमिक स्रोत के रूप में कार्य करता है। हेल्थ कनेक्ट का उद्देश्य उस स्रोत को प्रतिस्थापित करना नहीं है, बल्कि उसके साथ तालमेल बिठाना है, ताकि दोनों पक्ष एकरूपता बनाए रखें।
एक पूर्ण सिंक्रोनाइज़ेशन प्रक्रिया में आमतौर पर तीन ऑपरेशन शामिल होते हैं: हेल्थ कनेक्ट में अपना ऐप डेटा डालें या अपडेट करेंहेल्थ कनेक्ट से अपने डेटा वेयरहाउस में बदलावों को एक्सट्रैक्ट करें, और हेल्थ कनेक्ट में उस डेटा को डिलीट करें जिसे उपयोगकर्ता ने आपके सिस्टम में डिलीट किया है।
परिवर्तन टोकन और वृद्धिशील खपत
परिवर्तनों को निकालने के लिए, हेल्थ कनेक्ट एसडीके एक तंत्र प्रदान करता है। परिवर्तन सिंकआपका ऐप सबसे पहले एक चेंज टोकन का अनुरोध करता है। getChangesToken()यह टोकन उन रिकॉर्डों के प्रकारों को दर्शाता है जिनके लिए आप परिवर्तनों को ट्रैक करना चाहते हैं। यह टोकन एक निश्चित समय को दर्शाता है जिससे आप संशोधनों का अनुरोध कर सकते हैं।
उस टोकन से आप कॉल करते हैं getChanges() जब तक आपको और आइटम प्राप्त होना बंद न हो जाएं, तब तक यह एक लूप में चलता रहेगा। प्रत्येक प्रतिक्रिया में परिवर्तनों की एक सूची शामिल होती है (प्रकार की)। अप्सर्प्शन परिवर्तन या विलोपन परिवर्तन), यह एक संकेतक है कि क्या और भी बदलाव हैं और अगली बार के लिए एक नया टोकन संग्रहीत करना है। आपके ऐप को सभी बदलावों से गुजरना होगा, उन्हें संसाधित करना होगा और अंत में सहेजना होगा। nextChangesToken एक सिंक्रोनाइज़ेशन संदर्भ के रूप में।
इंसर्शन/अपडेट परिवर्तन (अप्सर्शनचेंज) में संपूर्ण रिकॉर्ड, उसके मेटाडेटा सहित, शामिल होता है। अपने डेटा को दोबारा इंपोर्ट करने से बचने के लिए, यह एक अच्छा विचार है। dataOrigin.packageName फ़ील्ड की जाँच करें और अपने स्वयं के ऐप से उत्पन्न रिकॉर्ड को छोड़ दें। विलोपन परिवर्तन केवल प्राप्त होते हैं। हटाए गए रिकॉर्ड की आईडीनिजता कारणों से, यह महत्वपूर्ण है कि आपने अपने डेटा से संबंधित इन आईडी को पहले से ही सुरक्षित रखा हो।
सामान्य तौर पर स्वैप टोकन का उपयोग करने की सलाह दी जाती है। प्रत्येक डेटा प्रकार द्वारा अलग किया गया आप इसका उपयोग कर सकते हैं, जब तक कि आपके व्यावसायिक तर्क के लिए कई प्रकारों को एक साथ संभालने की आवश्यकता न हो। इस तरह, यदि उपयोगकर्ता किसी एक अनुमति को रद्द कर देता है, तो संपूर्ण सिंक्रोनाइज़ेशन बाधित नहीं होता है।
परिवर्तन टोकन की समय सीमा समाप्त होने पर अपनाई जाने वाली रणनीतियाँ
एक्सचेंज टोकन में समाप्ति की तारीख यदि 30 दिनों से अधिक समय तक इसका उपयोग न किया जाए, तो जानकारी खोने से बचने के लिए, टोकन के अमान्य हो जाने की स्थिति में पुनर्प्राप्ति रणनीति की योजना बनाएं।
सबसे अच्छा विकल्प टाइमस्टैम्प को स्टोर करना है। अंतिम सफल पठन और, जब कोई टोकन समाप्त हो जाता है, तो क्लाइंट आईडी या हेल्थ कनेक्ट आईडी का उपयोग करके डुप्लिकेशन हटाकर उस बिंदु से (या पिछले 30 दिनों से) डेटा को पुनः पढ़ें। अन्य कम परिष्कृत रणनीतियों में पिछले 30 दिनों के डेटा को हटाना और उसे पुनः आयात करना, या डुप्लिकेशन हटाए बिना उस अंतराल को पढ़ना शामिल है (यह अंतिम रणनीति, जो सबसे खराब है, उपयोगकर्ता को डुप्लिकेट दिखा सकती है)।
यह भी सलाह दी जाती है कि एक्सचेंज टोकन के लिए पहले से ही अनुरोध कर लें, भले ही आप उनका तुरंत उपयोग न करने वाले हों, ताकि एक उचित अद्यतन चक्र और समय सीमा से बाहर होने से बचें।
कम विलंबता के साथ पहनने योग्य उपकरणों से सिंक्रोनाइज़ेशन
जब डेटा स्रोत एक हो पहनने योग्य उपकरण ब्लूटूथ लो एनर्जी (बीएलई) के माध्यम से कनेक्ट होने पर, कम विलंबता वाली सिंक पाइपलाइन यह सुनिश्चित करने के लिए उपयोगी हो सकती है कि डेटा हेल्थ कनेक्ट तक तब भी पहुंचे जब ऐप फोरग्राउंड में न हो।
इस परिदृश्य के लिए, एंड्रॉइड निम्नलिखित विकल्प प्रदान करता है। साथी डिवाइस सेवायह सुविधा आपके ऐप को किसी डिवाइस से जुड़े रहने और एंड्रॉइड 8 (एपीआई 26) के बाद से कुशलतापूर्वक डेटा (जैसे, सूचनाएं या जीएटीटी प्रॉम्प्ट) प्राप्त करने की अनुमति देती है।
सामान्य प्रक्रिया इस प्रकार है: सबसे पहले उपयोगकर्ता को निर्देशित किया जाता है CompanionDeviceManager का उपयोग करके वियरेबल को पेयर करेंइसके साथ संवाद करने के लिए आवश्यक अनुमतियाँ प्राप्त करना। फिर, मैनिफेस्ट में, एक सेवा घोषित की जाती है जो CompanionDeviceService का विस्तार करती है और एक्शन से जुड़ी होती है। android.companion.CompanionDeviceServiceअनुमति से संरक्षित android.permission.BIND_COMPANION_DEVICE_SERVICE.
यह सेवा GATT कनेक्शन और उनके कॉलबैक को प्रबंधित करती है। हर बार जब पहनने योग्य उपकरण डेटा भेजता है (उदाहरण के लिए, एक नया हृदय गति (या चरणों के एक पैकेज में), सेवा प्राप्त मान को संसाधित करती है, उसे परिवर्तित करती है हेल्थ कनेक्ट रिकॉर्ड्स और उन्हें सम्मिलित करता है insertRecords()हालांकि, यह सेवा स्वयं अनुमतियों का अनुरोध नहीं कर सकती: इसे इस बात पर निर्भर रहना होगा कि ऐप ने पहले ही आवश्यक अनुमतियों का अनुरोध किया हो और प्राप्त कर लिया हो (उदाहरण के लिए, हृदय गति या कदमों को लिखना)।
अग्रभूमि और पृष्ठभूमि में अच्छी पठन पद्धतियाँ
डिजाइन के अनुसार, एप्लिकेशन केवल हेल्थ कनेक्ट डेटा को तब पढ़ें जब वह फोरग्राउंड में हो।जब तक उन्हें पृष्ठभूमि में डेटा पढ़ने की विशेष अनुमति न दी गई हो। ऐसा संवेदनशील डेटा तक गुप्त पहुंच को सीमित करने के लिए किया जाता है।
यदि आपका ऐप बैकग्राउंड रीड परमिशन प्राप्त करता है, तो उपयोगकर्ता उच्च स्तर की पहुंच प्रदान कर रहा होगा, इसलिए इसे स्पष्ट रूप से समझाना महत्वपूर्ण है। आपको उस क्षमता की आवश्यकता क्यों है? और इसके क्या-क्या फायदे हैं (उदाहरण के लिए, ऐप खोले बिना ही स्वचालित सिंक्रोनाइज़ेशन)। फिर भी, आपको यह मानकर चलना चाहिए कि इसकी पहुँच प्रतिबंधित हो सकती है। किसी भी समय बाधित करेंउदाहरण के लिए, यदि सिस्टम ऐप को बंद कर देता है, तो आपको अगले सत्र में सिंक्रोनाइज़ेशन प्रक्रिया को फिर से शुरू करना होगा।
व्यवहार में, दो महत्वपूर्ण समयों पर नए डेटा की जांच करना उचित रहता है: जब भी ऐप फोरग्राउंड में आता है (लाइफसाइकिल इवेंट्स का उपयोग करके), और समय-समय पर जब तक उपयोगकर्ता इसे खुला रखता है, उन्हें अपडेटेड डेटा होने पर सूचित करता है ताकि वे व्यू, ग्राफ या सारांश को रीफ्रेश कर सकें।
बेहतर अनुमति प्रबंधन, परिवर्तन टोकन के ज़िम्मेदार उपयोग और एक सुसंगत आईडी संग्रहण नीति के साथ इन प्रथाओं को मिलाकर, अंतिम-उपयोगकर्ता स्वास्थ्य ऐप और अधिक उन्नत स्वास्थ्य डेटा प्रबंधन समाधान दोनों ही हेल्थ कनेक्ट का लाभ उठा सकते हैं। डेटा विखंडन को कम करें, डेटा की गुणवत्ता में सुधार करें और अधिक सुसंगत अनुभव प्रदान करते हैं, जिसमें उपयोगकर्ता हमेशा इस बात पर नियंत्रण रखता है कि क्या साझा किया जाता है और किसके साथ साझा किया जाता है। इस जानकारी को साझा करें ताकि अधिक से अधिक लोग नए हेल्थ कनेक्ट और इसके द्वारा प्रदान किए जाने वाले स्वास्थ्य डेटा के बारे में जान सकें।