คำแนะนำนี้ใช้ได้กับ Health Connect เวอร์ชัน 1.1.0-alpha11
Health Connect มีประเภทข้อมูลสติสัมปชัญญะเพื่อวัดด้านต่างๆ ของสุขภาพจิต เช่น ความเครียดและความวิตกกังวล สติสัมปชัญญะเป็นประเภทข้อมูลซึ่งเป็นส่วนหนึ่งของความแข็งแรงสมบูรณ์โดยรวมใน Health Connect
สิทธิ์ที่จำเป็น
เช่นเดียวกับประเภทข้อมูลอื่นๆ ใน Health Connect การเข้าถึงเซสชันการทำสมาธิจะได้รับการปกป้องโดยสิทธิ์ 2 รายการ ได้แก่ READ_MINDFULNESS_SESSION
และ WRITE_MINDFULNESS_SESSION
ขอสิทธิ์จากผู้ใช้
หลังจากสร้างอินสแตนซ์ไคลเอ็นต์แล้ว แอปของคุณจะต้องขอสิทธิ์จากผู้ใช้ ผู้ใช้ต้องได้รับอนุญาตให้ให้หรือปฏิเสธสิทธิ์ได้ทุกเมื่อ
โดยสร้างชุดสิทธิ์สำหรับประเภทข้อมูลที่จำเป็น ตรวจสอบว่าได้ประกาศสิทธิ์ในชุดในไฟล์ Manifest ของ Android ก่อน
// Create a set of permissions for required data types
val PERMISSIONS =
setOf(
HealthPermission.getReadPermission(MindfulnessSessionRecord::class),
HealthPermission.getWritePermission(MindfulnessSessionRecord::class)
)
ใช้ getGrantedPermissions
เพื่อดูว่าแอปได้รับสิทธิ์ที่จําเป็นแล้วหรือยัง หากไม่มี ให้ใช้ createRequestPermissionResultContract
เพื่อขอสิทธิ์เหล่านั้น ซึ่งจะแสดงหน้าจอสิทธิ์ของ 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)
}
}
เนื่องจากผู้ใช้สามารถให้หรือเพิกถอนสิทธิ์ได้ทุกเมื่อ แอปของคุณจึงต้องตรวจสอบสิทธิ์ที่ได้รับเป็นระยะๆ และจัดการสถานการณ์ที่สิทธิ์หายไป
ข้อมูลที่รวมอยู่ในระเบียนเซสชันการเจริญสติ
ระเบียนเซสชันการเจริญสติแต่ละรายการจะบันทึกเซสชันการเจริญสติประเภทใดก็ได้ที่ผู้ใช้ทำ เช่น การทำสมาธิ การฝึกหายใจ และการเคลื่อนไหว บันทึกยังอาจมีหมายเหตุเพิ่มเติมเกี่ยวกับเซสชันด้วย
การรวมที่รองรับ
Health Connect ช่วยให้คุณดูค่ารวมต่อไปนี้สำหรับรายการ Delta หนึ่งๆ ได้
ตัวอย่างการใช้งาน
ข้อมูลโค้ดต่อไปนี้แสดงวิธีเขียนเซสชันการทำสมาธิโดยใช้คลัง 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)
),
)))
}