เพิ่มเส้นทางออกกำลังกาย

เส้นทางการออกกำลังกายช่วยให้ผู้ใช้ติดตามเส้นทาง GPS สำหรับการออกกำลังกายที่เกี่ยวข้อง กิจกรรมและแชร์แผนที่การออกกำลังกายกับแอปอื่นๆ

คู่มือนี้สรุปวิธีที่แอปได้รับสิทธิ์ให้เขียนข้อมูลเส้นทางเป็นส่วนหนึ่งของ เซสชันการออกกำลังกาย

สรุปสั้นๆ เกี่ยวกับฟังก์ชันการอ่านและเขียนสำหรับเส้นทางการออกกำลังกายมีดังนี้

  1. แอปจะสร้างสิทธิ์การเขียนใหม่สำหรับเส้นทางออกกำลังกาย
  2. การแทรกเซสชันเกิดขึ้นโดยการเขียนเซสชันการออกกำลังกายที่มีเส้นทางเป็นสนาม
  3. การอ่าน:
    1. สำหรับเจ้าของเซสชัน จะมีการเข้าถึงข้อมูลโดยใช้การอ่านเซสชัน
    2. จากแอปของบุคคลที่สาม ผ่านกล่องโต้ตอบที่อนุญาตให้ผู้ใช้ให้สิทธิ์ อ่านเส้นทางแบบครั้งเดียว

สิทธิ์

เส้นทางออกกำลังกายมีสิทธิ์เขียนรันไทม์ของตัวเอง (android.permission.health.WRITE_EXERCISE_ROUTE)

หากต้องการเพิ่มความสามารถเกี่ยวกับเส้นทางการออกกำลังกายลงในแอป ให้เริ่มด้วยการขอให้เขียน สิทธิ์สำหรับข้อมูลบางประเภทโดยเฉพาะ

คำขอสิทธิ์ของ Android 14

คำขอสิทธิ์ของ Android 14

คำขอสิทธิ์ของ Android 13

คำขอสิทธิ์ของ Android 13

คุณต้องประกาศสิทธิ์การออกกำลังกายด้วย เนื่องจากแต่ละเส้นทางเชื่อมโยงกัน ด้วยเซสชันการออกกำลังกาย (1 เซสชัน = 1 เซสชัน)

คุณต้องประกาศสิทธิ์ต่อไปนี้เพื่อให้เขียนเส้นทางการออกกำลังกายได้

<application>
  <uses-permission
android:name="android.permission.health.WRITE_EXERCISE_ROUTE" />
  <uses-permission
android:name="android.permission.health.WRITE_EXERCISE" />
...
</application>

หากต้องการอ่านเส้นทางการออกกำลังกาย คุณต้องขอสิทธิ์ต่อไปนี้

<application>
  <uses-permission
android:name="android.permission.health.READ_EXERCISE_ROUTES" />
  <uses-permission
android:name="android.permission.health.READ_EXERCISE" />
...
</application>

หากต้องการขอสิทธิ์ ให้ใช้ PermissionController.createRequestPermissionResultContract() วิธีเมื่อคุณ ก่อนอื่นให้เชื่อมต่อแอปกับ Health Connect มีสิทธิ์หลายอย่างที่คุณอาจ คำขอ คือ:

  • อ่านข้อมูลสุขภาพ รวมถึงข้อมูลเส้นทาง: HealthPermission.getReadPermission(ExerciseSessionRecord::class)
  • เขียนข้อมูลสุขภาพ รวมถึงข้อมูลเส้นทาง: HealthPermission.getWritePermission(ExerciseSessionRecord::class)
  • เขียนข้อมูลเส้นทางการออกกำลังกาย: HealthPermission.PERMISSION_WRITE_EXERCISE_ROUTE

อ่านและเขียนข้อมูลเส้นทาง

แอปจะแทรกเส้นทางโดยเขียนเซสชันที่มีเส้นทางเป็นช่อง

หากผู้ใช้ไม่มีสิทธิ์เขียนและระบบไม่ได้ตั้งค่าเส้นทางไว้ เส้นทางนั้น ไม่อัปเดต

หากแอปมีสิทธิ์เขียนเส้นทางและพยายามอัปเดตเซสชันภายในวันที่ ที่ผ่านในออบเจ็กต์เซสชันโดยไม่มีเส้นทาง เส้นทางที่มีอยู่เดิมจะถูกลบ

เมื่อใดก็ตามที่แอปของคุณต้องการอ่านข้อมูลเส้นทางที่แอปของบุคคลที่สามให้ไว้ จะปรากฏขึ้นเพื่อขอให้ผู้ใช้อนุญาตการดำเนินการอ่าน

ขอเส้นทางจากเซสชัน

วิธีอ่านเซสชันใน Health Connect และขอเส้นทาง เซสชัน:

suspend fun readExerciseSessionAndRoute() {
    val grantedPermissions =
        healthConnectClient.permissionController.getGrantedPermissions()
    if (!grantedPermissions.contains(
          HealthPermission.getReadPermission(ExerciseSessionRecord::class))) {
        // The user doesn't allow the app to read exercise session data.
        return
    }

    val readResponse =
      healthConnectClient.readRecords(
        ReadRecordsRequest(
          ExerciseSessionRecord::class,
          TimeRangeFilter.between(startTime, endTime)
        )
      )
    val exerciseRecord = readResponse.records.first()

    // See https://developer.android.com/training/basics/intents/result#launch
    // for appropriately handling ActivityResultContract.
    val requestExerciseRouteLauncher = fragment.registerForActivityResul
    (ExerciseRouteRequestContract()) { exerciseRoute: ExerciseRoute? ->
            if (exerciseRoute != null) {
                displayExerciseRoute(exerciseRoute)
            } else {
                // Consent was denied
            }
        }

    val exerciseSessionRecord =
      healthConnectClient.readRecord(ExerciseSessionRecord::class, recordId).record

    when (val exerciseRouteResult = exerciseSessionRecord.exerciseRouteResult) {
        is ExerciseRouteResult.Data ->
            displayExerciseRoute(exerciseRouteResult.exerciseRoute)
        is ExerciseRouteResult.ConsentRequired ->
            requestExerciseRouteLauncher.launch(recordId)
        is ExerciseRouteResult.NoData -> Unit // No exercise route to show
        else -> Unit
    }
  }

  fun displayExerciseRoute(route: ExerciseRoute?) {
    val locations = route.route.orEmpty()
    for (location in locations) {
      // Handle location.
    }
  }

เขียนเส้นทางจากเซสชัน

โค้ดต่อไปนี้แสดงวิธีบันทึกเซสชันที่มี เส้นทางออกกำลังกาย:

suspend fun InsertExerciseRoute(healthConnectClient: HealthConnectClient) {
    val grantedPermissions =
        healthConnectClient.permissionController.getGrantedPermissions()
    if (!grantedPermissions.contains(
          getWritePermission(ExerciseSessionRecord::class))) {
        // The user doesn't allow the app to write exercise session data.
        return
    }

    val sessionStartTime = Instant.parse("2023-01-01T10:00:00.00Z")
    val sessionDuration = Duration.ofMinutes(20)

    val exerciseRoute =
      if (getPermissions.contains(PERMISSION_EXERCISE_ROUTE_WRITE) {
        ExerciseRoute(
          listOf(
            ExerciseRoute.Location(
              time = sessionStartTime
              latitude = 6.5483
              longitude = 0.5488
              horizontalAccuracy = Length.meters(2.0)
              verticalAccuracy = Length.meters(2.0),
              altitude = Length.meters(9.0)
            ),
            ExerciseRoute.Location(
              time = sessionStartTime.plus(sessionDuration)
              latitude = 6.4578
              longitude = 0.6577
              horizontalAccuracy = Length.meters(2.0)
              verticalAccuracy = Length.meters(2.0),
              altitude = Length.meters(9.2)
            )
          )
        )
      } else {
        // The user doesn't allow the app to write exercise route data.
        null
      }

    val exerciseSessionRecord =
        ExerciseSessionRecord(
            startTime = /* starting time in milliseconds */,
            startZoneOffset = ZoneOffset.UTC,
            endTime = sessionStartTime.plus(sessionDuration),
            endZoneOffset = ZoneOffset.UTC,
            exerciseType = ExerciseSessionRecord.EXERCISE_TYPE_BIKING,
            title = "Morning Bike Ride",
            exerciseRoute = exerciseRoute
        )

    healthConnectClient.insertRecords(listOf(exerciseSessionRecord))
}