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.