Veri görüntüleme ve ilişkilendirme

Kullanıcılara verilerinin doğru şekilde okunduğunu göstermek için uygulamanızın verileri nasıl aldığını açıkça gösterin. Veriler, packageName sınıfının DataOrigin özelliğinden alınır.

Bunu yapmanın iki yolu vardır:

  1. Temel ilişkilendirme
  2. Eğitimle ilişkilendirme

Temel ilişkilendirme

Kullanıcı arayüzünüz (UI) en azından uygulama kaynağı simgesini ve adını (veya simge gösterilemiyorsa yalnızca uygulama adını) göstermelidir. Temel ilişkilendirme, Ana Sayfa, Etkinlik günlüğü ve Etkinlik ayrıntıları ekranları için uygundur.

Uygulamanız, uygun ilişkilendirmeyi desteklemek için verileri ilk kaydeden uygulamanın adını ve simgesini gösterebilir. Bu sayede kullanıcıların güveni artar ve sağlık bilgilerinin kaynağı net bir şekilde belirtilir.

Bu bilgileri almak için QUERY_ALL_PACKAGES gibi hassas izinler istemeniz gerekmez. Aşağıdaki örnekte, belirli bir paket için uygulama etiketinin ve simgenin PackageManager öğesinden nasıl alınacağı gösterilmektedir:

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
    }
}

Bu yardımcı program, hem uygulama adını hem de simgesini verilerle birlikte göstererek uygun ilişkilendirmeyi doğrulamaya yardımcı olur. Uygulamayı HealthConnectManager.kt örneğinde görebilirsiniz.

Okuma verileri için temel ilişkilendirme
Şekil 1: Okuma verileri için temel ilişkilendirme

Eğitimde ilişkilendirme

Uygulamanız, kullanıcılara verilerin kaynağı hakkında bilgi edinme konusunda yardımcı olmalı ve Health Connect'teki "Uygulama izinleri" ekranına doğrudan bağlantı vermelidir. Bu ilişkilendirme türü aşağıdaki ekranlar için uygundur: Etkinlik ayrıntıları, Raporlar ve analizler.

İş ortağı uygulamasındaki etkinlik ayrıntıları ve rapor ekranlarında ilişkilendirme İş ortağı uygulamasındaki analiz ekranlarında ilişkilendirme
Şekil 2: Eğitim varyasyonlarıyla ilişkilendirme

İş ortağı uygulamasındaki etkinlik ayrıntıları ve rapor ekranlarında ilişkilendirme İş ortağı uygulamasındaki analiz ekranlarında ilişkilendirme

Veri Senkronizasyonu

Uygulamanızı Health Connect ile senkronize ederken yeterli gecikme varsa senkronizasyon sırasında uygulamanızda bu bildirimi gösterin. Bu mesaj, kullanıcılara işlemin tamamlanmasının biraz zaman alabileceğini bildirir. Senkronizasyon için bildirimleri kullanıyorsanız bunlar varsayılan olarak düşük öncelikli olacak şekilde ayarlanmalıdır.

Veri senkronizasyonu durumu gösterilir.
Şekil 3: Veri senkronizasyon durumu gösteriliyor