Oturumlar, kullanıcıların yaptıkları tüm temel etkinliklerin listesini hızlı ve kolay bir şekilde görmelerini sağlar. Bunlar Google Fit uygulaması günlük sayfasında görünür. Örneğin, bir nefes egzersizi, yürüyüş, koşu veya gece uykusu gibi farklı egzersizler bazı örnekler verir.
Oturumlar, belirli bir zaman aralığında toplanan veri kümelerini gruplandırır. bir etkinliktir. Örneğin, bir kullanıcı 3 km koşmaya başlayıp bitirdiğini oturum açıldıktan sonra oturum açılabilir. Bu oturumdaki tüm fitness verileri süre (ör. adımlar, hız, mesafe) bu oturumla ilişkilendirilir.
Oturumlarda etkinlikle ilgili ayrıntılar yer almaz. Bu, veri kümesiyle eşleştirilir. Oturumlar şu özelliklere sahiptir:
- Açıklayıcı, cana yakın bir ad (örneğin, "sabah koşusu")
- Bir açıklama
- Benzersiz tanımlayıcı
- Kaydettiği etkinlik türü (ör. koşu)
Oturumları kullanmanın avantajları
- Kullanıcılar için faydalıdır: Oturumlar, etkinlik verilerini ve antrenmanları kullanıcılar için anlamlı bir şekilde düzenlemenize yardımcı olur. Kullanıcılar, Google Fit uygulamasındaki Günlük sayfasında gün içindeki tüm aktivitelerini görebilir.
- Tutarlı kullanıcı deneyimi: Uygulamanız veya tamamlayıcı cihazınız etkinliğe izin veriyorsa nerede ve ne zaman etkinlik başlatabildiğini, hangi işlemleri yaptığını ve etkinlikleri nasıl Bu antrenmanlar, kullanıcıların her iki uygulamadaki aktivitelerini de görmesini sağlar.
- Daha eksiksiz veriler: Google Fit ayrıca kaynaklarda oturum açın. Bu sayede kullanıcılar etkinlikleri hakkında daha kapsamlı bir görünüm elde eder.
- Google Fit platformundan yararlanma: Kullanıcılarınız aktivitelerini izlemiyorsa veya uygulamanız izlemeyi desteklemiyorsa Google Fit'te oturumları okumaya devam edebilirsiniz. Fitness mağazasından ayrıntılı veya birleştirilmiş verileri sorgulayabilir ve ve mevcut oturumlarda daha kolay ulaşabilmeniz, kendi şemanızı ve depolama alanına sahip olursunuz.
- Artan kullanıcı etkileşimi: Kullanıcılarınıza mevcut oturumları ve onları oluşturan uygulamalar. Diğer fitness uygulamalarıyla bu şekilde etkileşimde bulunduğunuzda kullanıcı etkileşiminizi artırın.
Oturumlar için kullanıcı yetkilendirmesi alma
Oturumları okumak veya yazmak istiyorsanız uygulamanızın kullanıcıdan izin alması gerekir. Oturumlara erişim, veri türleriyle aynı yetkilendirme kapsamlarını kullanır. Bu kapsamları aşağıdaki şekilde istemeniz gerekir:
Android
Uygulamanızın ne tür oturumlara erişmesi gerektiğini
yöntemleri FitnessOptions
adresinden öğrenebilirsiniz.
Ö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 belirtir. ve bu oturumlarda okumak istediği veri türlerini de belirtir. "the" Bu örnekte nabız, hız ve konum verisi türleri kullanılmıştır.
REST
Aşağıdaki istek kapsamları:
- Uyku etkinliği türleri içeren 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
Oturumlar API'sini kullanarak:
- Oturumları gerçek zamanlı olarak oluşturun
- Fitness Store'daki seansları ekleyin
- Antrenmanlar sırasında duraklamaları desteklemek için aktivite segmentleri ekleyin
- İlişkili oldukları oturumları ve veri kümelerini okuma
- Oluşturduğu oturumla ilgili bilgileri görmek için başka bir uygulamayı başlatma
- Başka bir uygulama oturum başlattığında intent alma
REST
Oturumlar API'sini kullanarak:
- Oturumları gerçek zamanlı olarak oluşturun
- Fitness Store'daki seansları ekleyin
- Antrenmanlar sırasında duraklamaları desteklemek için aktivite segmentleri ekleyin
- İlişkili oldukları oturumları ve veri kümelerini okuma
Veri kümeleri ve segmentler oturumlarla nasıl etkileşime girer?
Google Fit'te:
- dataset, belirli bir kampanyadaki veri noktalarını belirli bir dönemdeki veri kaynağı Veri kümeleri, sahip. Ancak bir oturum oluşturuyorsanız her zaman oturumu ve veri kümelerini bir araya getirir.
- Segment, bir oturumdaki veri kümelerini kullanıcının tam etkinliğine göre gruplandırır neler yaptığına bakalım. Örneğin, kullanıcı 30 dakikalık bir koşuyu izlerse ( ancak bu süre boyunca bir süre boyunca yürüyüş yapmış olsaydınız, segment'e göz atın. Koşu için ayrı bir segment, ardından yürüyüş molası ve ardından tekrar çalıştırın.

Şekil 1'de fitness mağazasında A, B ve C uygulamalarının eklendiği zaman aralığı gösterilmektedir bazı veri kümeleri ve oturumlar:
- A uygulaması, 1. Oturum ile birlikte A1 ve A2 veri kümelerini, A3'ü ise tüm oturumlardan bağımsız olarak ekledi.
- B uygulaması, 2. Oturum ile birlikte B1 ve B2 veri kümelerini ekledi.
- C uygulaması, herhangi bir oturumdan bağımsız olarak C1 veri kümesini ekledi.
Fitness mağazasından oturum verilerini okurken, oturum oluşturduktan sonra verileri ekleseniz veya veriler pasif olarak izlendikten sonra oturum oluştursanız bile, oturum zaman aralığına giren tüm fitness verileri otomatik olarak bu oturumla ilişkilendirilir. Örneğin, fitness ile ilgili bir sorgu 1. oturumdaki veriler şu sonucu döndürür:
- Veri Kümesi A1
- Veri Kümesi A2
- Veri kümesi A3'ün t1 ile t2 arasında kalan kısmı
- C1 veri kümesinin t1 ile t2 arasındaki kısmı
Her oturumu ve veri kümesini hangi uygulamanın eklediğini görebilirsiniz.
Oturum oluşturma
Oturumlar birkaç farklı şekilde oluşturulabilir:
- Uygulamanız aşağıdakilerden birinde etkin bir oturum oluşturabilir:
- Kullanıcı bir cihazdaki etkinliği aktif olarak izlediğinde gerçek zamanlı olarak (yalnızca Android) veya
- Manuel olarak takarak
- Kullanıcı Google Fit uygulamasına manuel olarak bir antrenman veya aktivite eklediğinde.
Ne zaman oturum oluşturmalısınız?
Uyku verisi ekliyor musunuz?
- Evet: Oturum oluşturun ve bunu fitness mağazasına manuel olarak ekleyin. Örneğin, uyku seansı ekleme. Bu Bunun nedeni, uyku izleme uygulamaları veya cihazlarına sahip kullanıcıların cihazlarla etkileşime geçmemesidir. uyku aktivitelerini başlatma ve durdurma (bu pasif olarak izlenir).
- Hayır: Uygulamanız kullanıcıların etkinlikleri başlatmasına ve durdurmasına izin veriyor mu?
- Hayır: Oturum oluşturmaz. Yalnızca uygulamanızdan veri kümeleri ekleyin.
- Evet - Android API ile kullanıcıların takip etmeleri durumunda gerçek zamanlı bir oturum oluşturun. veya manuel olarak gerçekleştirebilirsiniz. REST API ile bir oturum oluşturun ve bunu fitness mağazasına manuel olarak ekleyin.
- Uygulamanız, bir kullanıcının başka bir cihazda farklı etkinlikler yaptığını algılayabiliyor mu?
emin olmanız gerekir?
- Evet - Segment ekleyin.
- Hayır: Yalnızca veri kümeleri ekleyin. Yoksay segmentleri şimdilik oluşturabilir ve Google Fit'in bunları pasif olarak oluşturmasına izin verebilirsiniz.
Okuma seansları
Uygulamanız oturumları birkaç şekilde okuyabilir:
- Oluşturduğu/eklediği belirli bir oturumu bulun
- Ad veya
- Kimlik
- Oluşturulan/eklenen tüm oturumları zaman aralığına göre arayın
- Tüm uygulamalar (Google Fit dahil) tarafından oluşturulan mevcut oturumların tamamını döneme göre ara
Hangi kaynakların oturum oluşturduğunu öğrenin
Kullanıcılarınıza, oturumlarını hangi uygulama veya cihazın oluşturduğunu gösterebilirsiniz. Her biri oturum, uygulama veya uygulama hakkında bilgiler içeren ilişkilendirilmiş bir veri kaynağına sahipse dönüştüren bir cihaz kullanıyor.
Android
Şu anda yalnızca Android tarafından yazılan bir oturumun paket adını alabilirsiniz
gerekir. Oturum oluşturan uygulamanın paket adını almak için
getAppPackageName
yöntemini kullanabilirsiniz. Uygulamanızda bu bilgileri kullanarak
Diğer uygulamaların fitness antrenmanı eklediği kullanıcılar. Kullanıcıların bu uygulamaları tanımasına yardımcı olmak için bu uygulamaların her birinin simgesini gösterebilirsiniz.
Ayrıca, niyeti Oluşturdukları oturumların ayrıntılarını göstermek için diğer uygulamaları başlatabilir. Diğer uygulamalar da uygulamanızı başlatmaya yönelik bir istek gönderin.
Oturum oluşturan kaynağı bulma hakkında daha fazla bilgi edinin.
REST
Oturum oluşturan Android uygulamasının paket adını almak için session.application
mülkünü kullanın. Oturum açma adında
REST API ise bunun yerine session.name
özelliğini kullanın. Bunu kullanabilirsiniz
diğer hangi uygulamaların fitness eklediğinizi göstermek için uygulamanızdaki bilgiler
anlamına gelir. Kullanıcıların tanımalarına yardımcı olmak için bu uygulamaların her birinin simgesini gösterebilirsiniz
oluşturabilirsiniz.
Oturum oluşturan kaynağı bulma hakkında daha fazla bilgi edinin.