Bu sayfada, Health Connect API'nin ana işlevleri açıklanmaktadır.
Kayıt ve veri senkronizasyonunda CRUD işlemleri
Platform, kayıtlı 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ştirici 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şiklikleri günlüğü oluşturur.
Temel toplama işlevleri
İstemciler, temel veriler üzerinde bir 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 nabız).
- Toplam (örneğin, günlük aralıkta toplam adım sayısı).
- Temel ölçümlerin sayısının basit bir sayımı (ör. 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ünkü aktivite oturumlarının toplam süresi).
Kullanılabilirlik kontrolleri
Health Connect, Android SDK 28 (Pie) ve sonraki sürümlerle uyumludur. SDK, istemci uygulamalarının Health Connect API'nin kullanıcının Android cihazında olup olmadığını belirlemesine olanak tanır. Aksi takdirde Health Connect, kullanıcının cihazının uyumlu olup olmadığını belirlemek için bir kullanılabilirlik kontrolü tetikler.
İzin kontrolleri
Health Connect, kullanıcının sağlık ve fitness verilerini uygulama bazında okumak ve yazmak için izin almanızı zorunlu kılar. Ayrıca, kullanıcı tarafından hangi izinlerin verildiğini veya reddedildiğini görmenize olanak tanır.
Health Connect ile okuma
Ön planda okuma
Normalde uygulamanız ön plandayken Health Connect'teki verileri okuyabilirsiniz. Bu gibi durumlarda, kullanıcı veya sistem bir okuma işlemi sırasında uygulamanızı arka plana yerleştirirse bu işlemi çalıştırmak için bir ön plan hizmeti kullanmayı düşünebilirsiniz.
Uygulamanızda bir okumayı görüntüleme gibi uygulamanızın kesinti beklediği durumlarda doğrudan Health Connect'ten istemci uygulamanıza veri okuyun.
Uygulamanızın kesintisiz olarak çalışmasını tercih ettiğiniz durumlarda ön plan hizmeti kullanın:
FOREGROUND_SERVICE_TYPE_HEALTH: Kullanıcı uygulamayı arka plana aldığında bile veri toplamaya devam eden bir egzersiz uygulaması gibi, uygulamanın sensör verileri toplamak için ön planda kalmasına izin verir.FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: Kullanıcı uygulamayı tamamlanmadan önce arka plana yerleştirse bile uygulamanın üç dakikadan kısa süren görevler için kritik verileri toplamaya devam etmesine olanak tanıyan genel türde bir hizmettir.
Arka planda okuma
Uygulamanızın arka planda çalışmasını ve Health Connect'ten veri okumasını isteyebilirsiniz. Arka Planda Okuma iznini talep ederseniz kullanıcınız, uygulamanıza arka planda veri okuma izni verebilir.