Memulai di Android

Membuat Akun Google

Untuk menggunakan Google Fit API, Anda memerlukan Akun Google. Anda dapat membuat akun baru atau menggunakan akun yang ada. Sebaiknya buat akun terpisah untuk menguji aplikasi Anda dari perspektif pengguna.

Dapatkan layanan Google Play

Dapatkan library klien terbaru untuk layanan Google Play di host pengembangan Anda:

1. Buka Android SDK Manager.
2. Di bagian SDK Tools, temukan Google Play services.
3. Jika status paket ini bukan Installed, pilih keduanya dan klik Install Packages.

Mendapatkan ID klien OAuth 2.0

Untuk mengaktifkan Fitness API, dapatkan ID klien OAuth 2.0.

Membuat dan mengonfigurasi project Anda

Sebaiknya gunakan lingkungan pengembangan Android Studio untuk membuat aplikasi dengan Fitness API. Untuk detail tentang cara membuat project baru dan mengonfigurasinya di Android Studio, lihat Membuat project.

Menambahkan library klien layanan Google Play

Di Android Studio, buka file build.gradle untuk modul Anda dan tambahkan library klien layanan Google Play sebagai dependensi:

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:21.4.0")
}

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:21.4.0'
}

Hal ini memastikan bahwa Gradle otomatis mendownload SDK kebugaran saat membangun aplikasi Anda.

Mendapatkan izin Android yang diperlukan

Untuk membaca dan menulis beberapa jenis data, aplikasi Anda perlu meminta izin Android.

Mendapatkan izin OAuth

Jenis data yang izin aksesnya dimiliki aplikasi Anda sesuai dengan cakupan otorisasi. Untuk meminta izin ini, Anda perlu menambahkan jenis data yang perlu diakses aplikasi Anda dalam instance FitnessOptions. Saat aplikasi Anda meminta untuk menggunakan jenis data Google Fit, Android SDK akan otomatis memeriksa cakupan yang terkait dengan jenis data tersebut dan meminta otorisasi pengguna untuk cakupan tersebut.

Membuat klien API

Buat klien API dan tambahkan jenis data yang perlu diakses aplikasi Anda untuk menulis atau membaca data. Endpoint berikut tersedia:

• SensorsClient: Akses berbagai sumber data kesehatan dan kebugaran dari sensor hardware di perangkat lokal dan di perangkat pendamping.
• RecordingClient: Untuk pengumpulan data sensor di latar belakang yang selalu aktif dan berdaya rendah.
• HistoryClient: Menyisipkan, menghapus, dan membaca data historis di Google Fit.
• SessionsClient: Membuat dan mengelola Sesi aktivitas pengguna.
• GoalsClient: Membaca sasaran Poin Jantung dan Langkah yang dibuat oleh pengguna di Google Fit.
• ConfigClient: Mengakses setelan dan jenis data kustom di platform Google Fit.

Lihat contoh cara membuat klien Fitness API.

Alur otorisasi pengguna yang dihasilkan

Berikut adalah alur otorisasi yang dialami pengguna saat mereka diminta izin:

1. Izin Android: Pengguna melihat izin Android yang telah diminta aplikasi Anda sebelum mendownloadnya. Setelah didownload, aplikasi Anda akan meminta izin runtime yang diperlukan, dan pengguna akan memberikan atau menolak izin ini.
2. Periksa dan hubungkan: Aplikasi Anda memeriksa apakah izin telah diberikan sebelum meminta akses ke jenis data lain.
3. Permintaan cakupan OAuth: Google akan meminta pengguna untuk memberikan cakupan OAuth yang diperlukan aplikasi Anda untuk mengakses jenis data yang diinginkannya.
4. Akses diterapkan: Setelah pengguna memberikan izin, aplikasi Anda dapat mengakses jenis data yang termasuk dalam cakupan yang telah diberi izin oleh pengguna.