অনবোর্ডিং ব্যবহারকারীদের জন্য পরিকল্পনা

অনেক অ্যাপে ব্যবহারকারীকে অ্যাপের ফিচার সম্পর্কে জানানো বা তার সম্মতি চাওয়ার মতো কাজের জন্য একটি নিজস্ব অনবোর্ডিং ফ্লো থাকে। একটি নির্বিঘ্ন সংযোগ প্রবাহ তৈরি করতে, আপনার অ্যাপ ম্যাচমেকিং এপিআই (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>

ব্যবহারকারীরা আপনার অ্যাপের ভেতর থেকে নয়, বরং সরাসরি হেলথ কানেক্ট অ্যাপ থেকেই আপনার অ্যাপের সাথে সংযোগ স্থাপন করতে পারেন।

সংস্করণ সমর্থন

অ্যান্ড্রয়েড ১৪-এর পূর্ববর্তী এবং অ্যান্ড্রয়েড ১৪+ উভয় ডিভাইসকে সমর্থন করার জন্য:

• সুপারিশকৃত পদ্ধতি: একটিমাত্র অনবোর্ডিং অ্যাক্টিভিটি তৈরি করুন যা উভয় পরিস্থিতিই সামলাতে পারে। উদাহরণে দেখানো অনুযায়ী, বিভিন্ন অ্যান্ড্রয়েড সংস্করণে সামঞ্জস্যতা যাচাই করার জন্য একটি অ্যাক্টিভিটি অ্যালিয়াস ব্যবহার করুন।

• বিকল্প পদ্ধতি: প্রতিটি অ্যান্ড্রয়েড সংস্করণের জন্য একটি করে দুটি পৃথক অ্যাক্টিভিটি এক্সপোর্ট করুন। এই পদ্ধতির ফলে রক্ষণাবেক্ষণের জটিলতা বাড়তে পারে।

রপ্তানি কার্যক্রমের প্রয়োজনীয়তা

যখন কোনো ব্যবহারকারী আপনার অ্যাপটিকে হেলথ কানেক্ট-এর সাথে সংযুক্ত করার চেষ্টা করেন, তখন এক্সপোর্ট করা অ্যাক্টিভিটিটি চালু হয়। এই অ্যাক্টিভিটিটিকে অবশ্যই নিম্নলিখিত কাজগুলো করতে হবে:

• ডেটা কী লেখা বা পড়া হয়, তা ব্যাখ্যা করার মতো প্রাসঙ্গিক ব্যবহারকারী শিক্ষা প্রদর্শন করুন।
• প্রয়োজন হলে ব্যবহারকারীর সম্মতি নিন।
• হেলথ কানেক্ট-এর কাছে অনুমতির জন্য অনুরোধ করুন।
• অন্যান্য অ্যাপ্লিকেশন-নির্দিষ্ট লজিক সম্পাদন করুন, যেমন একটি পর্যায়ক্রমিক কর্মীর সময়সূচী নির্ধারণ করা।
• কাজটি সম্পন্ন হলে, ব্যবহারকারীকে কার্যক্রমটি বাতিল করার অনুমতি দিন।

যেসব অ্যাপ অনবোর্ডিং অ্যাক্টিভিটি এক্সপোর্ট করে না , সেসব ক্ষেত্রে ব্যবহারকারী অ্যাপটি কানেক্ট করার চেষ্টা করলে হেলথ কানেক্ট তাকে 'ম্যানেজ পারমিশন' স্ক্রিনে নিয়ে যায়। যেসব অ্যাপের ক্ষেত্রে ইন্টিগ্রেশনটি কাজ করার জন্য পারমিশন প্রদান করাই একমাত্র পূর্বশর্ত, সেগুলোর জন্য এটি গ্রহণযোগ্য হতে পারে।

মনে রাখবেন যে অনবোর্ডিং কার্যক্রমটি একাধিকবার চালু হতে পারে, উদাহরণস্বরূপ, যদি ব্যবহারকারী পরবর্তীতে আপনার অ্যাপের অনুমতি প্রত্যাহার করে নেন এবং তারপর পুনরায় সংযোগ করেন।