برای کاربران ورودی برنامه ریزی کنید

بسیاری از برنامه‌ها یک جریان کاری سفارشی برای آشنایی کاربر با محیط کاربری دارند، مانند آموزش کاربر در مورد ویژگی‌های برنامه یا درخواست رضایت کاربر. برای ایجاد یک جریان ارتباطی یکپارچه، برنامه شما همچنین می‌تواند از API تطبیق (Matchmaking API) استفاده کند تا کاربران را به اتصال برنامه‌های دیگری که می‌توانند داده‌هایی را که برنامه شما برای خواندن آنها پیکربندی شده است، بنویسند، ترغیب کند.

برای گنجاندن یک جریان سفارشی برای ورود به سیستم، Health Connect را طوری پیکربندی کنید که پس از اعطای مجوزها، به طور خودکار اجرا شود. با این حال، توجه داشته باشید که API Matchmaking از این تریگر پشتیبانی نمی‌کند. برای انجام این کار، موارد زیر را به مانیفست خود اضافه کنید:

<!-- 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 آغاز کنند، نه از داخل برنامه شما.

پشتیبانی از نسخه

برای پشتیبانی از دستگاه‌های اندروید ۱۴ به قبل و اندروید ۱۴ به بعد:

  • رویکرد پیشنهادی: یک فعالیت یکپارچه‌سازی ایجاد کنید که هر دو سناریو را مدیریت کند. همانطور که در مثال نشان داده شده است، از یک نام مستعار فعالیت برای تأیید سازگاری در نسخه‌های مختلف اندروید استفاده کنید.

  • رویکرد جایگزین: دو فعالیت جداگانه، یکی برای هر نسخه اندروید، صادر کنید. این رویکرد ممکن است منجر به افزایش پیچیدگی نگهداری شود.

الزامات فعالیت صادراتی

وقتی کاربری تلاش می‌کند برنامه شما را به Health Connect متصل کند، اکتیویتی اکسپورت شده اجرا می‌شود. این اکتیویتی باید موارد زیر را انجام دهد:

  • هرگونه آموزش مرتبط با کاربر، مانند توضیح اینکه چه داده‌هایی نوشته یا خوانده می‌شوند، را نمایش دهید.
  • در صورت لزوم، از کاربر بخواهید رضایت خود را اعلام کند.
  • درخواست مجوز را به Health Connect ارسال کنید.
  • انجام هرگونه منطق خاص برنامه دیگر مانند زمان‌بندی یک کارگر دوره‌ای.
  • پس از تکمیل، به کاربر اجازه دهید فعالیت را لغو کند.

برای برنامه‌هایی که فعالیت ورود به سیستم را صادر نمی‌کنند ، Health Connect به جای آن، کاربر را به محض تلاش برای اتصال به برنامه، به صفحه مدیریت مجوزها می‌برد. این ممکن است برای برنامه‌هایی که اعطای مجوزها تنها پیش‌نیاز برای عملکرد یکپارچه‌سازی است، قابل قبول باشد.

توجه داشته باشید که فعالیت آشنایی با سیستم (onboarding activity) ممکن است بیش از یک بار اجرا شود، برای مثال اگر کاربر بعداً مجوزهای برنامه شما را لغو کند و سپس دوباره به آن متصل شود.

قبلی
نمای کلی
بعدی
API تطبیق