داده های خواب را بنویسید

برنامه شما می‌تواند داده‌های خواب جزئی را بخواند و بنویسد. این شامل مراحل خواب سبک، خواب عمیق، خواب REM و خواب بیداری از نوع شمارشی SleepStages می‌شود. برای نوشتن داده‌های خواب، باید یک جلسه از نوع FitnessActivities.SLEEP ایجاد کنید. داده‌های خواب باید در یک جلسه کپسوله‌سازی شوند تا در دفتر خاطرات کاربر در برنامه Google Fit نمایش داده شوند.

به صورت اختیاری، بخش‌هایی از نوع SleepStages را درون جلسه وارد کنید:

• SleepStages.SLEEP_LIGHT
• SleepStages.SLEEP_DEEP
• SleepStages.SLEEP_REM
• SleepStages.AWAKE
• SleepStages.OUT_OF_BED

مثال بدون دانه‌بندی

برای نوشتن یک شب خواب بدون جزئیات مرحله‌ای، از مثال زیر پیروی کنید. یک جلسه با زمان شروع و پایان و activity SLEEP ایجاد کنید.

اندروید

val fitnessOptions = FitnessOptions.builder()
    .accessSleepSessions(FitnessOptions.ACCESS_WRITE)
    .build()

// Create the sleep session
val session= Session.Builder()
    .setName(sessionName)
    .setIdentifier(identifier)
    .setDescription(description)
    .setStartTime(startTime, TimeUnit.MILLISECONDS)
    .setEndTime(endTime, TimeUnit.MILLISECONDS)
    .setActivity(FitnessActivities.SLEEP)
    .build()

// Build the request to insert the session.
val request = SessionInsertRequest.Builder()
    .setSession(session)
    .build()

// Insert the session into Fit platform
Log.i(TAG, "Inserting the session with the SessionsClient")
Fitness.getSessionsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
    .insertSession(request)
    .addOnSuccessListener {
        Log.i(TAG,"Session insert was successful!")
    }
    .addOnFailureListener { e ->
        Log.w(TAG, "There was a problem inserting the session", e)
    }

جزئیات بیشتر در مورد جلسات در اندروید را بخوانید.

استراحت

روش HTTP

PUT

درخواست آدرس اینترنتی

https://www.googleapis.com/fitness/v1/users/me/sessions/identifier

درخواست بدنه

{
    "id": identifier,
    "name": sessionName,
    "description": description,
    "startTimeMillis": startTime,
    "endTimeMillis": endTime,
    "version": 1,
    "lastModifiedToken": "exampleToken",
    "application": {
        "detailsUrl": "http://example.com",
        "name": "Foo Example App",
        "version": "1.0"
    },
    "activityType": 72 // Sleep
}

مثال جزئیات مراحل خواب

برای نوشتن خواب با جزئیات مراحل، هم جلسه خواب سطح بالا و هم بخش‌هایی را برای مراحل مختلف خواب بنویسید.

بخش‌های خواب را بنویسید

در این مثال، چندین بخش خواهیم نوشت که مراحل مختلف خواب را در طول یک شب خواب نشان می‌دهند.

اندروید

val dataSource = DataSource.Builder()
    .setType(DataSource.TYPE_RAW)
    .setDataType(DataType.TYPE_SLEEP_SEGMENT)
    .setAppPackageName(context)
    // Optional but recommended for identifying the stream if you have multiple streams with the same dataType.
    .setStreamName(streamName)
    .build()

val dataPoints = listOf(
    DataPoint.builder(dataSource)
        .setTimeInterval(startTime1, endTime1, TimeUnit.MILLISECONDS)
        .setField(Field.FIELD_SLEEP_SEGMENT_TYPE, SleepStages.SLEEP_LIGHT)
        .build(),
    DataPoint.builder(dataSource)
        .setTimeInterval(startTime2, endTime2, TimeUnit.MILLISECONDS)
        .setField(Field.FIELD_SLEEP_SEGMENT_TYPE, SleepStages.SLEEP_DEEP)
        .build(),
    DataPoint.builder(dataSource)
        .setTimeInterval(startTime3, endTime3, TimeUnit.MILLISECONDS)
        .setField(Field.FIELD_SLEEP_SEGMENT_TYPE, SleepStages.SLEEP_LIGHT)
        .build(),
    DataPoint.builder(dataSource)
        .setTimeInterval(startTime4, endTime4, TimeUnit.MILLISECONDS)
        .setField(Field.FIELD_SLEEP_SEGMENT_TYPE, SleepStages.SLEEP_REM)
        .build(),
    DataPoint.builder(dataSource)
        .setTimeInterval(startTime5, endTime5, TimeUnit.MILLISECONDS)
        .setField(Field.FIELD_SLEEP_SEGMENT_TYPE, SleepStages.AWAKE)
        .build(),
    DataPoint.builder(dataSource)
        .setTimeInterval(startTime6, endTime6, TimeUnit.MILLISECONDS)
        .setField(Field.FIELD_SLEEP_SEGMENT_TYPE, SleepStages.SLEEP_LIGHT)
        .build()
)

val dataSet = DataSet.builder(dataSource)
    .addAll(dataPoints)
    .build()

استراحت

1. ابتدا dataSource را ایجاد کنید:

   روش HTTP

   POST
   

   درخواست آدرس اینترنتی

   https://www.googleapis.com/fitness/v1/users/me/dataSources
   

   درخواست بدنه

   {
     "dataStreamName": streamName,
     "type": "raw",
     "application": {
       "detailsUrl": "http://example.com",
       "name": "Foo Example App",
       "version": "1"
     },
     "dataType": {
       "name": "com.google.sleep.segment"
     }
   }
   

2. سپس dataSet را پر کنید:

   روش HTTP

   PATCH
   

   درخواست آدرس اینترنتی

   https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
   

   درخواست بدنه

   {
       "dataSourceId": dataSourceId,
       "point": [
           {
               "dataTypeName": "com.google.sleep.segment",
               "startTimeNanos": startTime1,
               "endTimeNanos": endTime1,
               "value": [
                   {
                       intVal: 4 // Light sleep
                   }
               ]
           },
           {
               "dataTypeName": "com.google.sleep.segment",
               "startTimeNanos": startTime2,
               "endTimeNanos": endTime2,
               "value": [
                   {
                       intVal: 5 // Deep sleep
                   }
               ]
           },
           {
               "dataTypeName": "com.google.sleep.segment",
               "startTimeNanos": startTime3,
               "endTimeNanos": endTime3,
               "value": [
                   {
                       intVal: 4 // Light sleep
                   }
               ]
           },
           {
               "dataTypeName": "com.google.sleep.segment",
               "startTimeNanos": startTime4,
               "endTimeNanos": endTime4,
               "value": [
                   {
                       intVal: 6 // REM sleep
                   }
               ]
           },
           {
               "dataTypeName": "com.google.sleep.segment",
               "startTimeNanos": startTime5,
               "endTimeNanos": endTime5,
               "value": [
                   {
                       intVal: 1 // Awake
                   }
               ]
           },
           {
               "dataTypeName": "com.google.sleep.segment",
               "startTimeNanos": startTime6,
               "endTimeNanos": endTime6,
               "value": [
                   {
                       intVal: 4 // Light sleep
                   }
               ]
           }
        ]
    }
   

جلسه خواب را بنویسید

در نهایت، بخش‌های بالا را با وارد کردن یک جلسه خواب (sleep session) گروه‌بندی کنید. زمان شروع این جلسه را برابر با زمان شروع اولین بخش و زمان پایان را برابر با زمان پایان آخرین بخش تنظیم کنید.

اندروید

val fitnessOptions = FitnessOptions.builder()
    .accessSleepSessions(FitnessOptions.ACCESS_WRITE)
    .addDataType(DataType.TYPE_SLEEP_SEGMENT, FitnessOptions.ACCESS_WRITE)
    .build()

val session = Session.Builder()
    .setName(sessionName)
    .setIdentifier(identifier)
    .setDescription(description)
    .setStartTime(startTime1, TimeUnit.MILLISECONDS) // From first segment
    .setEndTime(endTime6, TimeUnit.MILLISECONDS) // From last segment
    .setActivity(FitnessActivities.SLEEP)
    .build()

// Build the request to insert the session.
val request = SessionInsertRequest.Builder()
    .setSession(session)
    .addDataSet(dataset)
    .build()

// Insert the session into Fit platform
Log.i(TAG, "Inserting the session in the Sessions API")
Fitness.getSessionsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
    .insertSession(request)
    .addOnSuccessListener {
        Log.i(TAG,"Session insert was successful!")
    }
    .addOnFailureListener { e ->
        Log.i(TAG, "There was a problem inserting the session", e)
    }

استراحت

روش HTTP

PUT

درخواست آدرس اینترنتی

https://www.googleapis.com/fitness/v1/users/me/sessions/identifier

درخواست بدنه

{
    "id": identifier,
    "name": sessionName,
    "description": description,
    "startTimeMillis": startTime1,
    "endTimeMillis": endTime6,
    "version": 1,
    "lastModifiedToken": "exampleToken",
    "application": {
        "detailsUrl": "http://example.com",
        "name": "Foo Example App",
        "version": "1.0"
    },
    "activityType": 72 // Sleep
}