這個範例說明如何建立 Fitness API 用戶端。
按照下列方式建立 API 用戶端:
建立
FitnessOptions
執行個體,並宣告應用程式所需的資料類型和存取權類型 (讀取和/或寫入):val fitnessOptions = FitnessOptions.builder() .addDataType(DataType.TYPE_STEP_COUNT_DELTA, FitnessOptions.ACCESS_READ) .addDataType(DataType.AGGREGATE_STEP_COUNT_DELTA, FitnessOptions.ACCESS_READ) .build()
取得
Account
物件的執行個體,以便與 API 搭配使用:val account = GoogleSignIn.getAccountForExtension(this, fitnessOptions)
檢查使用者先前是否已授予必要的資料存取權,如未授予,請啟動授權流程:
if (!GoogleSignIn.hasPermissions(account, fitnessOptions)) { GoogleSignIn.requestPermissions( this, // your activity GOOGLE_FIT_PERMISSIONS_REQUEST_CODE, // e.g. 1 account, fitnessOptions) } else { accessGoogleFit() }
如果需要授權流程,請處理使用者的回應:
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 } } }
使用者授予要求的資料存取權後,請根據應用程式的用途和需求建立健身用戶端 (例如,用來讀取及/或寫入歷來健身資料的
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) }) }