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

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

<!-- 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 उसे अनुमतियां मैनेज करें स्क्रीन पर ले जाता है. यह उन ऐप्लिकेशन के लिए स्वीकार किया जा सकता है जहां इंटिग्रेशन के काम करने के लिए, अनुमतियां देना ही एकमात्र ज़रूरी शर्त है.

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