เส้นทางการออกกำลังกายช่วยให้ผู้ใช้ติดตามเส้นทาง GPS สำหรับการออกกำลังกายที่เกี่ยวข้อง กิจกรรมและแชร์แผนที่การออกกำลังกายกับแอปอื่นๆ
คู่มือนี้สรุปวิธีที่แอปได้รับสิทธิ์ให้เขียนข้อมูลเส้นทางเป็นส่วนหนึ่งของ เซสชันการออกกำลังกาย
สรุปสั้นๆ เกี่ยวกับฟังก์ชันการอ่านและเขียนสำหรับเส้นทางการออกกำลังกายมีดังนี้
- แอปจะสร้างสิทธิ์การเขียนใหม่สำหรับเส้นทางออกกำลังกาย
- การแทรกเซสชันเกิดขึ้นโดยการเขียนเซสชันการออกกำลังกายที่มีเส้นทางเป็นสนาม
- การอ่าน:
- สำหรับเจ้าของเซสชัน จะมีการเข้าถึงข้อมูลโดยใช้การอ่านเซสชัน
- จากแอปของบุคคลที่สาม ผ่านกล่องโต้ตอบที่อนุญาตให้ผู้ใช้ให้สิทธิ์ อ่านเส้นทางแบบครั้งเดียว
สิทธิ์
เส้นทางออกกำลังกายมีสิทธิ์เขียนรันไทม์ของตัวเอง
(android.permission.health.WRITE_EXERCISE_ROUTE
)
หากต้องการเพิ่มความสามารถเกี่ยวกับเส้นทางการออกกำลังกายลงในแอป ให้เริ่มด้วยการขอให้เขียน สิทธิ์สำหรับข้อมูลบางประเภทโดยเฉพาะ
คำขอสิทธิ์ของ Android 14
คำขอสิทธิ์ของ 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))
}