نمایش داده ها و اسناد

برای اطمینان از اینکه کاربران از خواندن صحیح داده‌هایشان مطمئن می‌شوند، به وضوح نشان دهید که برنامه شما چگونه داده‌ها را دریافت می‌کند، که این کار از ویژگی packageName کلاس DataOrigin انجام می‌شود.

دو راه برای رسیدن به این هدف وجود دارد:

  1. انتساب اولیه
  2. انتساب با تحصیلات

انتساب اولیه

حداقل، رابط کاربری (UI) شما باید آیکون و نام منبع برنامه (یا فقط نام برنامه در صورت عدم نمایش آیکون) را نمایش دهد. انتساب اولیه برای صفحات زیر مناسب است: صفحه اصلی، گزارش فعالیت و جزئیات فعالیت.

برای پشتیبانی از انتساب صحیح، برنامه شما می‌تواند نام و نماد برنامه‌ای را که در ابتدا داده‌ها را ثبت کرده است، نمایش دهد. این امر اعتماد کاربر را بهبود می‌بخشد و شفافیت در مورد منشأ اطلاعات سلامت را فراهم می‌کند.

برای بازیابی این اطلاعات نیازی به درخواست هیچ مجوز حساسی مانند QUERY_ALL_PACKAGES ندارید. مثال زیر نحوه بازیابی برچسب و آیکون برنامه برای یک بسته داده شده از PackageManager را نشان می‌دهد:

fun getAppLabelAndIcon(context: Context, packageName: String): Pair<CharSequence?, Drawable?>{
    return try {
      val pm = context.packageManager
      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 تأخیر کافی وجود دارد، این اعلان را در طول همگام‌سازی در برنامه خود نشان دهید. این به کاربر اطلاع می‌دهد که ممکن است فرآیند کمی طول بکشد. اگر از اعلان‌ها برای همگام‌سازی استفاده می‌کنید، باید به طور پیش‌فرض روی اولویت پایین تنظیم شوند.

وضعیت همگام‌سازی داده‌ها نشان داده شده است
شکل ۳ : وضعیت همگام‌سازی داده‌ها نشان داده شده است