إنشاء عميل Fitness API

يوضح هذا المثال كيفية إنشاء عميل Fitness 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. الحصول على نسخة افتراضية للعنصر 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) })
   }