नींद के सेशन ट्रैक करना

यह गाइड, Health Connect के 1.1.0-alpha11 वर्शन के साथ काम करती है.

Health Connect, नींद के सेशन का डेटा टाइप उपलब्ध कराता है. इससे किसी व्यक्ति की नींद के बारे में जानकारी सेव की जा सकती है. जैसे, रात में सोने का सेशन या दिन में झपकी लेना. इन सेशन को दिखाने के लिए, SleepSessionRecord डेटा टाइप का इस्तेमाल किया जाता है.

सेशन की मदद से, उपयोगकर्ता समय के हिसाब से परफ़ॉर्मेंस को मेज़र कर सकते हैं. जैसे, लगातार दिल की धड़कन या जगह की जानकारी का डेटा.

SleepSessionRecord सेशन में ऐसा डेटा होता है जो नींद के चरणों को रिकॉर्ड करता है. जैसे, AWAKE, SLEEPING, और DEEP.

सबटाइप डेटा, सेशन से "जुड़ा" होता है. यह सिर्फ़ तब काम का होता है, जब इसे पैरंट सेशन के साथ पढ़ा जाता है. उदाहरण के लिए, नींद की स्थिति.

देखें कि Health Connect उपलब्ध है या नहीं

Health Connect का इस्तेमाल करने से पहले, आपके ऐप्लिकेशन को यह पुष्टि करनी चाहिए कि Health Connect, उपयोगकर्ता के डिवाइस पर उपलब्ध है. ऐसा हो सकता है कि Health Connect, सभी डिवाइसों पर पहले से इंस्टॉल न हो या इसे बंद कर दिया गया हो. HealthConnectClient.getSdkStatus() तरीके का इस्तेमाल करके, यह देखा जा सकता है कि कोई सुविधा उपलब्ध है या नहीं.

Health Connect की उपलब्धता की जांच करने का तरीका

fun checkHealthConnectAvailability(context: Context) {
    val providerPackageName = "com.google.android.apps.healthdata" // Or get from HealthConnectClient.DEFAULT_PROVIDER_PACKAGE_NAME
    val availabilityStatus = HealthConnectClient.getSdkStatus(context, providerPackageName)

    if (availabilityStatus == HealthConnectClient.SDK_UNAVAILABLE) {
      // Health Connect is not available. Guide the user to install/enable it.
      // For example, show a dialog.
      return // early return as there is no viable integration
    }
    if (availabilityStatus == HealthConnectClient.SDK_UNAVAILABLE_PROVIDER_UPDATE_REQUIRED) {
      // Health Connect is available but requires an update.
      // Optionally redirect to package installer to find a provider, for example:
      val uriString = "market://details?id=$providerPackageName&url=healthconnect%3A%2F%2Fonboarding"
      context.startActivity(
        Intent(Intent.ACTION_VIEW).apply {
          setPackage("com.android.vending")
          data = Uri.parse(uriString)
          putExtra("overlay", true)
          putExtra("callerId", context.packageName)
        }
      )
      return
    }
    // Health Connect is available, obtain a HealthConnectClient instance
    val healthConnectClient = HealthConnectClient.getOrCreate(context)
    // Issue operations with healthConnectClient
}

getSdkStatus() से मिले स्टेटस के आधार पर, उपयोगकर्ता को Google Play Store से Health Connect इंस्टॉल या अपडेट करने के लिए कहा जा सकता है.

सुविधा की उपलब्धता

इस डेटा टाइप के लिए, सुविधा की उपलब्धता का कोई फ़्लैग नहीं है.

ज़रूरी अनुमतियां

नींद के सेशन का डेटा ऐक्सेस करने के लिए, इन अनुमतियों का इस्तेमाल किया जाता है:

  • android.permission.health.READ_SLEEP
  • android.permission.health.WRITE_SLEEP

अपने ऐप्लिकेशन में नींद के सेशन की सुविधा जोड़ने के लिए, SleepSession डेटा टाइप के लिए लिखने की अनुमतियों का अनुरोध करें.

नींद के सेशन की जानकारी लिखने के लिए, आपको यह अनुमति देनी होगी:

<application>
  <uses-permission
android:name="android.permission.health.WRITE_SLEEP" />
...
</application>

नींद के सेशन की जानकारी पढ़ने के लिए, आपको इन अनुमतियों का अनुरोध करना होगा:

<application>
  <uses-permission
android:name="android.permission.health.READ_SLEEP" />
...
</application>

उपयोगकर्ता से अनुमतियों का अनुरोध करना

क्लाइंट इंस्टेंस बनाने के बाद, आपके ऐप्लिकेशन को उपयोगकर्ता से अनुमतियों का अनुरोध करना होगा. उपयोगकर्ताओं को किसी भी समय अनुमतियां देने या अस्वीकार करने की अनुमति होनी चाहिए.

इसके लिए, ज़रूरी डेटा टाइप के लिए अनुमतियों का सेट बनाएं. पक्का करें कि सेट में मौजूद अनुमतियों का एलान, सबसे पहले आपके Android मेनिफ़ेस्ट में किया गया हो.

// Create a set of permissions for required data types
val PERMISSIONS =
    setOf(
  HealthPermission.getReadPermission(SleepSessionRecord::class),
  HealthPermission.getWritePermission(SleepSessionRecord::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)
  }
}

उपयोगकर्ता किसी भी समय अनुमतियां दे सकते हैं या उन्हें रद्द कर सकते हैं. इसलिए, आपके ऐप्लिकेशन को समय-समय पर यह जांच करनी चाहिए कि कौनसी अनुमतियां दी गई हैं. साथ ही, उन स्थितियों को मैनेज करना चाहिए जिनमें अनुमति नहीं दी गई है.

इस्तेमाल किए जा सकने वाले एग्रीगेशन

SleepSessionRecord के लिए, ये एग्रीगेट वैल्यू उपलब्ध हैं:

सामान्य दिशा-निर्देश

Health Connect में नींद के सेशन के साथ काम करने के सबसे सही तरीकों के बारे में यहां बताया गया है.

  • नींद के किसी खास सेशन का डेटा जोड़ने के लिए, सेशन का इस्तेमाल किया जाना चाहिए. जैसे, नींद के लिए:
suspend fun writeSleepSession(healthConnectClient: HealthConnectClient) {
    healthConnectClient.insertRecords(
        listOf(
            SleepSessionRecord(
                startTime = Instant.parse("2022-05-10T23:00:00.000Z"),
                startZoneOffset = ZoneOffset.of("-08:00"),
                endTime = Instant.parse("2022-05-11T07:00:00.000Z"),
                endZoneOffset = ZoneOffset.of("-08:00"),
                title = "My Sleep"
            ),
        )
    )
}
  • सत्रों का इस्तेमाल, सामान्य मेज़रमेंट के लिए नहीं किया जाना चाहिए. जैसे, रोज़ाना के कदमों की संख्या.
  • सबटाइप डेटा में यूआईडी नहीं होता, लेकिन इससे जुड़े डेटा में अलग-अलग यूआईडी होते हैं.
  • सब-टाइप का डेटा, एक सेशन में अलाइन होना चाहिए. साथ ही, टाइमस्टैंप का क्रम ऐसा होना चाहिए कि वे एक-दूसरे से ओवरलैप न करें. हालांकि, इसमें गैप की अनुमति है.
  • अगर उपयोगकर्ता को डेटा को किसी सेशन से जोड़ना है और उसे लगातार रिकॉर्ड करने के बजाय सेशन के हिस्से के तौर पर ट्रैक करना है, तो सेशन का इस्तेमाल करना फ़ायदेमंद होता है.

नींद के सेशन

Health Connect में नींद का डेटा देखा जा सकता है या उसमें बदलाव किया जा सकता है. नींद के डेटा को एक सेशन के तौर पर दिखाया जाता है. इसे नींद के आठ अलग-अलग चरणों में बांटा जा सकता है:

  • UNKNOWN: अगर उपयोगकर्ता सो रहा है, तो यह जानकारी नहीं दी जाती या यह जानकारी अज्ञात होती है.
  • AWAKE: उपयोगकर्ता नींद के दौरान नहीं, बल्कि नींद के चक्र के दौरान जगा हुआ है.
  • SLEEPING: नींद के बारे में सामान्य या कम जानकारी.
  • OUT_OF_BED: उपयोगकर्ता नींद के सेशन के बीच में बिस्तर से उठ जाता है.
  • AWAKE_IN_BED: उपयोगकर्ता बिस्तर पर लेटा है, लेकिन जाग रहा है.
  • LIGHT: उपयोगकर्ता हल्की नींद में है.
  • DEEP: उपयोगकर्ता गहरी नींद की स्थिति में है.
  • REM: उपयोगकर्ता रैपिड आई मूवमेंट (आरईएम) वाली नींद के साइकल में है.

इन वैल्यू से पता चलता है कि किसी व्यक्ति को तय समयसीमा में किस तरह की नींद आई. नींद की अलग-अलग स्टेज के बारे में लिखना ज़रूरी नहीं है. हालांकि, अगर यह जानकारी उपलब्ध है, तो हमारा सुझाव है कि आप इसे लिखें.

नींद के सेशन का डेटा सेव करने की अनुमति दें

SleepSessionRecord डेटा टाइप के दो हिस्से होते हैं:

  1. नींद की पूरी अवधि का सेशन.
  2. नींद के सेशन के दौरान अलग-अलग चरणों की जानकारी, जैसे कि हल्की नींद या गहरी नींद.

यहां नींद के चरणों के बिना स्लीप सेशन डालने का तरीका बताया गया है:

SleepSessionRecord(
      title = "weekend sleep",
      startTime = startTime,
      endTime = endTime,
      startZoneOffset = ZoneOffset.UTC,
      endZoneOffset = ZoneOffset.UTC,
)

नींद के पूरे सेशन को कवर करने वाले चरण जोड़ने का तरीका यहां बताया गया है:

val stages = listOf(
    SleepSessionRecord.Stage(
        startTime = START_TIME
        endTime = END_TIME,
        stage = SleepSessionRecord.STAGE_TYPE_SLEEPING,
    )
)

SleepSessionRecord(
        title = "weekend sleep",
        startTime = START_TIME,
        endTime = END_TIME,
        startZoneOffset = START_ZONE_OFFSET,
        endZoneOffset = END_ZONE_OFFSET,
        stages = stages,
)

नींद के सेशन का डेटा देखने की अनुमति दें

नींद के हर सेशन के लिए, आपको यह देखना चाहिए कि नींद के चरण का डेटा भी मौजूद है या नहीं:

suspend fun readSleepSessions(
    healthConnectClient: HealthConnectClient,
    startTime: Instant,
    endTime: Instant
) {
    val response =
        healthConnectClient.readRecords(
            ReadRecordsRequest(
                SleepSessionRecord::class,
                timeRangeFilter = TimeRangeFilter.between(startTime, endTime)
            )
        )
    for (sleepRecord in response.records) {
        // Retrieve relevant sleep stages from each sleep record
        val sleepStages = sleepRecord.stages
    }
}

नींद के सेशन का डेटा मिटाना

किसी सेशन को मिटाने का तरीका यहां बताया गया है. इस उदाहरण के लिए, हमने नींद के सेशन का इस्तेमाल किया है:

suspend fun deleteSleepSession(
    healthConnectClient: HealthConnectClient,
    sleepRecord: SleepSessionRecord,
) {
    val timeRangeFilter = TimeRangeFilter.between(sleepRecord.startTime, sleepRecord.endTime)
    healthConnectClient.deleteRecords(SleepSessionRecord::class, timeRangeFilter)
}