उपयोगकर्ताओं को शामिल करने के लिए प्लान बनाना

कई ऐप्लिकेशन में, वर्कफ़्लो के लिए पसंद के मुताबिक ऑनबोर्डिंग फ़्लो होता है. जैसे, उपयोगकर्ता को ऐप्लिकेशन की सुविधाओं के बारे में बताना या उपयोगकर्ता से सहमति लेना. आसानी से कनेक्ट करने की सुविधा देने के लिए, आपका ऐप्लिकेशन Matchmaking API का इस्तेमाल भी कर सकता है. इससे उपयोगकर्ताओं को ऐसे अन्य ऐप्लिकेशन कनेक्ट करने के लिए कहा जा सकता है जो आपके ऐप्लिकेशन के डेटा को पढ़ सकते हैं.

पसंद के मुताबिक ऑनबोर्डिंग फ़्लो शामिल करने के लिए, Health Connect को कॉन्फ़िगर करें, ताकि अनुमतियां मिलने के बाद यह अपने-आप लॉन्च हो जाए. हालांकि, ध्यान दें कि Matchmaking API इस ट्रिगर के साथ काम नहीं करता. इसके लिए, अपने मेनिफ़ेस्ट में यह जोड़ें:

<!-- Required to support pre-Android 14 devices with APK Health Connect -->
<activity
  android:name=".OnboardingActivity"
  android:exported="true"
  android:permission="com.google.android.apps.healthdata.permission.START_ONBOARDING">
  <intent-filter>
    <action android:name="androidx.health.ACTION_SHOW_ONBOARDING"/>
  </intent-filter>
</activity>
<!-- Required to support Android 14+ devices with platform Health Connect -->
<activity-alias
  android:name="UAndAboveOnboardingActivity"
  android:exported="true"
  android:targetActivity=".OnboardingActivity"
  android:permission="android.permission.health.START_ONBOARDING">
  <intent-filter>
    <action android:name="android.health.connect.action.SHOW_ONBOARDING" />
  </intent-filter>
</activity-alias>

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

वर्शन के साथ काम करने की सुविधा

Android 14 से पहले के वर्शन और Android 14 या इसके बाद के वर्शन वाले डिवाइसों, दोनों पर काम करने वाला ऐप्लिकेशन बनाने के लिए:

• सुझाया गया तरीका: एक ही ऑनबोर्डिंग गतिविधि बनाएं, जो दोनों स्थितियों को मैनेज करे. उदाहरण में दिखाए गए तरीके से, गतिविधि के उपनाम का इस्तेमाल करें. इससे यह पुष्टि की जा सकेगी कि यह Android के सभी वर्शन के साथ काम करता है.

• अन्य तरीका: दो अलग-अलग गतिविधियां एक्सपोर्ट करें. हर Android वर्शन के लिए एक गतिविधि. इस तरीके से, रखरखाव से जुड़ी समस्याएं बढ़ सकती हैं.

एक्सपोर्ट की गई गतिविधि से जुड़ी ज़रूरी शर्तें

जब कोई उपयोगकर्ता आपके ऐप्लिकेशन को Health Connect से कनेक्ट करने की कोशिश करता है, तब एक्सपोर्ट की गई गतिविधि लॉन्च होती है. इस गतिविधि में ये काम होने चाहिए:

• उपयोगकर्ता को काम की जानकारी दिखाएं. जैसे, यह बताना कि कौन-सा डेटा लिखा या पढ़ा गया है.
• अगर ज़रूरी हो, तो उपयोगकर्ता से सहमति देने के लिए कहें.
• Health Connect से अनुमतियों का अनुरोध करें.
• ऐप्लिकेशन से जुड़े किसी अन्य लॉजिक को लागू करें. जैसे, समय-समय पर काम करने वाले वर्कर को शेड्यूल करना.
• जब गतिविधि पूरी हो जाए, तो उपयोगकर्ता को इसे खारिज करने की अनुमति दें.

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

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