إنشاء عميل 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) })
   }