Fitness API-Client erstellen

In diesem Beispiel wird gezeigt, wie Sie einen Fitness API-Client erstellen.

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

Erstellen Sie den API-Client so:

1. Erstellen Sie eine FitnessOptions-Instanz und geben Sie die erforderlichen Datentypen und den Zugriffstyp (Lese- und/oder Schreibzugriff) für die Anwendung an:

   Tipp:Wählen Sie Datentypen verantwortungsvoll aus. Fordern Sie nicht jeden Datentyp an, der in Ihrer App benötigt wird. Die angegebenen Typen bestimmen, für welche Bereiche der Nutzer aufgefordert wird, eine Berechtigung zu gewähren. Fragen Sie nur nach den Datentypen, die Ihre Anwendung benötigt, damit Nutzer mit größerer Wahrscheinlichkeit Zugriff gewähren. Nutzer gewähren leichter eingeschränkten, klar beschriebenen Umfang.

   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 zur Verwendung mit der API ab:

   val account = GoogleSignIn.getAccountForExtension(this, fitnessOptions)
   

3. Prüfen Sie, ob der Nutzer zuvor den erforderlichen Datenzugriff gewährt hat, und starten Sie andernfalls 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 Autorisierungsablauf 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, erstellen Sie je nach Zweck und Anforderungen Ihrer App einen Fitnessclient (z. B. einen 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) })
   }