Dzięki trasom ćwiczeń użytkownicy mogą śledzić trasy GPS w przypadku powiązanych aktywności i udostępniać mapy treningów innym aplikacjom.
Ten przewodnik pokazuje, jak aplikacje otrzymują uprawnienia do zapisywania danych o trasie w ramach sesji ćwiczeń.
Oto krótkie podsumowanie funkcji odczytu i zapisu tras ćwiczeń:
- Aplikacje tworzą nowe uprawnienia do zapisu tras ćwiczeń.
- Polega ono na zapisaniu sesji ćwiczeń z trasą.
- Czytanie:
- Dostęp do danych u właściciela sesji odbywa się za pomocą odczytu sesji.
- z poziomu aplikacji innej firmy, w oknie, które pozwala użytkownikowi zezwolić na jednorazowy odczyt trasy.
Uprawnienia
Trasy ćwiczeń mają własne uprawnienia do zapisu w czasie działania (android.permission.health.WRITE_EXERCISE_ROUTE
).
Aby dodać do aplikacji możliwość trasy ćwiczeń, zacznij od wysłania prośby o uprawnienia do zapisu określonego typu danych.
Android 14 – prośba o przyznanie uprawnień
Android 13 – prośba o przyznanie uprawnień
Musisz też zadeklarować uprawnienie do ćwiczeń, ponieważ każda trasa jest powiązana z sesją ćwiczeń (1 sesja = 1 trening).
Oto uprawnienia, które musisz zadeklarować, aby móc zapisywać trasy ćwiczeń:
<application>
<uses-permission
android:name="android.permission.health.WRITE_EXERCISE_ROUTE" />
<uses-permission
android:name="android.permission.health.WRITE_EXERCISE" />
...
</application>
Aby odczytywać trasy ćwiczeń, musisz poprosić o te uprawnienia:
<application>
<uses-permission
android:name="android.permission.health.READ_EXERCISE_ROUTES" />
<uses-permission
android:name="android.permission.health.READ_EXERCISE" />
...
</application>
Aby poprosić o uprawnienia, użyj metody PermissionController.createRequestPermissionResultContract()
przy pierwszym połączeniu aplikacji z Health Connect. Możesz poprosić o takie uprawnienia:
- Odczyt danych o stanie, w tym danych tras:
HealthPermission.getReadPermission(ExerciseSessionRecord::class)
- Zapisz dane o stanie, w tym dane tras:
HealthPermission.getWritePermission(ExerciseSessionRecord::class)
- Zapisz dane trasy ćwiczeń:
HealthPermission.PERMISSION_WRITE_EXERCISE_ROUTE
Odczytywanie i zapisywanie danych tras
Aplikacje wstawiają trasę, wpisując sesję z trasą w polu.
Jeśli użytkownik nie ma uprawnień do zapisu, a trasa nie jest ustawiona, nie jest aktualizowana.
Jeśli aplikacja ma uprawnienia do zapisu tras i próbuje zaktualizować sesję przez przekazanie obiektu sesji bez trasy, istniejąca trasa zostanie usunięta.
Za każdym razem, gdy aplikacja musi odczytać dane trasy dostarczone przez aplikację innej firmy, wyświetli się okno z prośbą o zgodę na odczyt.
Wysyłanie prośby o trasę z sesji
Jak odczytywać dane z sesji w Health Connect i poprosić o trasę z niej:
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.
}
}
Zapisywanie trasy z sesji
Ten kod pokazuje, jak zarejestrować sesję, która zawiera trasę ćwiczeń:
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))
}