Bu sayfada, Health Connect API'nin temel işlevleri açıklanmaktadır.
Kayıt ve veri senkronizasyonu üzerinde CRUD işlemleri
Platform, kaydedilen veriler için standart ekleme, güncelleme ve silme işlevleri sağlar. Health Connect, istemci uygulamalarının Health Connect dışındaki verileri senkronize etmesine olanak tanıyan işlevler de içerir. Bu işlem, geliştiriciye ve kullanıcıya belirli veri türlerinin diğer uygulamalar tarafından eklenip eklenmediğini veya silinip silinmediğini gösteren bir veri değişikliği günlüğü oluşturur.
Temel toplama işlevleri
İstemciler, temel verilere toplama işlevi uygulayarak aşağıdakileri sağlayabilir:
- Ortalama, minimum veya maksimum değerler (örneğin, bir aktivite oturumu sırasındaki minimum ve maksimum kalp atış hızı).
- Toplam (örneğin, günlük aralıkta toplam adım sayısı).
- Temel ölçümlerin sayısının basit bir şekilde sayılmasıdır (örneğin, belirli bir haftadaki etkinlik oturumlarının sayısı).
- Desteklenen veri türlerinde toplam süre (örneğin, bu hafta derin uykuda geçirilen süre veya bugün yapılan aktivite oturumlarının toplam süresi).
Kullanılabilirlik kontrolleri
Health Connect, Android SDK sürümü 28 (Pie) ve sonraki sürümlerle uyumludur. SDK, istemci uygulamalarının Health Connect API'sinin kullanıcının Android destekli cihazında etkin olup olmadığını belirlemesine olanak tanır. Değilse Health Connect, kullanıcının cihazının uyumlu olup olmadığını belirlemek için bir uygunluk kontrolü başlatır.
İzin kontrolleri
Health Connect, kullanıcının sağlık ve fitness verilerini uygulama bazında okuma ve yazma izni istemenizi gerektirir. Ayrıca, kullanıcı tarafından verilmiş veya reddedilmiş izinleri de görebilirsiniz.
Health Connect ile okuma
Ön planda okuma
Uygulamanız ön plandayken Health Connect'teki verileri normalde okuyabilirsiniz. Bu gibi durumlarda, kullanıcı veya sistem okuma işlemi sırasında uygulamanızı arka plana yerleştirirse bu işlemi çalıştırmak için ön plan hizmeti kullanmayı düşünebilirsiniz.
Uygulamanızın kesintiye uğramayı bekleyebileceği durumlarda (ör. uygulamanızda okuma işlemi görüntüleme) doğrudan Health Connect'ten istemci uygulamanıza okuma yapın.
Uygulamanızın kesintisiz çalışmasını tercih ettiğiniz durumlarda ön plan hizmeti kullanın:
FOREGROUND_SERVICE_TYPE_HEALTH: Uygulamanın, sensör verilerini toplamak için ön planda kalmasına izin verir. Örneğin, kullanıcı uygulamayı arka plana aldığında bile veri toplamaya devam eden bir egzersiz uygulaması.FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: Uygulamanın, kullanıcı uygulamayı tamamlanmadan önce arka plana yerleştirse bile üç dakikadan kısa süren görevler için kritik verileri toplamaya devam etmesini sağlayan genel türde bir hizmettir.
Arka planda okuma
Uygulamanızın arka planda çalışmasını ve Health Connect'teki verileri okumasını isteyebilirsiniz. Background Read (Arka Planda Okuma) izni isterseniz kullanıcınız, uygulamanıza arka planda veri okuma erişimi verebilir.