Health Connect के यूज़र इंटरफ़ेस (यूआई) के दिशा-निर्देश

आपके ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) में, Health Connect का इस्तेमाल करने के फ़ायदों के बारे में बताया जाना चाहिए. साथ ही, मुख्य कॉन्सेप्ट को इस तरह से समझाया जाना चाहिए कि उपयोगकर्ता को इंटिग्रेशन के बारे में बेहतर तरीके से जानकारी मिल सके.

आपका उपयोगकर्ता अनुभव (यूएक्स) इन तीन सिद्धांतों के मुताबिक होना चाहिए:

  1. कंसिस्टेंसी: पक्का करें कि इंटिग्रेशन की पूरी प्रोसेस के दौरान फ़्लो एक जैसे हों.
  2. पारदर्शिता: साफ़ तौर पर बताएं कि Health Connect, आपके ऐप्लिकेशन के साथ कैसे काम करता है.
  3. पारदर्शिता: उपयोगकर्ताओं को अपने ऐप्लिकेशन के ज़रिए Health Connect को ऐक्सेस करने में मदद करें.

बड़े लेवल पर, UX फ़्लो को इन चरणों में बांटा जा सकता है:

Health Connect का यूज़र एक्सपीरियंस फ़्लो

Health Connect को प्रमोट करना

आपके ऐप्लिकेशन में Health Connect को दिखाने का तरीका, यूज़र एक्सपीरियंस (यूएक्स) के पैटर्न और यूज़र इंटरफ़ेस (यूआई) में तय किए गए नियमों पर निर्भर करता है.

उपयोगकर्ता के फ़ायदे पर फ़ोकस करना

जब उपयोगकर्ताओं को पहली बार Health Connect के बारे में बताया जाए, तो उन्हें यह ज़रूर बताएं कि आपके इंटिग्रेशन का इस्तेमाल करने से उन्हें क्या फ़ायदा होगा.

Health Connect की सुविधाओं के बारे में बताने के बजाय, अपने मैसेज में यह बताएं कि किसी उपयोगकर्ता को उन सुविधाओं से क्या फ़ायदा मिलता है.

Health Connect का इस्तेमाल करने वालों को मिलने वाले फ़ायदे

आसान भाषा का इस्तेमाल करना

लोगों से "Health Connect से कनेक्ट करें" न कहें. यह वाक्य सही नहीं है. इससे उपयोगकर्ता को Health Connect के ईकोसिस्टम में मौजूद ऐप्लिकेशन के बीच के संबंध को समझने में भी परेशानी हो सकती है.

आपके UX से लोगों को यह पता चलना चाहिए कि Health Connect, आपके ऐप्लिकेशन के साथ कैसे इंटरैक्ट करता है. इसलिए, यह जानना ज़रूरी है कि इस लक्ष्य को हासिल करने के लिए, कौनसे बटन लेबल सबसे सही तरीके से काम करते हैं.

अपने बटन के लेबल पर, "सेट अप करें" या "शुरू करें" जैसे क्रिया वाक्यांशों का इस्तेमाल करें. इसके अलावा, अगर आपको अनुमतियों का व्यू लॉन्च करना है, तो बटन के लिए ज़्यादा सटीक टेक्स्ट का इस्तेमाल करें. जैसे, "शेयर करने के लिए डेटा चुनें."

Health Connect की आसान भाषा में जानकारी

Health Connect को प्रमोट करना

यहां कुछ ऐसे तरीके दिए गए हैं जिनसे अपने ऐप्लिकेशन में Health Connect का प्रमोशन किया जा सकता है:

ऐप्लिकेशन सेटअप करने और अनुमतियों का अनुरोध करने का तरीका

ऐप्लिकेशन सेटअप करना और अनुमतियों का अनुरोध करना

होम स्क्रीन पर दिखने वाले प्रोमो कार्ड का फ़्लो

होम स्क्रीन पर दिखने वाला प्रोमो फ़्लो

सेटिंग

एंट्री पॉइंट वाली सेटिंग

Android 13 APK डाउनलोड करें

Android 13 APK डाउनलोड करें

नए डेटा टाइप को शामिल करना और अनुमतियों का अनुरोध करना

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

अनुमतियों वाली स्क्रीन पर, सिर्फ़ अनुरोध किए गए नए डेटा टाइप दिखने चाहिए, ताकि उपयोगकर्ताओं को कोई भ्रम न हो.

नए डेटा टाइप का प्रमोशन करने के कुछ उदाहरण यहां दिए गए हैं:

मौजूदा कन्वर्ज़न का फिर से इस्तेमाल करना

अगर आपका ऐप्लिकेशन पहले से ही अन्य इकोसिस्टम में नए डेटा का प्रमोशन करता है, तो हम आपको Android में Health Connect के लिए भी ऐसा करने का सुझाव देते हैं. साथ ही, जहां ज़रूरी हो वहां भाषा को अडैप्ट करें.

खास सुविधाओं पर ज़ोर देना

उपयोगकर्ता आपके ऐप्लिकेशन में इस डेटा का इस्तेमाल क्यों करना चाहेंगे?

  • उदाहरण: डेटा पढ़ना
    • इससे उपयोगकर्ताओं को आपके ऐप्लिकेशन में ज़्यादा सटीक जानकारी मिलती है
    • उपयोगकर्ता आपके ऐप्लिकेशन में मौजूद सभी डेटा को एक ही जगह पर देख सकते हैं
  • उदाहरण: डेटा लिखना
    • लोग, आपके ऐप्लिकेशन से मिले इस नए डेटा को अपने फ़ोन पर मौजूद, सेहत और फ़िटनेस से जुड़े अन्य ऐप्लिकेशन के साथ शेयर कर सकते हैं

अनुमतियों को कॉन्टेक्स्ट के हिसाब से तय करना

उपयोगकर्ताओं से नई अनुमतियां तब मांगें, जब वे उनके काम की हों. इससे उन्हें पता चलेगा कि उनसे क्या मांगा जा रहा है.

उदाहरण:

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

नए डेटा टाइप का अनुरोध करना

रद्द की गई अनुमतियां

आपके ऐप्लिकेशन की सेटिंग स्क्रीन पर, उपयोगकर्ताओं को यह दिखना चाहिए कि वे Health Connect के डेटा टाइप के लिए अनुमतियां कैसे रद्द करें:

रद्द की गई अनुमतियां

अपर्याप्त पहुंच

अगर आपके ऐप्लिकेशन के पास Health Connect का पूरा ऐक्सेस नहीं है, तो लोगों को सभी एंट्री पॉइंट पर यह स्क्रीन दिखनी चाहिए:

ऐसे ऐप्लिकेशन जिनके पास ज़रूरी ऐक्सेस नहीं है

अनुमतियां दो बार रद्द की गई हैं

अगर उपयोगकर्ता, अनुमति के अनुरोध वाली स्क्रीन पर लगातार दो बार रद्द करें चुनता है, तो आपके ऐप्लिकेशन को उपयोगकर्ता को इस तरह की स्क्रीन दिखानी चाहिए:

उपयोगकर्ता ने दो बार अनुमतियां रद्द की हैं

डेटा पढ़ना और दिखाना

उपयोगकर्ताओं का भरोसा जीतने और उन्हें यह भरोसा दिलाने के लिए कि उनके डेटा को सही तरीके से पढ़ा जा रहा है, यह दिखाना ज़रूरी है कि आपका ऐप्लिकेशन डेटा कैसे हासिल करता है. यह डेटा, packageName क्लास की DataOrigin प्रॉपर्टी से मिलता है.

ऐसा करने के दो तरीके हैं:

  1. बुनियादी एट्रिब्यूशन
  2. शिक्षा के साथ एट्रिब्यूशन

बुनियादी एट्रिब्यूशन

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

सही एट्रिब्यूशन के लिए, आपका ऐप्लिकेशन उस ऐप्लिकेशन का नाम और आइकॉन दिखा सकता है जिसने मूल रूप से डेटा रिकॉर्ड किया था. इससे लोगों का भरोसा बढ़ता है. साथ ही, यह भी पता चलता है कि स्वास्थ्य से जुड़ी जानकारी कहां से मिली है.

यह जानकारी पाने के लिए, आपको किसी संवेदनशील अनुमति का अनुरोध करने की ज़रूरत नहीं है. जैसे, QUERY_ALL_PACKAGES. यहां दिए गए उदाहरण में, PackageManager से किसी पैकेज के लिए ऐप्लिकेशन का लेबल और आइकॉन वापस पाने का तरीका बताया गया है:

fun getAppLabelAndIcon(context: Context, packageName: String): Pair<CharSequence?, Drawable?>{
    return try {
      val pm = context.pacageManager
      val appInfo = pm.getApplicationInfo(packageName, 0)
      val label = pm.getApplicationLabel(appInfo)
      val icon = pm.getApplicationIcon(appInfo)
      label to icon
    } catch (e: PackageManager.NameNotFoundException){
      null to null
    }
}

यह यूटिलिटी, डेटा के साथ-साथ ऐप्लिकेशन का नाम और आइकॉन दिखाती है. इससे यह पक्का होता है कि एट्रिब्यूशन सही तरीके से किया गया है. HealthConnectManager.kt के सैंपल में, लागू करने का तरीका देखें.

पढ़ने से जुड़े डेटा के लिए बुनियादी एट्रिब्यूशन

शिक्षा के साथ एट्रिब्यूशन

आपके ऐप्लिकेशन से लोगों को यह जानकारी मिलनी चाहिए कि डेटा कहाँ से लिया गया है. साथ ही, इसमें Health Connect में मौजूद "ऐप्लिकेशन की अनुमतियाँ" स्क्रीन का डायरेक्ट लिंक होना चाहिए. इस तरह का एट्रिब्यूशन, इन स्क्रीन के लिए सही है: गतिविधि की जानकारी, रिपोर्ट, और अहम जानकारी.

डेटा सिंक करने की सुविधा

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

डेटा सिंक होने की स्थिति दिखाने वाली इमेज

ऐसेट

प्रॉडक्ट के आइकॉन का इस्तेमाल, सफ़ेद या बहुत हल्के स्लेटी रंग के बैकग्राउंड पर किया जाना चाहिए. अगर ज़रूरी हो, तो काले बैकग्राउंड पर भी आइकॉन का इस्तेमाल किया जा सकता है.

आइकॉन के लिए दिशा-निर्देश

ये आइकॉन डाउनलोड करें: