Oturum

Oturumlar, kullanıcıların yaptıkları tüm temel etkinliklerin listesini hızlı ve kolay bir şekilde görmelerinin bir yoludur. Google Fit uygulamasının günlük sayfasında görünür. Örneğin nefes alma seansı, yürüyüş, koşu veya gece uykusu birer oturuma örnektir.

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şu başlattığında ve koşuyu tamamladığında bunu izlerse bir oturum oluşturulabilir ve bu zaman aralığında yer alan tüm fitness verileri (adımlar, hız, mesafe gibi) o oturumla ilişkilendirilir.

Oturumlar, etkinlikle ilgili ayrıntıları içermez. Bu, veri kümesindedir. Oturumlar aşağıdaki özelliklere sahiptir:

  • Açıklayıcı, kolay bir ad (örneğin, "sabah koşusu")
  • Bir açıklama
  • Benzersiz tanımlayıcı
  • Yakaladığı etkinliğin türü (ör. koşu)

Oturumları kullanmanın avantajları

  • Kullanıcılar için faydalı: Oturumlar, aktivite verilerini ve antrenmanları kullanıcılar için anlamlı bir şekilde düzenlemenize yardımcı olur. Google Fit uygulamasının Günlük sayfasından gün içindeki tüm aktivitelerini görebilirler.
  • Tutarlı kullanıcı deneyimi: Uygulamanız veya tamamlayıcı cihazınız etkinlik izlemeye (kullanıcıların bir etkinlik başlatıp durdurabildiği) izin veriyorsa bu antrenmanlar için oturumlara katılmak, kullanıcıların etkinliklerini her iki uygulamada da görmesini sağlar.
  • Daha eksiksiz veriler: Google Fit, oturum bilgilerinizi desteklemek ve zenginleştirmek için birden fazla kaynaktan gelen verileri de birleştirir. Bu sayede kullanıcılar etkinlikleri hakkında daha kapsamlı bir fikir edinebilir.
  • Google Fit platformundan yararlanma: Kullanıcılarınız aktivitelerini takip etmiyorsa veya uygulamanız izlemeyi desteklemiyorsa oturumları Google Fit'te okumaya devam edebilirsiniz. Kendi şemanızı ve depolama alanınızı uygulamanıza gerek kalmadan, fitness mağazasında ayrıntılı veya birleştirilmiş verileri sorgulayabilir ve uygun oturumları bulabilirsiniz.
  • Daha yüksek kullanıcı etkileşimi: Kullanıcılarınıza mevcut oturumları ve bu oturumları oluşturan uygulamaları gösterebilirsiniz. Diğer fitness uygulamalarıyla bu şekilde etkileşimde olmak kullanıcı etkileşimini artırabilir.

Oturumlar için kullanıcı yetkilendirmesi alma

Oturumları okumak veya yazmak istiyorsanız uygulamanız kullanıcının iznini almalıdır. Oturumlara erişim, veri türleriyle aynı yetkilendirme kapsamlarını kullanır. Bunları aşağıdaki şekilde istemeniz gerekir:

Android

FitnessOptions'teki uygun yöntemleri kullanarak uygulamanızın ne tür bir oturuma 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 bu oturumlarda okumak istediği veri türlerini de belirtir. Bu örnekte nabız, hız ve konum verisi türleri kullanılmıştır.

REST

İstek kapsamları:

  • Uyku aktivitesi türlerinin olduğu oturum sayısı:
    • 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

Sessions API'yi kullanarak şunları yapabilirsiniz:

  • Oturumları gerçek zamanlı olarak oluşturun
  • Fitness mağazasında seans ekle
  • Antrenmanlar sırasında duraklatmaları desteklemek için aktivite segmentleri ekleyin
  • Oturumları ve bunlarla ilişkili veri kümelerini okuma
  • Başka bir uygulamayı başlatarak, o uygulamanın oluşturduğu bir oturumla ilgili bilgileri görme
  • Başka bir uygulama oturum başlattığında niyet alın

REST

Sessions API'yi kullanarak şunları yapabilirsiniz:

  • Oturumları gerçek zamanlı olarak oluşturun
  • Fitness mağazasında seans ekle
  • Antrenmanlar sırasında duraklatmaları desteklemek için aktivite segmentleri ekleyin
  • Oturumları ve bunlarla ilişkili 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ı kümesini temsil eder. Veri kümeleri ise kendi kendilerine 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 gerçekleştirdiği tam etkinliğe göre gruplandırır. Örneğin, kullanıcı 30 dakikalık bir koşuyu (oturum) izliyor ancak bu esnada kısa bir süre yürüdüyse bunu segmentlere ayırabilirsiniz. Koşu, ardından yürüyüş arası ve ardından tekrar koşu için bir segment olur.
Şekil 1: Farklı uygulamalar, [fitness store]'a oturumlar ve veri kümeleri ekler.

Şekil 1'de, fitness mağazasında A, B ve C uygulamalarının bazı veri kümeleri ve oturumları eklediği bir zaman aralığı gösterilmektedir:

  • A uygulaması, A1 ve A2 veri kümelerini hiçbir oturumdan bağımsız olarak Oturum 1 ve A3 ile birlikte ekledi.
  • B uygulaması, 2. oturumla birlikte B1 ve B2 veri kümelerini ekledi.
  • C uygulaması, C1 veri kümesini hiçbir oturumdan bağımsız olarak ekledi.

Fitness mağazasında oturum verilerini okurken, bir oturumun zaman aralığına denk gelen tüm fitness verileri, oturumu oluşturduktan sonra ekleseniz veya veriler pasif olarak izledikten sonra bir oturum oluştursanız bile bu oturumla otomatik olarak ilişkilendirilir. Örneğin, Oturum 1'deki fitness verileri için yapılan bir sorgu şu sonucu döndürür:

  • Veri Kümesi A1
  • Veri Kümesi A2
  • A3 veri kümesinin t1 ile t2 arasındaki bölümü
  • C1 veri kümesinin t1 ile t2 arasındaki bölümü

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

Oturum oluşturma

Oturumlar birkaç farklı şekilde oluşturulabilir:

  • Uygulamanız etkin olarak aşağıdaki platformlardan birinde oturum oluşturabilir:
    • Kullanıcı bir cihazdaki etkinliği aktif olarak izlerken gerçek zamanlı olarak (yalnızca Android) veya
    • manuel olarak yerleştirerek değiştirebilirsiniz.
  • Bir kullanıcı Google Fit uygulamasına manuel olarak bir antrenman veya aktivite eklediğinde.

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

Uyku verilerini ekliyor musunuz?

  • Evet - Bir oturum oluşturun ve bunu fitness mağazasına manuel olarak ekleyin. Örneğin, uyku oturumu eklemek. Bunun nedeni, uyku izleme uygulamalarına veya cihazlarına sahip kullanıcıların uyku etkinliğini başlatmak ve durdurmak için cihazlarla etkileşim kurmamasıdır (bu bilgi pasif olarak takip edilir).
  • Hayır - Uygulamanız, kullanıcıların etkinlik başlatmasına ve durdurmasına izin veriyor mu?
    • Hayır - Oturum oluşturmayın. Yalnızca uygulamanızdan veri kümeleri ekleyin.
    • Evet - Kullanıcılar etkinliklerini takip ediyorsa Android API ile gerçek zamanlı olarak veya manuel olarak oturum oluşturun. REST API ile bir oturum oluşturun ve bunu fitness deposuna manuel olarak ekleyin.
    • Uygulamanız, kullanıcının yaptığı farklı etkinlikleri daha ayrıntılı düzeyde algılayabiliyor mu (örneğin, yürüyüş veya koşu)?
      • Evet - Segment ekle.
      • Hayır: Yalnızca veri kümelerini ekleyin. Şimdilik segmentleri yoksayın ve Google Fit'in bunları pasif bir şekilde oluşturmasına izin verin.

Okuma oturumları

Uygulamanız, oturumları birkaç şekilde okuyabilir:

  • Oluşturduğu/eklediği belirli bir oturumu arayın:
    • Ad veya
    • Kimlik
  • Oluşturduğu/eklediğiniz tüm oturumları döneme göre arayın
  • Tüm uygulamalar (Google Fit dahil) tarafından belirli bir zaman aralığında oluşturulmuş tüm oturumları bulun

Hangi kaynakların oturum oluşturduğunu öğrenin

Kullanıcılarınıza oturumlarının her birini hangi uygulama veya cihazın oluşturduğunu gösterebilirsiniz. Her oturumun, verileri toplayan veya dönüştüren uygulama ya da cihaz hakkında bilgiler içeren ilişkili bir veri kaynağı vardır.

Android

Şu anda yalnızca Android istemcisi tarafından yazılan bir oturumun paket adını alabilirsiniz. Oturum oluşturan uygulamanın paket adını almak için getAppPackageName yöntemini kullanın. Uygulamanızda bu bilgileri kullanarak kullanıcılara hangi uygulamaların fitness seanslarını eklediğini gösterebilirsiniz. Kullanıcıların uygulamaları tanımalarına yardımcı olmak için bu uygulamaların her birinin simgesini gösterebilirsiniz.

Ayrıca, kullanıcıların oluşturduğu oturumlarla ilgili ayrıntıları göstermek üzere diğer uygulamaları başlatma niyeti de tetikleyebilirsiniz. Diğer uygulamalar da uygulamanızı başlatma niyetini tetikleyebilir.

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. Uygulamanızda bu bilgileri kullanarak kullanıcılara hangi uygulamaların fitness oturumları eklediğini gösterebilirsiniz. Kullanıcıların 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.