Oturum

Oturumlar, kullanıcıların tüm temel oturumların listesini hızlı ve kolay bir şekilde görmelerini ve aktivitelerini ifade eder. 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ı
  • Yakaladığı aktivitenin türü (ör. koşu)

Oturumları kullanmanın avantajları

  • Kullanıcılar için faydalı: Oturumlar, aktivite verilerini ve antrenmanları daha anlamlı bir hale geldi. Gün içindeki tüm aktivitelerini Google Fit uygulamasındaki günlük sayfası.
  • 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 durdurduğunu Bu antrenmanlar, kullanıcıların her iki uygulamadaki aktivitelerini de görmesini sağlar.
  • Daha eksiksiz veriler: Google Fit ayrıca kaynaklar ve kaynaklar bulabilirsiniz. Bu, kullanıcılara daha kapsamlı bir görünüm elde edebilir.
  • 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 kendi şemanızı uygulamanıza gerek kalmadan mevcut oturumları 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 kullanıcının izni gerekir. Oturumlara erişim aynı yetkilendirme kapsamlarını kullanır Aşağıdaki gibi istemeniz gerekir:

Android

Uygulamanızın ne tür oturumlara erişmesi gerektiğini yöntemler (FitnessOptions). Ö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

İstek kapsamları şu şekildedir:

  • 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:

  • Veri kümesi, belirli bir kampanyadaki veri noktalarını belirli bir dönemdeki veri kaynağı Veri kümeleri, sahip olmalıdır. 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, emin olun. Koşu için ayrı bir segment, ardından yürüyüş molası ve ardından tekrar çalıştırın.
ziyaret edin.
Şekil 1: Farklı uygulamalar, oturumları ve veri kümelerini [fitness mağazasına] ekler.

Ş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ı, A1 ve A2 veri kümelerini tüm oturumlardan bağımsız olarak Oturum 1 ve A3 ile birlikte ekledi.
  • B uygulaması, B1 ve B2 veri kümelerini 2. oturumla birlikte ekledi.
  • C uygulaması, C1 veri kümesini hiçbir oturumdan bağımsız olarak ekledi.

Fitness mağazasındaki oturum verileri okunurken, hesaba katılan tüm fitness verileri belirli bir zaman aralığı içinde otomatik olarak oturumu oluşturduktan sonra verileri eklemiş veya daha iyi bir sohbet için oturumundan hemen sonra oturum açmanıza yardımcı olur. Ö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ı
  • Veri kümesi C1'in t1 ile t2 arasında kalan kısmı

Her bir oturumu ve veri kümesini hangi uygulamanın eklediğini öğrenebilirsiniz.

Oturum oluşturma

Oturumlar birkaç farklı şekilde oluşturulabilir:

  • Uygulamanız, şu iki platformda etkin olarak oturum oluşturabilir:
    • Kullanıcı bir cihazdaki etkinliği aktif olarak izlediğinde gerçek zamanlı olarak (yalnızca Android) veya
    • manuel olarak ekleyerek kullanabilirsiniz.
  • Kullanıcı Google Fit uygulamasına manuel olarak bir antrenman veya aktivite eklediğinde.

Ne zaman oturum oluşturmalısınız?

Uyku verileri ekliyor musunuz?

  • Evet - Bir oturum oluşturun ve bunu fitness mağazasına manuel olarak ekleyin. Örneğin, bir uyku oturumu 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 arayın.
    • 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. İsterseniz her gün görüntülenen bunların her biri uygulamaları da vardır.

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şlatma niyetini tetikler.

oturum açın.

REST

Oturumları oluşturan Android uygulamasının paket adını almak için session.application mülkündeki her mülk. 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 gerekir.

oturum açın.