Esta guía es compatible con la versión 1.1.0-rc01 de Health Connect.
Health Connect proporciona un tipo de datos de mindfulness para medir varios aspectos de la salud mental, como el estrés y la ansiedad. La atención plena es un tipo de dato que forma parte del bienestar general en Health Connect.
Disponibilidad de funciones
Para determinar si el dispositivo de un usuario admite registros de sesiones de atención plena en Health Connect, verifica la disponibilidad de FEATURE_MINDFULNESS_SESSION en el cliente:
if (healthConnectClient
.features
.getFeatureStatus(
HealthConnectFeatures.FEATURE_MINDFULNESS_SESSION
) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {
// Feature is available
} else {
// Feature isn't available
}
Consulta Cómo verificar la disponibilidad de las funciones para obtener más información.
Permisos necesarios
Al igual que con cualquier tipo de datos en Health Connect, el acceso a una sesión de atención plena está protegido por un par de permisos: READ_MINDFULNESS y WRITE_MINDFULNESS.
Cómo solicitar permisos al usuario
Después de crear una instancia de cliente, tu app debe solicitarle permisos al usuario. Los usuarios deben poder otorgar o rechazar permisos en cualquier momento.
Para hacerlo, crea un conjunto de permisos para los tipos de datos necesarios. Primero, asegúrate de que los permisos del conjunto se declaren en tu manifiesto de Android.
// Create a set of permissions for required data types
val PERMISSIONS =
setOf(
HealthPermission.getReadPermission(MindfulnessSessionRecord::class),
HealthPermission.getWritePermission(MindfulnessSessionRecord::class)
)
Usa getGrantedPermissions para ver si tu app ya tiene otorgados los permisos necesarios. De lo contrario, usa createRequestPermissionResultContract para solicitarlos. Se mostrará la pantalla de permisos de Health Connect.
// Create the permissions launcher
val requestPermissionActivityContract = PermissionController.createRequestPermissionResultContract()
val requestPermissions = registerForActivityResult(requestPermissionActivityContract) { granted ->
if (granted.containsAll(PERMISSIONS)) {
// Permissions successfully granted
} else {
// Lack of required permissions
}
}
suspend fun checkPermissionsAndRun(healthConnectClient: HealthConnectClient) {
val granted = healthConnectClient.permissionController.getGrantedPermissions()
if (granted.containsAll(PERMISSIONS)) {
// Permissions already granted; proceed with inserting or reading data
} else {
requestPermissions.launch(PERMISSIONS)
}
}
Como los usuarios pueden otorgar o revocar permisos en cualquier momento, tu app necesita verificar en forma periódica los permisos otorgados y controlar situaciones en las que el permiso se pierde.
Información que se incluye en un registro de sesión de mindfulness
Cada registro de sesión de atención plena captura cualquier tipo de sesión de atención plena que realice un usuario, por ejemplo, meditación, respiración y movimiento. El registro también puede incluir notas adicionales sobre la sesión.
Agregaciones admitidas
No hay agregaciones admitidas para este tipo de datos.
Ejemplo de uso
En el siguiente fragmento de código, se muestra cómo escribir una sesión de atención plena de meditación con la biblioteca de Jetpack:
if (healthConnectClient.features.getFeatureStatus(FEATURE_MINDFULNESS_SESSION) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {
healthConnectClient.insertRecords(listOf(MindfulnessSessionRecord(
startTime = Instant.now().minus(Duration.ofHours(1)),
startZoneOffset = ZoneOffset.UTC,
endTime = Instant.now(),
endZoneOffset = ZoneOffset.UTC,
mindfulnessSessionType = MindfulnessSessionRecord.MINDFULNESS_SESSION_TYPE_MEDITATION,
title = "Lake meditation",
notes = "Meditation by the lake",
metadata = Metadata.activelyRecorded(
clientRecordId = "myid",
clientRecordVersion = 0.0,
device = Device(type = Device.TYPE_PHONE)
),
)))
}