สร้างไคลเอ็นต์ฟิตเนส API

ตัวอย่างนี้แสดงวิธีสร้างไคลเอ็นต์ Fitness API

หมายเหตุ: ในตัวอย่างนี้ ระบบจะอ่านเฉพาะขั้นตอนรวมเท่านั้น จึงไม่มีสิทธิ์ Android จำเป็น

สร้างไคลเอ็นต์ 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) })
   }