Membuat klien Kebugaran API

Contoh ini menunjukkan cara membuat klien Fitness API.

Catatan: Dalam contoh ini, hanya langkah gabungan yang dibaca, sehingga tidak ada izin Android wajib diisi.

Buat klien API seperti berikut:

1. Buat instance FitnessOptions, yang mendeklarasikan jenis data dan jenis akses (membaca dan/atau menulis) aplikasi Anda kebutuhan:

   Tips: Pilih jenis data secara bertanggung jawab. Larangan setiap jenis data jika aplikasi Anda mungkin membutuhkannya. Jenis yang ditentukan menentukan cakupan mana yang izinnya harus diberikan oleh pengguna. Hanya minta jenis data yang dibutuhkan aplikasi Anda sehingga pengguna cenderung memberikan akses. Pengguna lebih mudah memberikan akses ke akses terbatas, yang dideskripsikan dengan jelas cakupan.

   val fitnessOptions = FitnessOptions.builder()
       .addDataType(DataType.TYPE_STEP_COUNT_DELTA, FitnessOptions.ACCESS_READ)
       .addDataType(DataType.AGGREGATE_STEP_COUNT_DELTA, FitnessOptions.ACCESS_READ)
       .build()
   

2. Dapatkan instance objek Account untuk digunakan dengan API:

   val account = GoogleSignIn.getAccountForExtension(this, fitnessOptions)
   

3. Periksa apakah sebelumnya pengguna telah memberikan akses data yang diperlukan, dan apakah tidak, mulai alur otorisasi:

   if (!GoogleSignIn.hasPermissions(account, fitnessOptions)) {
       GoogleSignIn.requestPermissions(
           this, // your activity
           GOOGLE_FIT_PERMISSIONS_REQUEST_CODE, // e.g. 1
           account,
           fitnessOptions)
   } else {
       accessGoogleFit()
   }
   

4. Jika alur otorisasi diperlukan, tangani respons pengguna:

   override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
       super.onActivityResult(requestCode, resultCode, data)
       when (resultCode) {
           Activity.RESULT_OK -> when (requestCode) {
               GOOGLE_FIT_PERMISSIONS_REQUEST_CODE -> accessGoogleFit()
               else -> {
                   // Result wasn't from Google Fit
               }
           }
           else -> {
               // Permission not granted
           }
       }
   }
   

5. Setelah pengguna memiliki akses sah ke data yang diminta, buat kebugaran klien (misalnya, HistoryClient untuk membaca dan/atau menulis data kebugaran historis data) berdasarkan tujuan dan kebutuhan aplikasi Anda:

   private fun accessGoogleFit() {
       val end = LocalDateTime.now()
       val start = end.minusYears(1)
       val endSeconds = end.atZone(ZoneId.systemDefault()).toEpochSecond()
       val startSeconds = start.atZone(ZoneId.systemDefault()).toEpochSecond()
   
       val readRequest = DataReadRequest.Builder()
           .aggregate(DataType.AGGREGATE_STEP_COUNT_DELTA)
           .setTimeRange(startSeconds, endSeconds, TimeUnit.SECONDS)
           .bucketByTime(1, TimeUnit.DAYS)
           .build()
       val account = GoogleSignIn.getAccountForExtension(this, fitnessOptions)
       Fitness.getHistoryClient(this, account)
           .readData(readRequest)
           .addOnSuccessListener({ response ->
               // Use response data here
               Log.i(TAG, "OnSuccess()")
           })
           .addOnFailureListener({ e -> Log.d(TAG, "OnFailure()", e) })
   }