Health Connect veri türlerini planlama ve inceleme

Health Connect, sağlık ve fitness verilerini depolayıp yapılandırır. Aynı zamanda farklı veri türlerinin nasıl ölçüldüğünü öğrenmek için kullanılır. Bu veri türleri şunlardır: nabız hemen yapılan ölçümler, adım sayısının zaman içinde alınması ve uyku verileri oturumlarda hazırlar.

Öncelikle Sağlık uygulamasının hangi veri türlerini ve izinlerini Uygulamanızın gereksinimlerini planlayabilmek için teklifleri bağlayın. Böylece, şartları son haline getirmeden önce veri türlerinizi incelemeniz gerekiyor.

Veri türü kategorileri

Health Connect, çoğu sağlık ve fitness alanında kullanılan veri türlerini destekler. mümkün olduğunca çok çeşitlilik sunmak için. Health Connect, verilerini kapsamlı bir şekilde görüntüleyebilir ve saklayabilirsiniz. Bu veri türleri, aşağıdaki kategorilere ayrılır:

  • Etkinlik: Kullanıcının yaptığı tüm etkinlikleri yakalar. Şunları içerebilir: koşu, yüzme ve uyku gibi sağlık ve fitness aktiviteleri.
  • Vücut Ölçümü: Vücutla ilgili şu gibi yaygın verileri yakalar: kullanıcının ağırlığı ve bazal metabolizma hızı.
  • Döngü İzleme: Bu özellik menstrüasyon döngülerini ve ilgili veri noktalarını yakalar. örneğin bir ovülasyon testinin ikili sonucu gibi.
  • Beslenme: Sıvı alımı ve beslenme veri türlerini yakalar. Önceki kullanıcının tek bir içecekte tükettiği su miktarını temsil eder. İkincisi kalori, şeker ve magnezyum gibi isteğe bağlı alanları da kapsar.
  • Uyku: Kullanıcının uzunluğu ve türüyle ilgili aralık verilerini yakalar uykuyu getirebilecektin.
  • Vitals: Kullanıcının genel istatistikleri hakkında sağlık. Vücut sıcaklığı, kan şekeri, kan gibi verileri içerir ve kandaki oksijen doygunluğunu etkiler.

Veri türü biçimi

Health Connect'teki veri türleri, şunun alt sınıfları olan nesnelerde depolanır: Record.

Her veri türü için time ve zoneOffset veya title, count ve percentage gibi belirli. Bazı alanlarda uzun, çift veya dize gibi basit türler kullanılırken diğer alanlarda Instant ve ZoneOffset. Bu alanların özellikleri zorunlu olabilir veya isteğe bağlıdır. Bazı özellikler salt okunur, bazı özellikler ise belirli bir değer aralığını seçin.

Mevcut veri türlerinin ve alanlarının tam listesi için Jetpack'te kullanılabilir.

Ek veri özellikleri

Health Connect API'deki veriler, meta veri özelliklerini de içerir. aşağıdaki listede açıklandığı şekildedir:

  • Health Connect ID: Her veri noktasına benzersiz bir tanımlayıcı atanır (UID). Bu, standart okuma ve yazma işlemleri için yararlıdır. Daha fazla bilgi için Health Connect ID başlıklı makaleyi inceleyin.
  • Son değiştirilme zamanı: Bu, zaman damgasını son kayıt örneği olarak işaretler için bir güncelleme var. İlk oluşturulduğunda otomatik olarak oluşturulur. her güncellemede geçerli olur.
  • Veri kaynağı: Health Connect, veriler geldi. Bu, söz konusu kaynağın paket adını içerir. oluşturulduktan sonra otomatik olarak eklenir.
  • Cihaz: Health Connect, verilerin depolandığı cihazla ilgili bilgileri geldi. Bu URL, söz konusu cihazın üreticisini ve modelini içerir. değeri manuel olarak sağlamalısınız.
  • İstemci Kimliği: Health Connect, istemci uygulamalarının yapılabilmesi için istemci kimlikleri sağlar. Kendi kimliklerini kullanarak verilere atıfta bulunurlar. Bu, çatışmaların çözülmesine yardımcı olur ve senkronizasyonu kolaylaştırır. Bu değer, kayda manuel olarak sağlanır.
  • İstemci kaydı sürümü: Health Connect, istemci kimliğiyle birlikte şunları da sağlar: için kullanılan yeni sürüm oluşturma olanağı sunar. Bu bilgi şunları sağlar: el ile kaydetmelisiniz.
  • Kayıt yöntemi: Health Connect, verilerin nasıl kaydedildiğini anlamanıza yardımcı olur. Bu yöntemler arasında verileri pasif (otomatik olarak) kaydeden uygulamalar ve kullanıcılar, veya manuel olarak kaydetmektir.

Health Connect kimliği

Health Connect, yeni eklenen veri nesnelerine benzersiz tanımlayıcılar (UID'ler) atar. veri nesnelerini tanımlayan ve diğerlerinden ayıran özellikler. Health Connect kimlikleri okuma veya yazma isteklerinde kullanışlıdır. Health Connect kimlikleri ile aynı değil İstemci kimlikleri. İstemci uygulamaları, istemci kimliklerini atarken Health Connect yalnızca Health Connect kimlikleri atar.

Health Connect kimlikleriyle çalışırken aşağıdaki notları unutmayın:

  • Oturumlarda tek bir Health Connect kimliği bulunur ancak oturumlardaki verilerin farklı bir kimliği vardır Health Connect kimliklerine sahip olmanız gerekir.
  • Health Connect kimlikleri zaman damgalarıyla bağlantılı değildir veya bunlarla ilgili değildir.
  • Bazı kullanım alanları, iş akışıdır. Örneğin, bir URL'yi almak ve bir kullanıcıya göstermek için az önce günlüğe kaydetmiş oldukları veri girişini kullanabilir.

Health Connect'te geçirilen süre

Health Connect'e yazılan tüm veriler alt bölge ofset bilgilerini belirtmelidir. Alt bölge uzaklığını belirtmek, uygulamaların verileri medeni saat. Sivil zaman, yerel ve kullanıcı için alakalı olan zamandır ancak Eşgüdümlü Evrensel Zaman'da (UTC) olması gerekmez.

Nadir durumlarda, alt bölge farkı kullanılamayabilir. Ne zaman Health Connect, Android 14 (API Düzeyi 34) sürümünde alt bölge uzaklığını cihazın varsayılan saat dilimi. Android 13 ve önceki sürümlerde (API Düzeyi 33 ve altı) Health Connect'e, mümkün olduğunda kaçınılması gereken alt bölge ofset bilgilerini belirtme.

Saat ve saat dilimi ayarı

Verileri yazarken bölge uzaklığı bilgilerini belirtme, saat dilimini belirtir bilgileri kontrol eder. Ancak bu işlem gerçekleştirilemeyebilir belirli durumlarda (ör. alt bölge ofsetinin sağlanmadığı durumlarda) Uygulamanız her iki veri türünü de makul bir şekilde idare etmeye anlamanıza yardımcı olur.

İzinler

Herhangi bir izin istemeden önce uygulamanızın manifest dosyasında beyan etmesi gerekir tıklayın. Veri türlerinin tam eşlemesi ve daha fazlası için aşağıdaki tablolara bakın izin verir.

1.0.0-alpha10 ve sonraki sürümler için

Sınıf türünü kaydet İzin beyanını okuma ve yazma
ActiveCaloriesBurned android.permission.health.READ_ACTIVE_CALORIES_YAKLAŞIK
. android.permission.health.WRITE_ACTIVE_CALORIES_YAKLAŞIK
BasalVücut Sıcaklığı android.permission.health_READ_BASAL_BODY_TEMPERATURE
. android.permission.health.YAZI_BASIKLIK_GÖVDESİ_TEMPERATURE
BasalMetabolizma Oranı android.permission.health_READ_BASAL_METABOLIC_RATE
. android.permission.health.YAZI_BASAL_METABOLIC_RATE
Kan Glikoz android.permission.health.READ_BLOOD_GLUCOSE
. android.permission.health.WRITE_BLOOD_GLUCOSE
Tan Basıncı android.permission.health.READ_BLOOD_PRESSURE
. android.permission.health.WRITE_BLOOD_PRESSURE
BodyFat android.permission.health.READ_BODY_FAT
. android.permission.health.YAZI_GÖVDE
Vücut Sıcaklığı android.permission.health.READ_BODY_TEMPERATURE
. android.permission.health.YAZI_GÖVDESİ_TEMPERATURE
BodyWaterMass android.permission.health.READ_BODY_WATER_MASS
. android.permission.health.YAZI_GÖVDE
Kemik Kitlesi android.permission.health.READ_BONE_MASS
. android.permission.health.YAZMA_BONE_MASS
Servik Mukus android.permission.health
. android.permission.health.WRITE_CERVical_MUCUS
BisikletPedalingCadence android.permission.health.READ_EXERCISE
. android.permission.health.YAZMA
Mesafe android.permission.health READ_DISTANCE
. android.permission.health.WRITE_DISTANCE
Elde Edilen Yükselti android.permission.health READ_ELEVATION_GAINED
. android.permission.health.WRITE_ELEVATION_GAINED
EgzersizOturumu android.permission.health.READ_EXERCISE
. android.permission.health.YAZMA
Tırmanılan Kat android.permission.health_READ_FLOORS_CLIMBED
. android.permission.health.WRITE_FLOORS_CLIMBED
Nabız android.permission.health_READ_HEART_RATE
. android.permission.health.YANLIŞ_HEART_RATE
Kalp HızıDeğişkenlikRmssd android.permission.health_READ_HEART_RATE_VARIABILITY
. android.permission.health.WRITE_HEART_RATE_VARIABILITY
Yükseklik android.permission.health READ_HEIGHT
. android.permission.health.YAZI_YÜKSEKLİK
Hidrasyon android.permission.health.READ_HYDRATION
. android.permission.health.WRITE_HYDRATION
Intermenstrual Kanama android.permission.health_READ_INTERMENSTRUAL_BLEEDING
. android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING
Yalın Vücut Kitlesi android.permission.health.READ_LEAN_BODY_MASS
. android.permission.health.YAZI_YALN_GÖVDE
MenstruationFlow android.permission.health READ_MENSTRUATION
. android.permission.health.WRITE_MENSTRUATION
menstrüasyon dönemi android.permission.health READ_MENSTRUATION
. android.permission.health.WRITE_MENSTRUATION
Beslenme android.permission.health.READ_NUTRITION
. android.permission.health.YAZI_NUTRITION
Ovülasyon Testi android.permission.health.READ_OVULATION_TEST
. android.permission.health.WRITE_OVULATION_TEST
Oksijen Doygunluğu android.permission.health READ_OXYGEN_SATURATION
. android.permission.health.YAZI_OXYGEN_SATURATION
Güç android.permission.health READ_POWER
. android.permission.health.WRITE_POWER
Solunum Hızı android.permission.health READ_RESPIRATORY_RATE
. android.permission.health.WRITE_RESPIRATORY_RATE
RestingHeartRate android.permission.health_READ_RESING_HEART_RATE
. android.permission.health.WRITE_RESting_HEART_RATE
Cinsel Aktivite android.permission.health_READ_SEXUAL_ACTIVITY
. android.permission.health.WRITE_SEXUAL_ACTIVITY
Uyku Oturumu android.permission.health.READ_SLEEP
. android.permission.health.YAZI_UYKU
Hız android.permission.health READ_SPEED
. android.permission.health.WRITE_SPEED
StepsCadence android.permission.health.READ_STEPS
. android.permission.health.WRITE_STEPS
Adımlar android.permission.health.READ_STEPS
. android.permission.health.WRITE_STEPS
TotalCaloriesBurned android.permission.health READ_TOTAL_CALORIES_YAKLAŞIK
. android.permission.health.WRITE_TOTAL_CALORIES_YAKLAŞIK
Vo2Max android.permission.health READ_VO2_MAX
. android.permission.health.WRITE_VO2_MAX
Kilo android.permission.health_READ_WEIGHT
. android.permission.health.YAZI_AĞIR
Tekerlekli Sandalye İtmeli android.permission.health_READ_WHEELCHAIR_PUSHES
. android.permission.health.WRITE_WHEELCHAIR_PUSHES

1.0.0-alpha09 ve önceki sürümler için

Sınıf türünü kaydet İzin beyanını okuma ve yazma
ActiveCaloriesBurned androidx.health.permission.ActiveCaloriesBurned.READ
. androidx.health.permission.ActiveCaloriesBurned.YAZ
BasalVücut Sıcaklığı androidx.health.permission.BasalBodyTemperature.READ
. androidx.health.permission.BasalBodyTemperature.YAZ
BasalMetabolizma Oranı androidx.health.permission.BasalMetabolicRate.READ
. androidx.health.permission.BasalMetabolicRate.YAZ
Kan Glikoz androidx.health.permission.KanGlikoz.READ
. androidx.health.permission.KanGlikoz.YAZ
Tan Basıncı androidx.health.permission.BloodPressure.READ
. androidx.health.permission.Blood Pressure.YAZ
BodyFat androidx.health.permission.BodyFat.READ
. androidx.health.permission.BodyFat.YAZ
Vücut Sıcaklığı androidx.health.permission.BodyTemperature.READ
. androidx.health.permission.BodyTemperature.YAZ
BodyWaterMass androidx.health.permission.BodyWaterMass.READ
. androidx.health.permission.BodyWaterMass.YAZ
Kemik Kitlesi androidx.health.permission.BoneMass.READ
. androidx.health.permission.KemikMass.YAZ
Servik Mukus androidx.health.permission.ServicalMucus.READ
. androidx.health.permission.ServicalMucus.YAZ
BisikletPedalingCadence androidx.health.permission.BisikletlePedalingCadence.READ
. androidx.health.permission.Bisiklet Patikası.YAZ
Mesafe androidx.health.permission.Length.READ
. androidx.health.permission.Length.YAZ
Elde Edilen Yükselti androidx.health.permission.ElevationGetedildi.READ
. androidx.health.permission.ElevationGained.YAZ
EgzersizOturumu androidx.health.permission.ExerciseSession.READ
. androidx.health.permission.ExerciseSession.YAZ
Tırmanılan Kat androidx.health.permission.FloorsClimbed.READ
. androidx.health.permission.FloorsClimbed.YAZ
Nabız androidx.health.permission.HeartRate.READ
. androidx.health.permission.HeartRate.YAZ
Kalp HızıDeğişkenlikRmssd androidx.health.permission.HeartRateVariabilityRmssd.READ
. androidx.health.permission.HeartRateVariabilityRmssd.YAZ
Yükseklik androidx.health.permission.Height.READ
. androidx.health.permission.Height.YAZ
Hidrasyon androidx.health.permission.Hydration.READ
. androidx.health.permission.Hydration.YAZ
Intermenstrual Kanama androidx.health.permission.IntermenstrualBleeding.READ
. androidx.health.permission.IntermenstrualBleeding.YAZ
Yalın Vücut Kitlesi androidx.health.permission.LeanBodyMass.READ
. androidx.health.permission.YalınBodyMass.YAZ
MenstruationFlow androidx.health.permission.MenstruationFlow.READ
. androidx.health.permission.MenstruationFlow.YAZ
Beslenme androidx.health.permission.Beslenme.Oku
. androidx.health.permission.Nutrition.YAZ
Ovülasyon Testi androidx.health.permission.OvulationTest.READ
. androidx.health.permission.OvulationTest.YAZ
Oksijen Doygunluğu androidx.health.permission.OxygenSaturation.READ
. androidx.health.permission.OxygenSaturation.YAZ
Güç androidx.health.permission.Power.READ
. androidx.health.permission.Power.YAZ
Solunum Hızı androidx.health.permission.SolunumOranı.READ
. androidx.health.permission.SolunumOranı.YAZ
RestingHeartRate androidx.health.permission.RestingHeartRate.READ
. androidx.health.permission.RestingHeartRate.YAZ
Cinsel Aktivite androidx.health.permission.SexualActivity.READ
. androidx.health.permission.CinselEtkinlik.YAZMA
Uyku Oturumu androidx.health.permission.SleepSession.READ
. androidx.health.permission.SleepSession.YAZ
Hız androidx.health.permission.Speed.READ
. androidx.health.permission.Speed.YAZ
StepsCadence androidx.health.permission.StepsCadence.READ
. androidx.health.permission.StepsCadence.YAZ
Adımlar androidx.health.permission.Steps.READ
. androidx.health.permission.Steps.YAZ
TotalCaloriesBurned androidx.health.permission.TotalCaloriesBurned.READ
. androidx.health.permission.TotalCaloriesBurned.YAZ
Vo2Max androidx.health.permission.Vo2Max.READ
. androidx.health.permission.Vo2Max.YAZ
Kilo androidx.health.permission.Ağırlık.OK
. androidx.health.permission.Ağırlık.YAZ
Tekerlekli Sandalye İtmeli androidx.health.permission.Tekerlekli Sandalye İtme.READ
. androidx.health.permission.Tekerlekli SandalyeTaklamaları.YAZ

Veri türlerinizi ve izinlerinizi inceleyin

Artık veri türlerinizi ve izinlerinizi planladığınıza göre, geliştirme sırasında da gösterilir.

Uygulamanızı Play Store'a yüklemeden önce incelerken iki kez kontrol edin. Uygulamanızın gerektirdiği veri türlerinin ve izinlerin listesi. Bu şekilde şunları yapabilirsiniz: Uygulamanızın veri kullanımını doğru şekilde beyan etmeniz.

Uygulamanızı Play Store'da yayınlamaya hazırlanırken uygulamanızın sunduğu Health Connect veri türlerine erişimi beyan etmeniz belirler. Aksi takdirde, kullanıcılara uygulamanızın özel gereksinimler gerektirdiğinden Health Connect veri türlerine erişilemiyor onaylayabilirsiniz.