Oturum

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: 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ı, 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.