คู่มือนี้ใช้ได้กับ Health Connect เวอร์ชัน 1.1.0-rc01
Health Connect มีประเภทข้อมูลการมีสติเพื่อวัดแง่มุมต่างๆ ของสุขภาพจิต เช่น ความเครียดและความกังวล การมีสติเป็นประเภทข้อมูล ที่เป็นส่วนหนึ่งของสุขภาพโดยรวมใน Health Connect
ความพร้อมใช้งานของฟีเจอร์
หากต้องการดูว่าอุปกรณ์ของผู้ใช้รองรับบันทึกเซสชันการฝึกสติใน Health Connect หรือไม่ ให้ตรวจสอบความพร้อมใช้งานของFEATURE_MINDFULNESS_SESSION
ในไคลเอ็นต์ ดังนี้
if (healthConnectClient
.features
.getFeatureStatus(
HealthConnectFeatures.FEATURE_MINDFULNESS_SESSION
) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {
// Feature is available
} else {
// Feature isn't available
}
ดูข้อมูลเพิ่มเติมได้ที่ตรวจสอบความพร้อมใช้งานของฟีเจอร์
สิทธิ์ที่จำเป็น
การเข้าถึงการทำสติจะได้รับการปกป้องโดยสิทธิ์ต่อไปนี้
android.permission.health.READ_MINDFULNESS
android.permission.health.WRITE_MINDFULNESS
หากต้องการเพิ่มความสามารถในการฝึกสติให้กับแอป ให้เริ่มด้วยการขอสิทธิ์เขียน
สำหรับประเภทข้อมูล MindfulnessSession
นี่คือสิทธิ์ที่คุณต้องประกาศเพื่อให้เขียน mindfulness ได้
<application>
<uses-permission
android:name="android.permission.health.WRITE_MINDFULNESS" />
...
</application>
หากต้องการอ่านการทำสติ คุณต้องขอสิทธิ์ต่อไปนี้
<application>
<uses-permission
android:name="android.permission.health.READ_MINDFULNESS" />
...
</application>
ขอสิทธิ์จากผู้ใช้
หลังจากสร้างอินสแตนซ์ไคลเอ็นต์แล้ว แอปของคุณต้องขอสิทธิ์จากผู้ใช้ ผู้ใช้ต้องได้รับอนุญาตให้ให้หรือปฏิเสธสิทธิ์ได้ทุกเมื่อ
โดยให้สร้างชุดสิทธิ์สำหรับประเภทข้อมูลที่จำเป็น ตรวจสอบว่าได้ประกาศสิทธิ์ในชุดไว้ใน Android manifest ก่อน
// 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)
}
}
เนื่องจากผู้ใช้สามารถให้หรือเพิกถอนสิทธิ์ได้ทุกเมื่อ แอปของคุณจึงต้อง ตรวจสอบสิทธิ์ที่ได้รับเป็นระยะๆ และจัดการสถานการณ์ที่ สิทธิ์สูญหาย
ข้อมูลที่รวมอยู่ในบันทึกเซสชันการเจริญสติ
บันทึกเซสชันการเจริญสติแต่ละรายการจะบันทึกเซสชันการเจริญสติทุกประเภท ที่ผู้ใช้ทำ เช่น การทำสมาธิ การฝึกหายใจ และการเคลื่อนไหว นอกจากนี้ บันทึก ยังอาจมีหมายเหตุเพิ่มเติมเกี่ยวกับเซสชันด้วย
การรวมที่รองรับ
ไม่มีการรวบรวมที่รองรับสำหรับข้อมูลประเภทนี้
อ่านข้อมูลเซสชันการเจริญสติ
ข้อมูลโค้ดต่อไปนี้แสดงวิธีอ่านเซสชันการฝึกสติ
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)
),
)))
}