Fitness API-Client erstellen

In diesem Beispiel wird gezeigt, wie ein Fitness API-Client erstellt wird.

Hinweis: In diesem Beispiel werden nur zusammengefasste Schritte gelesen. Es sind also keine Android-Berechtigungen erforderlich.

Erstellen Sie den API-Client wie folgt:

1. Erstellen Sie eine FitnessOptions-Instanz und deklarieren Sie dabei die Datentypen und den Zugriffstyp (Lesen und/oder Schreiben), den Ihre Anwendung benötigt:

   Tipp:Wählen Sie Datentypen verantwortungsvoll aus. Fordere nicht jeden Datentyp an, für den Fall, dass deine Anwendung ihn benötigt. Die angegebenen Typen bestimmen, für welche Bereiche der Nutzer eine Berechtigung erteilen kann. Fragen Sie nur nach den Datentypen, die Ihre Anwendung benötigt, damit Nutzer mit größerer Wahrscheinlichkeit Zugriff gewähren können. Nutzer gewähren leichter Zugriff auf begrenzte, klar beschriebene Bereiche.

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

2. Rufen Sie eine Instanz des Account-Objekts ab, um es mit der API zu verwenden:

   val account = GoogleSignIn.getAccountForExtension(this, fitnessOptions)
   

3. Prüfen Sie, ob der Nutzer zuvor den erforderlichen Datenzugriff gewährt hat. Falls nicht, initiieren Sie den Autorisierungsvorgang:

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

4. Wenn der Autorisierungsvorgang erforderlich ist, verarbeiten Sie die Antwort des Nutzers:

   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. Nachdem der Nutzer den Zugriff auf die angeforderten Daten autorisiert hat, erstellst du je nach Zweck und Anforderungen deiner App einen Fitness-Client (z. B. ein HistoryClient zum Lesen und/oder Schreiben historischer Fitnessdaten):

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