Verileri yazma

Bu kılavuz, Health Connect'te veri yazma veya güncelleme işlemlerini kapsar.

Veri yapısını ayarlayın

Verileri yazmadan önce kayıtları oluşturmamız gerekir. 50'den fazla veri için her biri kendi yapısına sahip. Veriler hakkında daha fazla ayrıntı için Jetpack referansına bakın kullanabilirsiniz.

Temel kayıtlar

Health Connect'teki Adımlar veri türü, en fazla 25 saat sürer. Adım sayıları, yaygın olarak kullanılan bir ölçümü temsil eder tüm platformlarda kullanılabilir.

Aşağıdaki örnekte adım sayısı verilerinin nasıl ayarlanacağı gösterilmektedir:

val stepsRecord = StepsRecord(
    count = 120,
    startTime = START_TIME,
    endTime = END_TIME,
    startZoneOffset = START_ZONE_OFFSET,
    endZoneOffset = END_ZONE_OFFSET
)

Ölçü birimleri içeren kayıtlar

Health Connect, ölçüm birimleriyle birlikte değerleri depolayabildiğinden emin olun. Geniş ve kapsamlı Beslenme veri türü, yönetmektir. Çok çeşitli isteğe bağlı besin alanları sunar. olduğunu tespit ettik. Her veri noktası, besin maddelerini temsil eder bir yemek veya gıda maddesinin parçası olarak tüketilmiş olabilecek içeriklerdir.

Bu veri türünde, tüm besin maddeleri Mass, energy ise Energy bir birimde temsil edilir.

Aşağıdaki örnekte, muz yedi:

val banana = NutritionRecord(
    name = "banana",
    energy = 105.0.kilocalories,
    dietaryFiber = 3.1.grams,
    potassium = 0.422.grams,
    totalCarbohydrate = 27.0.grams,
    totalFat = 0.4.grams,
    saturatedFat = 0.1.grams,
    sodium = 0.001.grams,
    sugar = 14.0.grams,
    vitaminB6 = 0.0005.grams,
    vitaminC = 0.0103.grams,
    startTime = START_TIME,
    endTime = END_TIME,
    startZoneOffset = START_ZONE_OFFSET,
    endZoneOffset = END_ZONE_OFFSET
)

Seri verileri içeren kayıtlar

Health Connect, seri verilerinin listesini depolayabilir. Bir örnek olarak Bir dizi sinyal örneğini yakalayan Nabız veri türü olduğunu tespit ettik.

Bu veri türünde, samples parametresi Nabız örnekleri. Her örnek bir beatsPerMinute içerir bir time değeri için daha uygun olacaktır.

Aşağıdaki örnekte, nabız serisi verilerinin nasıl ayarlanacağı gösterilmektedir:

val heartRateRecord = HeartRateRecord(
    startTime = START_TIME,
    startZoneOffset = START_ZONE_OFFSET,
    endTime = END_TIME,
    endZoneOffset = END_ZONE_OFFSET,
    // records 10 arbitrary data, to replace with actual data
    samples = List(10) { index ->
        HeartRateRecord.Sample(
            time = START_TIME + Duration.ofSeconds(index.toLong()),
            beatsPerMinute = 100 + index.toLong(),
        )
    }
)

Verileri yazma

Health Connect'te en sık kullanılan iş akışlarından biri veri yazmaktır. Kayıt eklemek için insertRecords kullanın.

Aşağıdaki örnekte, veri ekleyerek adım sayılarının nasıl yazılacağı gösterilmektedir:

suspend fun insertSteps(healthConnectClient: HealthConnectClient) {
    try {
        val stepsRecord = StepsRecord(
            count = 120,
            startTime = START_TIME,
            endTime = END_TIME,
            startZoneOffset = START_ZONE_OFFSET,
            endZoneOffset = END_ZONE_OFFSET
        )
        healthConnectClient.insertRecords(listOf(stepsRecord))
    } catch (e: Exception) {
        // Run error handling here
    }
}

Verileri güncelle

Bir veya daha fazla kaydı değiştirmeniz gerekiyorsa ve özellikle Uygulama veri deponuzu Health Connect'teki verilerle senkronize edebilirsiniz. verileriniz. Mevcut verileri güncellemenin iki yolu vardır: kayıtları bulmak için kullanılan tanımlayıcıdır.

Meta veri

Aşağıdaki durumlarda gerekli olduğundan ilk olarak Metadata sınıfını incelemeniz önerilir. verileri güncelleme. Health Connect'teki her Record, oluşturulduktan sonra bir metadata alanına giriş yapın. Aşağıdaki özellikler şunlarla alakalıdır: senkronizasyon:

Kayıt Kimliği aracılığıyla güncelleme

Verileri güncellemek için öncelikle gerekli kayıtları hazırlayın. kayıtlara geçirmeye karar verirsiniz. Ardından, updateRecords numaralı telefonu arayarak değişiklikler var.

Aşağıdaki örnekte verilerin nasıl güncelleneceği gösterilmektedir. Bu amaçla, her bir kayıt alt bölge ofset değerleri PST olarak ayarlanmıştır.

suspend fun updateSteps(
    healthConnectClient: HealthConnectClient,
    prevRecordStartTime: Instant,
    prevRecordEndTime: Instant
) {
    try {
        val request = healthConnectClient.readRecords(
            ReadRecordsRequest(
                recordType = StepsRecord::class,
                timeRangeFilter = TimeRangeFilter.between(
                    prevRecordStartTime,
                    prevRecordEndTime
                )
            )
        )

        val newStepsRecords = arrayListOf<StepsRecord>()
        for (record in request.records) {
            // Adjusted both offset values to reflect changes
            val sr = StepsRecord(
                count = record.count,
                startTime = record.startTime,
                startZoneOffset = record.startTime.atZone(ZoneId.of("PST")).offset,
                endTime = record.endTime,
                endZoneOffset = record.endTime.atZone(ZoneId.of("PST")).offset,
                metadata = record.metadata
            )
            newStepsRecords.add(sr)
        }

        client.updateRecords(newStepsRecords)
    } catch (e: Exception) {
        // Run error handling here
    }
}

İstemci Kaydı Kimliği aracılığıyla güncelleme

İsteğe bağlı İstemci Kaydı Kimliği ve İstemci Kaydı Sürümü değerlerini kullanıyorsanız updateRecords yerine insertRecords kullanılmasını öneririz.

insertRecords işlevi, verileri yükseltebilir. Veriler, Health Connect'te belirtilen İstemci Kaydı Kimliklerinin üzerine yazılır. Aksi takdirde, yeni veri olarak yazılır. Bu senaryo, kullandığınız kaynaktaki verileri senkronize etmeniz gerektiğinde uygulama veri deponuzu Health Connect'e bağlayabilirsiniz.

Aşağıdaki örnekte, uygulama veri deposunda:

suspend fun pullStepsFromDatastore() : ArrayList<StepsRecord> {
    val appStepsRecords = arrayListOf<StepsRecord>()
    // Pull data from app datastore
    // ...
    // Make changes to data if necessary
    // ...
    // Store data in appStepsRecords
    // ...
    var sr = StepsRecord(
        // Assign parameters for this record
        metadata = Metadata(
            clientRecordId = cid
        )
    )
    appStepsRecords.add(sr)
    // ...
    return appStepsRecords
}

suspend fun upsertSteps(
    healthConnectClient: HealthConnectClient,
    newStepsRecords: ArrayList<StepsRecord>
) {
    try {
        healthConnectClient.insertRecords(newStepsRecords)
    } catch (e: Exception) {
        // Run error handling here
    }
}

Bundan sonra, bu işlevleri ana iş parçacığınızda çağırabilirsiniz.

upsertSteps(healthConnectClient, pullStepsFromDatastore())

İstemci Kaydı Sürümünde değer kontrolü

Verileri yükseltme işleminizde İstemci Kaydı Sürümü, Durum Connect, clientRecordVersion'te karşılaştırma kontrolleri gerçekleştirir. değerler. Eklenen verilerdeki sürüm sürümünü seçerseniz güncelleme gerçekleşir. Aksi takdirde, değişikliği yoksayar ve değer aynı kalır.

Verilerinize sürüm oluşturmayı dahil etmek için Sürümünüze bağlı olarak Long değerine sahip Metadata.clientRecordVersion mantığıyla başlayalım.

val sr = StepsRecord(
    count = count,
    startTime = startTime,
    startZoneOffset = startZoneOffset,
    endTime = endTime,
    endZoneOffset = endZoneOffset,
    metadata = Metadata(
        clientRecordId = cid,
        clientRecordVersion = version
    )
)

Değişiklikler olduğunda version değeri otomatik olarak artmaz. verilerin beklenmedik bir şekilde üzerine yazılmasını önler. Bu nedenle, manuel olarak daha yüksek bir değer sağlar.

Veri yazmaya yönelik en iyi uygulamalar

Uygulamalar yalnızca kendi kaynaklı verileri Health Connect'e yazmalıdır.

Uygulamanızdaki veriler başka bir uygulamadan içe aktarıldıysa bu diğer uygulamada kullandığı için kendi verilerini Health Connect'e yazar.

Ayrıca, olabilir veya dahili bir sistem hatası olabilir. URL'lerinizi geri çekme ve yeniden deneme stratejilerini sürekli değerlendirmek üzere kullanır. Şu kullanıcıya yazıyorsanız: Health Connect sonuçta başarısız oldu. Uygulamanızın geçmiş deneyime geçtiğinden emin olun o kişi olabilir. Teşhise yardımcı olması için hataları günlüğe kaydetmeyi ve bildirmeyi unutmayın.

Verileri izlerken uygulayabileceğiniz birkaç öneri vardır: Bu değişiklikler, uygulamanızın veri yazma şekline göre değişiklik gösterir.

Pasif izleme

Pasif fitness veya sağlık takibi yapan uygulamalar da buna dahildir. Adımları veya nabzı arka planda sürekli olarak kaydetme.

Uygulamanızın Health Connect'e düzenli aralıklarla veri yazması gerekir. şu yöntemleri kullanabilirsiniz:

• Her senkronizasyonda, yalnızca şu tarihten sonra değiştirilen yeni verileri ve güncellenmiş verileri yaz: son senkronizasyonda.
• Yazma isteği başına en fazla 1.000 kayıt için yığın isteği gönderebilirsiniz.
• WorkManager sayesinde, düzenli aralıklarla arka plan görevlerini planlarken süre en az 15 dakika olmalıdır.

• Görevleri yalnızca cihaz boşta ve düşük moddayken çalışacak şekilde kısıtla pil.

  val constraints = Constraints.Builder()
      .requiresBatteryNotLow()
      .requiresDeviceIdle(true)
      .build()
  
  val writeDataWork = PeriodicWorkRequestBuilder<WriteDataToHealthConnectWorker>(
          15,
          TimeUnit.MINUTES,
          5,
          TimeUnit.MINUTES
      )
      .setConstraints(constraints)
      .build()
  

Etkin izleme

Buna egzersiz ve uyku gibi etkinliğe dayalı izleme yapan uygulamalar da dahildir. veya beslenme gibi manuel kullanıcı girişleri. Bu kayıtlar, uygulama Ön planda veya günde birkaç kez kullanıldığı nadir durumlarda.

Uygulamanızın, Health Connect'in tamamında çalışmaya devam etmediğinden emin olun. devam edebilir.

Veriler, Health Connect'e şu iki yöntemden biriyle yazılmalıdır:

• Etkinlik tamamlandıktan sonra verileri Health Connect ile senkronize edin. Örneğin, senkronize Kullanıcı, izlenen bir egzersiz oturumunu sonlandırdığında ortaya çıkan veriler.
• Verileri senkronize etmek için WorkManager aracını kullanarak tek seferlik bir görev planlayın daha sonra.

Yazma işlemlerinin ayrıntı düzeyi ve sıklığı için en iyi uygulamalar

Health Connect'e veri yazarken uygun çözünürlükleri kullanın. Her bir uygun çözünürlük, veri saklamaya devam ederken depolama alanı yükünün azaltılmasına yardımcı olur. tutarlı ve doğru verilerdir. Veri çözünürlüğü iki şeyi kapsar:

1. Yazma sıklığı: Uygulamanızın yeni verileri ne sıklıkta Health Connect. Örneğin, her 15 dakikada bir yeni veriler yazın.
2. Yazılı verilerin ayrıntı düzeyi: Verilerin aktarılma sıklığı örneklendirilir. Örneğin, 5 saniyede bir nabız örnekleri yazın. Her veri türü kullanılamaz için aynı örnek hızı gerekir. Adım sayısını güncellemenin çok az faydası vardır Her 60 saniyede bir veri içeren, daha seyrek aralıklarla saniye. Ancak, yüksek örnek hızları kullanıcılara daha ayrıntılı ve verilerini ayrıntılı bir şekilde inceleyebilir. Örnek hızı frekansları ayrıntılar ile performans arasında bir denge kurmalısınız.

Gün boyunca izlenen verileri yazın

Adımlar gibi sürekli olarak toplanan veriler için başvurunuz, gün içinde en az 15 dakikada bir Health Connect'e yazma.

Oturumları yaz

Veriler, antrenmanın veya uykunun sonunda Health Connect'e yazılmalıdır kabul edilir.

En iyi uygulama olarak, tüm uyku seansları veya egzersiz seansları kayıt cihazını ve uygun meta verileri RecordingMethod

Başvurunuz en azından, "beklenen" bölümünde belirtilen yönergeleri izlemelidir sütununu inceleyebilirsiniz. Konum “en iyi”yi yaratmanın rehberlik eder.

Egzersiz sırasında izlenen veriler

Uyku sırasında izlenen veriler