Health Connect kullanıcı arayüzü kuralları

Uygulamanızın kullanıcı arayüzünde (UI), Health Connect'in kullanım avantajları açıklanmalı ve temel kavramlar, entegrasyonun ne anlama geldiği konusunda kullanıcıların bilgi düzeyini artıracak şekilde anlatılmalıdır.

Kullanıcı deneyiminiz (UX) üç temel ilkeye uygun olmalıdır:

  1. Tutarlılık: Entegrasyon süreci boyunca akışların uyumlu olduğundan emin olun.
  2. Şeffaflık: Health Connect'in uygulamanızla birlikte nasıl çalıştığını açıkça açıklayın.
  3. Netlik: Kullanıcıların uygulamanız üzerinden Health Connect'e erişmesine yardımcı olun.

Genel olarak kullanıcı deneyimi akışı aşağıdaki aşamalara ayrılabilir:

Health Connect kullanıcı deneyimi akışı

Health Connect'i tanıtma

Uygulamanızda Health Connect'i öne çıkarma, kullanıcı arayüzünüzde belirlenen kullanıcı deneyimi kalıplarına ve kurallarına bağlıdır.

Kullanıcıya sağlanan faydaya odaklanma

Health Connect'i kullanıcılara ilk kez tanıttığınızda, entegrasyonunuzu kullanmaları için anlamlı bir neden sunmayı hedefleyin.

Health Connect'in özelliklerini açıklamak yerine mesajınızı, kullanıcının bu özelliklerden nasıl yararlanacağı üzerine şekillendirin.

Health Connect'in kullanıcılar için avantajları

Net bir dil kullanın

Kullanıcılardan "Health Connect'e bağlanmalarını" istemeyin. Bu cümle, kullanıcıların Health Connect ekosistemindeki uygulamalar arasındaki ilişkiyi anlamasını da zorlaştırabilir.

Kullanıcı deneyiminiz, kullanıcıların Health Connect'in uygulamanızla nasıl etkileşim kurduğu hakkında fikir edinmesine yardımcı olmalıdır. Bu nedenle, bu hedefe ulaşmak için hangi düğme etiketlerinin en iyi sonucu verdiğini göz önünde bulundurmanız önemlidir.

Düğme etiketlerinizde "kur" veya "başla" gibi fiil ifadeleri kullanmayı deneyin. Alternatif olarak, izinler görünümünü başlatıyorsanız "Paylaşılacak verileri seçin" gibi daha spesifik düğme metinleri kullanın.

Health Connect'te net dil

Health Connect'i tanıtma

Uygulamanızda Health Connect'i tanıtmanın bazı yolları şunlardır:

Uygulama kurulumu ve izin isteme akışı

Uygulama kurulumu ve izin isteme

Ana Ekran Tanıtım Kartı Akışı

Ana ekran tanıtım akışı

Ayarlar

Giriş noktası olan ayarlar

Android 13 APK İndirme

Android 13 APK'sını indirme

Yeni veri türlerini kullanmaya başlama ve izin isteme

Health Connect entegrasyonu olan uygulamalar, halihazırda verilen izinlere ek olarak yeni veri türleri isteyebilir.

Kullanıcıların kafasını karıştırmamak için izin ekranında yalnızca istenen yeni veri türleri gösterilmelidir.

Yeni veri türlerini tanıtma yöntemlerine ilişkin birkaç örneği aşağıda bulabilirsiniz:

Mevcut kuralları yeniden kullanma

Uygulamanız diğer ekosistemlerde yeni verileri tanıtıyorsa Android'de Health Connect için de aynı işlemi yapmanızı ve dili uygun şekilde uyarlamanızı öneririz.

Değer teklifini vurgulama

Kullanıcılar neden uygulamanızda bu verileri kullanmak ister?

  • Örnekler: verileri okuma
    • Kullanıcılara uygulamanızda daha doğru analizler sunar.
    • Kullanıcılar, uygulamanızdaki tüm verileri tek bir yerde görebilir.
  • Örnek: verileri yazma
    • Kullanıcılar, uygulamanızdaki bu yeni verileri telefonlarındaki diğer uyumlu sağlık ve fitness uygulamalarıyla paylaşabilir.

İzinleri bağlama göre belirleme

Kullanıcılardan, kendileri için anlamlı olan yeni izinler isteyin. Böylece, kendilerinden ne istendiğini bilirler.

Örnekler:

  • Kullanıcılar uygulamanızda antrenmanı tamamladıktan sonra egzersiz rotaları izni isteyin.
  • Uygulamanız yeni izinler uyguluyorsa bunları ana ekranda tek bir tanıtım olarak birlikte gösterin.
  • Uygulamanızda Uyku gibi özel bir bölüm varsa ilgili izni burada tanıtın.

Yeni veri türü isteğinde bulunma

Veri erişimi ve senkronizasyon

Uygulamanızın Ayarlar ekranında, kullanıcılara Health Connect bağlantılarını yönetme seçenekleri sunulmalıdır. Bu sayede kullanıcılar, veri senkronizasyonu ve verilerine erişim üzerinde kontrol sahibi olur.

İptal edilen ve kaldırılan izinler

Health Connect ile senkronize etme

Bu açma/kapatma düğmesi, kullanıcıların uygulamanız ile Health Connect arasındaki veri senkronizasyonunu duraklatmasına veya devam ettirmesine olanak tanır.

  • Etkinleştirildiğinde: Uygulamanız, kullanıcı tarafından verilen izinler doğrultusunda Health Connect'te aktif olarak okuma ve yazma işlemleri yapar.
  • Devre dışı bırakıldığında: Uygulamanız, Health Connect ile tüm veri senkronizasyonunu durdurmalıdır. revokeAllPermissions() kullanarak izinleri programatik olarak iptal ederseniz değişikliklerin, uygulama yeniden başlatılmadan Health Connect'e hemen yansıtılmadığını kullanıcıya açıklayın. Kullanıcıların kafa karışıklığı yaşamaması için onlara Health Connect ayarlarına giderek izinleri iptal etme seçeneği sunun.

Erişimi yönet

Erişimi yönet düğmesi, kullanıcının Health Connect uygulamasından uygulamanızın izinlerini yönetebileceği doğrudan bir bağlantı sağlamalıdır. Bu, kullanıcıya tam kontrol ve şeffaflık sağlar.

Yetersiz erişim

Uygulamanızın Health Connect erişimi yetersizse kullanıcılara tüm giriş noktalarında aşağıdaki ekran gösterilmelidir:

Yetersiz erişime sahip uygulama

İzinler iki kez iptal edildi

Kullanıcı, izin isteği ekranında iki kez üst üste İptal'i seçerse uygulamanız kullanıcıya aşağıdakine benzer bir ekran göstermelidir:

İzinler kullanıcı tarafından iki kez iptal edildi

Verileri okuma ve görüntüleme

Güven oluşturmak ve kullanıcılara verilerinin doğru şekilde okunduğunu bildirmek için uygulamanızın, packageName sınıfının DataOrigin mülkünden gelen verileri nasıl aldığını göstermeniz önemlidir.

Bunu yapmanın iki yolu vardır:

  1. Temel ilişkilendirme
  2. Eğitimde 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 simgesinin PackageManager öğesinden nasıl alınacağı gösterilmektedir:

fun getAppLabelAndIcon(context: Context, packageName: String): Pair<CharSequence?, Drawable?>{
    return try {
      val pm = context.pacageManager
      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 sağlar. Uygulamayı HealthConnectManager.kt örneğinde görebilirsiniz.

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.

Veri Senkronizasyonu

Uygulamanızı Health Connect ile senkronize ederken yeterli gecikme varsa veriler senkronize edilirken uygulamanızın bu bildirimi göstermesini öneririz. Bu mesaj, kullanıcıya bir işlemin gerçekleştiğini ve 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.

Öğeler

Ürün simgeleri beyaz veya çok açık gri bir arka plan üzerinde kullanılmalıdır. Gerekirse simgeyi siyah arka plan üzerinde de kullanabilirsiniz.

Simgeyle ilgili kurallar

Aşağıdaki simgeleri indirin:

  • Health Connect logosu

    İndir

  • Health Connect logosu beyaz

    İndir