创建 Fitness API 客户端

此示例展示了如何创建 Fitness API 客户端。

注意 ：在此示例中，系统只会读取汇总步骤，因此没有 Android 权限 为必填项。

按如下方式创建 API 客户端：

1. 创建一个 FitnessOptions 实例，声明 应用的数据类型和访问类型（读取和/或写入） 需求：

   提示：负责任地选择数据类型。错误做法 请求所有数据类型，以防您的应用需要。指定的类型 确定提示用户授予哪些范围的权限。仅限 询问您的应用需要的数据类型，这样用户更有可能给予授权 访问权限。用户更乐意授予受限且描述清晰的访问权限 范围。

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

2. 获取要用于 API 的 Account 对象的实例：

   val account = GoogleSignIn.getAccountForExtension(this, fitnessOptions)
   

3. 检查用户之前是否授予了必要的数据访问权限，以及 ，启动授权流程：

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

4. 如果需要授权流程，请处理用户的响应：

   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. 在用户授权访问所请求数据后，创建健身项目 客户端（例如，用于读取和/或写入历史健身数据的 HistoryClient） 数据）：

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