Memulai di Android

Membuat Akun Google

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

Dapatkan layanan Google Play

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

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

Mendapatkan client ID OAuth 2.0

Untuk mengaktifkan Fitness API, dapatkan client ID OAuth 2.0.

Membuat dan mengonfigurasi project

Sebaiknya gunakan lingkungan pengembangan Android Studio untuk membuat aplikasi dengan Fitness API. Sebagai detail tentang cara membuat project baru dan mengonfigurasinya di Android Studio, lihat Buat 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.2.0")
        implementation("com.google.android.gms:play-services-auth:21.2.0")
}

apply plugin: 'com.android.application'

...

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

Hal ini memastikan Gradle akan otomatis mendownload SDK kebugaran saat SDK tersebut 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 cakupan otorisasi. Untuk bertanya untuk izin ini, Anda perlu menambahkan jenis data yang perlu diakses oleh aplikasi Anda di FitnessOptions instance Anda. Saat aplikasi meminta untuk menggunakan salah satu data Google Fit Android SDK otomatis memeriksa cakupan mana saja yang dimilikinya dan menanyakan pengguna untuk otorisasi atas cakupan tersebut.

Membuat klien API

Membuat klien API dan menambahkan jenis data yang perlu diakses oleh aplikasi Anda menulis atau membaca data. Tersedia endpoint berikut:

• SensorsClient: Mengakses berbagai sumber data kesehatan dan kebugaran dari sensor hardware di perangkat lokal dan di perangkat pendamping.
• RecordingClient: Untuk pengumpulan data sensor 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 jenis dan setelan data kustom di platform Google Fit.

Lihat contoh cara membuat klien Fitness API.

Alur otorisasi pengguna yang dihasilkan

Berikut ini adalah hasil alur otorisasi yang dialami pengguna saat mereka dimintai izin:

1. Izin Android: Pengguna melihat izin Android yang digunakan aplikasi Anda yang diminta sebelum mengunduhnya. Setelah diunduh, aplikasi meminta izin runtime apa pun yang diperlukan, dan pengguna memberikan atau menolak izin akses ini.
2. Periksa dan hubungkan: Aplikasi Anda memeriksa apakah izin telah diberikan sebelum meminta akses ke jenis data lain.
3. Permintaan cakupan OAuth: Google meminta pengguna untuk memberikan izin aplikasi Anda cakupan OAuth yang diperlukan untuk tipe data yang ingin diakses.
4. Akses diterapkan: Setelah pengguna memberikan izin, aplikasi Anda dapat mengakses jenis data yang termasuk dalam cakupan yang telah diberikan pengguna izin akses.