Sesi

Sesi adalah cara bagi pengguna untuk melihat daftar semua aktivitas utama yang mereka lakukan dengan cepat dan mudah. Aplikasi ini muncul di halaman jurnal aplikasi Google Fit. Misalnya, sesi pernapasan, jalan-jalan, berlari, atau tidur setiap malam adalah contoh dari suatu sesi.

Sesi mengelompokkan set data dari jangka waktu tertentu, yang dikumpulkan selama aktivitas. Misalnya, jika pengguna melacak kapan mereka memulai dan menyelesaikan lari sejauh 3 km, sesi dapat dibuat dan semua data kebugaran yang ada dalam jangka waktu tersebut (seperti langkah, kecepatan, jarak) akan dikaitkan dengan sesi tersebut.

Sesi itu sendiri tidak berisi detail tentang aktivitas. Hal ini terjadi di set data. Sesi memiliki properti berikut:

  • Nama yang deskriptif dan bersahabat (misalnya, "pagi berlari")
  • Deskripsi
  • ID unik
  • Jenis aktivitas yang ditangkap (misalnya, lari)

Manfaat menggunakan sesi

  • Berguna untuk pengguna: Sesi membantu Anda mengatur data aktivitas dan olahraga dengan cara yang berarti bagi pengguna. Mereka dapat melihat semua aktivitas mereka untuk hari itu di halaman Jurnal di aplikasi Google Fit.
  • Pengalaman pengguna yang konsisten: Jika aplikasi atau perangkat pendamping Anda mengizinkan pelacakan aktivitas (tempat pengguna dapat memulai dan menghentikan aktivitas), memiliki sesi untuk olahraga ini memungkinkan pengguna melihat aktivitas mereka di kedua aplikasi.
  • Data yang lebih lengkap: Google Fit juga menggabungkan data dari beberapa sumber untuk melengkapi dan memperkaya informasi sesi Anda. Dengan begitu, pengguna akan mendapatkan gambaran aktivitas yang lebih lengkap.
  • Memanfaatkan platform Google Fit: Jika pengguna tidak melacak aktivitasnya, atau aplikasi Anda tidak mendukung pemantauan, Anda masih dapat membaca sesi di Google Fit. Anda dapat membuat kueri data mendetail atau gabungan dari toko kebugaran dan menemukan sesi yang tersedia, tanpa perlu menerapkan skema dan penyimpanan Anda sendiri.
  • Peningkatan engagement pengguna: Anda dapat menunjukkan sesi yang tersedia dan aplikasi yang dibuat kepada pengguna. Berinteraksi dengan aplikasi kebugaran lain dengan cara ini dapat meningkatkan engagement pengguna Anda.

Mendapatkan otorisasi pengguna untuk sesi

Jika Anda ingin membaca atau menulis sesi, aplikasi Anda harus mendapatkan izin pengguna. Akses ke sesi menggunakan cakupan otorisasi yang sama dengan jenis data, yang harus Anda minta sebagai berikut:

Android

Tentukan jenis sesi yang perlu diakses aplikasi Anda menggunakan metode yang sesuai dari FitnessOptions. Misalnya, untuk membaca sesi yang berkaitan dengan berlari, Anda dapat memilih:

    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()

Contoh ini menetapkan bahwa aplikasi Anda ingin mengakses metadata sesi aktivitas, dan juga menetapkan jenis data yang ingin dibaca dalam sesi tersebut; detak jantung, kecepatan, dan jenis data lokasi digunakan dalam contoh ini.

REST

Cakupan permintaan sebagai berikut:

  • Sesi dengan jenis aktivitas tidur:
    • https://www.googleapis.com/auth/fitness.sleep.read
    • https://www.googleapis.com/auth/fitness.sleep.write
  • Semua sesi lainnya:
    • https://www.googleapis.com/auth/fitness.activity.read
    • https://www.googleapis.com/auth/fitness.activity.write

Menggunakan sesi

Android

Anda dapat menggunakan Sessions API untuk:

  • Buat sesi secara real time
  • Menyisipkan sesi di toko kebugaran
  • Masukkan segmen aktivitas untuk mendukung jeda selama latihan fisik
  • Membaca sesi dan set data yang terkait dengannya
  • Luncurkan aplikasi lain untuk menampilkan informasi tentang sesi yang dibuatnya
  • Menerima intent saat aplikasi lain memulai sesi

REST

Anda dapat menggunakan Sessions API untuk:

  • Buat sesi secara real time
  • Menyisipkan sesi di toko kebugaran
  • Masukkan segmen aktivitas untuk mendukung jeda selama latihan fisik
  • Membaca sesi dan set data yang terkait dengannya

Cara set data dan segmen berinteraksi dengan sesi

Di Google Fit:

  • Set data mewakili set titik data dari sumber data tertentu selama jangka waktu tertentu. Set data dapat dimasukkan sendiri. Namun, jika Anda membuat sesi, mungkin akan lebih mudah untuk membuat sesi dan set data bersama-sama.
  • Segmen mengelompokkan set data dalam satu sesi berdasarkan aktivitas persis yang dilakukan pengguna dalam sesi tersebut. Misalnya, jika pengguna melacak lari 30 menit (sesi) tetapi berjalan sebentar selama ini, ini dapat dibagi menjadi segmen. Akan ada segmen untuk berlari, lalu istirahat untuk berjalan, lalu lari lagi.
Gambar 1: Aplikasi yang berbeda menambahkan sesi dan set data ke [toko kebugaran].

Gambar 1 menunjukkan interval waktu di penyimpanan kebugaran saat aplikasi A, B, dan C telah menyisipkan beberapa set data dan sesi:

  • Aplikasi A menyisipkan set data A1 dan A2 bersama dengan Sesi 1, dan A3 secara terpisah dari sesi apa pun.
  • Aplikasi B menyisipkan set data B1 dan B2 bersama dengan Sesi 2.
  • Aplikasi C menyisipkan set data C1 secara terpisah dari sesi apa pun.

Saat membaca data sesi dari penyimpanan kebugaran, semua data kebugaran yang berada dalam interval waktu sesi secara otomatis dikaitkan dengan sesi tersebut, meskipun Anda menyisipkan data setelah membuat sesi, atau membuat sesi setelah data dilacak secara pasif. Misalnya, kueri untuk data kebugaran dari Sesi 1 akan menampilkan:

  • Set data A1
  • Set data A2
  • Bagian set data A3 antara t1 dan t2
  • Bagian set data C1 antara t1 dan t2

Anda dapat mengetahui aplikasi mana yang menyisipkan setiap sesi dan set data.

Membuat sesi

Sesi dapat dibuat dengan beberapa cara:

  • Aplikasi Anda dapat secara aktif membuat sesi di
    • dalam real time saat pengguna secara aktif melacak aktivitas di perangkat (khusus Android), atau
    • dengan menyisipkannya secara manual.
  • Saat pengguna menambahkan olahraga atau aktivitas secara manual di aplikasi Google Fit.

Kapan harus membuat sesi

Apakah Anda menambahkan data tidur?

  • Ya - Buat sesi dan sisipkan secara manual ke penyimpanan kebugaran. Misalnya, menyisipkan sesi tidur. Hal ini dikarenakan pengguna dengan aplikasi atau perangkat pelacakan tidur tidak akan berinteraksi dengan perangkat untuk memulai dan menghentikan aktivitas tidur mereka (ini dilacak secara pasif).
  • Tidak - Apakah aplikasi Anda memungkinkan pengguna memulai dan menghentikan aktivitas?
    • Tidak - Jangan buat sesi. Hanya tambahkan set data dari aplikasi Anda.
    • Ya - Dengan Android API, buat sesi secara real time jika pengguna melacak aktivitasnya, atau secara manual. Dengan REST API ini, buat sesi dan masukkan secara manual ke penyimpanan kebugaran.
    • Dapatkah aplikasi Anda mendeteksi saat pengguna melakukan aktivitas yang berbeda pada tingkat yang lebih mendetail (misalnya, berjalan vs berlari)?
      • Ya - Tambahkan segmen.
      • Tidak - Hanya tambahkan set data. Abaikan segmen untuk saat ini, dan biarkan Google Fit secara pasif membuatnya.

Sesi membaca

Aplikasi Anda dapat membaca sesi dengan beberapa cara:

  • Mencari sesi tertentu yang dibuat/disisipkan oleh
    • Nama atau
    • ID
  • Cari semua sesi yang dibuat/disisipkan, menurut jangka waktu
  • Mencari semua sesi yang tersedia yang dibuat oleh semua aplikasi (termasuk Google Fit) berdasarkan jangka waktu

Mempelajari sumber mana yang membuat sesi

Anda dapat menampilkan kepada pengguna aplikasi atau perangkat mana yang membuat setiap sesi mereka. Setiap sesi memiliki sumber data terkait, yang memiliki informasi tentang aplikasi atau perangkat yang mengumpulkan atau mengubah data.

Android

Saat ini Anda hanya bisa mendapatkan nama paket sesi yang ditulis oleh klien Android. Untuk mendapatkan nama paket aplikasi yang membuat sesi, gunakan metode getAppPackageName. Anda dapat menggunakan informasi ini di aplikasi untuk menunjukkan kepada pengguna aplikasi lain mana yang menyisipkan sesi kebugaran. Anda dapat menampilkan ikon untuk setiap aplikasi tersebut guna membantu pengguna mengidentifikasinya.

Anda juga dapat mengaktifkan intent untuk meluncurkan aplikasi lain guna menampilkan detail sesi yang mereka buat. Aplikasi lain juga dapat mengaktifkan intent untuk meluncurkan aplikasi Anda.

Pelajari lebih lanjut cara menemukan sumber yang membuat sesi.

REST

Untuk mendapatkan nama paket aplikasi Android yang membuat sesi, gunakan properti session.application. Untuk sesi yang dibuat menggunakan REST API, gunakan properti session.name. Anda dapat menggunakan informasi ini di aplikasi untuk menunjukkan kepada pengguna aplikasi lain yang menyisipkan sesi kebugaran. Anda dapat menampilkan ikon setiap aplikasi ini untuk membantu pengguna mengidentifikasinya.

Pelajari lebih lanjut cara menemukan sumber yang membuat sesi.