יצירת לקוח של כושר API

בדוגמה הזו ניתן לראות איך ליצור לקוח של Fitness API.

יוצרים את לקוח ה-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 לשימוש עם ה-API:

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