إنشاء عميل Fitness API

يوضِّح هذا المثال كيفية إنشاء عميل Fitness API.

ملاحظة: في هذا المثال، تتم قراءة الخطوات المجمّعة فقط، لذلك لا تتوفّر أذونات Android. مطلوبة.

أنشئ برنامج "عميل واجهة برمجة التطبيقات" على النحو التالي:

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