Oturumlar, kullanıcıların yaptıkları tüm ana etkinliklerin listesini hızlı ve kolay bir şekilde görmelerinin bir yoludur. Bunlar Google Fit uygulama günlük sayfasında görüntülenir. Örneğin nefes egzersizi, yürüyüş, koşu veya gece uykusu, birer oturum örneğidir.
Oturumlar, bir etkinlik sırasında toplanan belirli bir döneme ait veri kümelerini gruplandırır. Örneğin, bir kullanıcı 3 km'lik koşuyu bitirip bitirdiğinde izlerse bir oturum oluşturulabilir ve bu zaman dilimindeki tüm fitness verileri (adımlar, hız, mesafe gibi) o oturumla ilişkilendirilir.
Oturumların kendisi etkinlikle ilgili ayrıntılar içermez. Bu veri kümesindedir. Oturumlar şu özelliklere sahiptir:
- Açıklayıcı, dostça bir ad (ör. "Sabah koşma")
- Bir açıklama
- Benzersiz tanımlayıcı
- Yakaladığı etkinliğin türü (ör. koşu)
Oturumları kullanmanın avantajları
- Kullanıcılar için yararlıdır: Oturumlar, etkinlik verilerini ve antrenmanları kullanıcılar için anlamlı bir şekilde düzenlemenize yardımcı olur. O gün için tüm aktivitelerini Google Fit uygulamasındaki Günlük sayfasında görebilirler.
- Tutarlı kullanıcı deneyimi: Uygulamanız veya tamamlayıcı cihazınız etkinlik izlemeye izin veriyorsa (kullanıcıların bir etkinliği başlatıp durdurabildikleri) bu antrenmanlar için oturumlara sahip olmak, kullanıcıların etkinliklerini her iki uygulamada da görmelerini sağlar.
- Daha kapsamlı veriler: Google Fit, oturum bilgilerinizi desteklemek ve zenginleştirmek için birden çok kaynaktan gelen verileri de birleştirir. Bu, kullanıcılara etkinlikleri hakkında daha kapsamlı bilgiler sağlar.
- Google Fit platformundan yararlanın: Kullanıcılarınız aktivitelerini izlemiyorsa veya uygulamanız izlemeyi desteklemiyorsa oturumları Google Fit'te okuyabilirsiniz. Fitness mağazasından ayrıntılı ya da birleştirilmiş verileri sorgulayabilir ve kendi şemanızı ve depolama alanınızı uygulamanıza gerek olmadan kullanılabilir oturumları bulabilirsiniz.
- Daha fazla kullanıcı etkileşimi: Kullanılabilir oturumları ve bu oturumları oluşturan uygulamaları kullanıcılarınıza gösterebilirsiniz. Diğer fitness uygulamalarıyla bu şekilde etkileşimde bulunmak kullanıcı etkileşiminizi artırabilir.
Oturumlar için kullanıcı yetkilendirmesi alma
Oturumları okumak veya yazmak istiyorsanız uygulamanızın ilgili kullanıcının iznini alması gerekir. Oturumlara erişim, veri türleriyle aynı yetkilendirme kapsamlarını kullanır ve bunları aşağıdaki şekilde istemeniz gerekir:
Android
FitnessOptions tarafından sağlanan uygun yöntemleri kullanarak uygulamanızın hangi oturum türüne erişmesi gerektiğini belirtin.
Örneğin, koşuyla ilgili oturumları okumak için şunları seçebilirsiniz:
val fitnessOptions = FitnessOptions.builder()
.accessActivitySessions(FitnessOptions.ACCESS_READ)
.addDataType(DataType.TYPE_HEART_RATE_BPM, FitnessOptions.ACCESS_READ)
.addDataType(DataType.TYPE_SPEED, FitnessOptions.ACCESS_READ)
.addDataType(DataType.TYPE_LOCATION_SAMPLE, FitnessOptions.ACCESS_READ)
.build()
Bu örnek, uygulamanızın etkinlik oturumu meta verilerine erişmek istediğini ve ayrıca bu oturumlarda okumak istediği veri türlerini belirtir. Bu örnekte nabız, hız ve konum verisi türleri kullanılır.
REST
Kapsamları aşağıdaki şekilde isteyin:
- Uyku etkinliği türleri bulunan oturumlar:
https://www.googleapis.com/auth/fitness.sleep.read
https://www.googleapis.com/auth/fitness.sleep.write
-
- Diğer tüm oturumlar:
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
-
Oturumları kullanma
Android
- Gerçek zamanlı olarak oturum oluşturun
- Fitness merkezine oturum ekleme
- Antrenmanlar sırasında duraklatmaları desteklemek için etkinlik segmentleri ekleme
- İlişkili oturum ve veri kümelerini okuma
- Oluşturduğu oturumla ilgili bilgileri göstermek için başka bir uygulama başlatın.
- Başka bir uygulama oturum başlattığında intent alma
REST
- Gerçek zamanlı olarak oturum oluşturun
- Fitness merkezine oturum ekleme
- Antrenmanlar sırasında duraklatmaları desteklemek için etkinlik segmentleri ekleme
- İlişkili oturum ve veri kümelerini okuma
Veri kümeleri ve segmentler oturumlarla nasıl etkileşimde bulunur?
Google Fit'te:
- Veri kümesi, belirli bir dönem boyunca belirli bir veri kaynağındaki veri noktalarını gösterir. Veri kümeleri kendi başına eklenebilir. Ancak bir oturum oluşturuyorsanız oturumu ve veri kümelerini birlikte oluşturmak daha kolay olabilir.
- Segment, bir oturumdaki veri kümelerini kullanıcının oturumda tam olarak yaptığı etkinliğe göre gruplandırır. Örneğin, kullanıcı 30 dakikalık bir koşuyu (oturum) izliyor, ancak bu süre boyunca kısa bir süre yürüdüyse bu durum segmentlere ayrılabilir. Koşu için bir segment, yürüyüş aralığı, sonra tekrar koşu.
Şekil 1, A, B ve C uygulamalarının bazı veri kümeleri ve oturumlar eklediği fitness mağazasında bir zaman aralığını göstermektedir:
- A Uygulaması, A1 ve A2 veri kümelerini Oturum 1 ve A3 ile birlikte oturumlardan bağımsız olarak ekledi.
- B Uygulaması, B1 ve B2 veri kümelerini Oturum 2 ile birlikte ekledi.
- C Uygulaması, veri kümesi C1'i tüm oturumlardan bağımsız olarak ekledi.
Fitness mağazasından oturum verilerini okurken, bir oturumun zaman aralığına denk gelen tüm fitness verileri, oturumu oluşturduktan sonra ekleseniz veya veriler pasif olarak izlendikten sonra oturum oluştursanız bile otomatik olarak bu oturumla ilişkilendirilir. Örneğin, 1. Oturumdaki fitness verileri için yapılan sorgu şu sonucu verir:
- Veri Kümesi A1
- Veri Kümesi A2
- Veri kümesinin A3'ün t1 ile t2 arasındaki kısmı
- Veri kümesi C1'in t1 ile t2 arasında bölümü
Her oturumu ve veri kümesini hangi uygulamanın eklediğini öğrenebilirsiniz.
Oturum oluşturma
Oturumlar birkaç farklı şekilde oluşturulabilir:
- Uygulamanız şu platformlarda etkin bir şekilde oturum oluşturabilir:
- Kullanıcı bir cihazdaki etkinliği yalnızca gerçek zamanlı olarak izlediğinde (yalnızca Android) veya
- manuel olarak ekleyerek.
- Kullanıcı Google Fit uygulamasına manuel olarak antrenman veya aktivite eklediğinde.
Oturum ne zaman oluşturulur?
Uyku verisi ekliyor musunuz?
- Evet - Bir oturum oluşturun ve bu antrenmanı spor salonuna manuel olarak ekleyin. Örneğin, bir uyku oturumu ekleyebilirsiniz. Bunun nedeni, uyku izleme uygulamaları veya cihazları olan kullanıcıların uyku etkinliklerini başlatmak ve durdurmak için cihazlarla etkileşime girmemesi (bu, pasif bir şekilde izlenir).
- Hayır: Uygulamanız kullanıcıların etkinlikleri başlatmasına ve durdurmasına izin veriyor mu?
- Hayır: Oturum oluşturmayın. Yalnızca uygulamanızdan veri kümeleri ekleyin.
- Evet - Android API ile kullanıcılar etkinliklerini izliyorsa gerçek zamanlı veya manuel olarak bir oturum oluşturun. REST API ile bir oturum oluşturun ve bu antrenmanı spor salonuna manuel olarak ekleyin.
- Uygulamanız, kullanıcıların ne zaman daha ayrıntılı (örneğin, yürüyüş ve koşu) farklı etkinlikler yaptığını belirleyebilir mi?
- Evet - Segment ekleyin.
- Hayır: Yalnızca veri kümeleri ekleyin. Segmentleri şimdilik yoksayın ve Google Fit'in bunları pasif olarak oluşturmasına izin verin.
Oturumlar okunuyor
Uygulamanız, oturumları birkaç şekilde okuyabilir:
- Belirli bir oturumun oluşturulduğu/eklendiği oturumu arayın
- Ad veya
- Kimlik
- Döneme göre oluşturduğu/eklendiği tüm oturumları arar
- Döneme göre tüm uygulamalar (Google Fit dahil) tarafından oluşturulan kullanılabilir tüm oturumları arayın
Hangi kaynakların bir oturum oluşturduğunu öğrenme
Kullanıcılarınıza, oturumlarının her birini hangi uygulamanın veya cihazın oluşturduğunu gösterebilirsiniz. Her oturumda, verileri toplayan veya dönüştüren uygulama ya da cihaz hakkında bilgilerin bulunduğu ilişkili bir veri kaynağı bulunur.
Android
Şu anda yalnızca bir Android istemcisi tarafından yazılan oturumların paket adını alabilirsiniz. Oturum oluşturan uygulamanın paket adını almak için
getAppPackageName yöntemini kullanın. Başka hangi uygulamaların fitness seansları eklediğini göstermek için uygulamanızda bu bilgileri kullanabilirsiniz. Kullanıcıların bunları tanımlamalarına yardımcı olmak için bu uygulamaların her birinin simgesini gösterebilirsiniz.
Ayrıca, oluşturdukları oturumların ayrıntılarını göstermek üzere diğer uygulamaları başlatmak için bir niyeti tetikleyebilirsiniz. Diğer uygulamalar da uygulamanızı kullanıma sunma niyetini ortaya çıkarabilir.
Oturum oluşturan kaynağı bulma hakkında daha fazla bilgi edinin.
REST
Oturumları oluşturan Android uygulamasının paket adını almak için
session.application özelliğini kullanın. REST API kullanılarak oluşturulan oturumlar için bunun yerine
session.name özelliğini kullanın. Başka hangi uygulamaların fitness oturumu eklediğini göstermek için uygulamanızda bu bilgileri kullanabilirsiniz. Kullanıcıların bu uygulamaları tanımalarına yardımcı olmak için bu uygulamaların her birinin simgesini gösterebilirsiniz.
Oturum oluşturan kaynağı bulma hakkında daha fazla bilgi edinin.