ติดตามการเจริญสติ

คำแนะนำนี้ใช้ได้กับ 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)
            ),
        )))
    }