كتابة بيانات النوم

يمكن للتطبيق قراءة بيانات النوم الدقيقة وكتابتها. ويشمل ذلك نمط النوم الخفيف والنوم العميق وعملية العين السريعة ومراحل النوم النشطة من النوع SleepStages. لكتابة بيانات النوم، يجب إنشاء جلسة من النوع FitnessActivities.SLEEP. ويجب تضمين بيانات النوم في جلسة إذا كانت بيانات الجلسة في سجلّ المستخدم في تطبيق Google Fit.

اختياريًا، أدرِج شرائح من النوع SleepStages ضمن الجلسة:

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

مثال على الدقة

لكتابة ليلة من النوم بدون دقة المرحلة، اتّبع المثال أدناه. يمكنك إنشاء جلسة مع وقت البدء والانتهاء، ووضع activity في وضع السكون.

Android

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)
    }

اقرأ المزيد من التفاصيل عن الجلسات في Android.

راحة

طريقة HTTP

PUT

عنوان URL للطلب

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
}

مثال على دقة مراحل النوم

لكتابة وقت النوم بدرجات دقة، اكتب كلا جلسة النوم ذات المستوى الأعلى والشرائح لمراحل النوم المختلفة.

كتابة بيانات شرائح وقت النوم

في هذا المثال، سنكتب عدة شرائح لتمثيل مراحل النوم المتعددة على مدار ليلة واحدة من النوم.

Android

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
   

   عنوان URL للطلب

   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
   

   عنوان URL للطلب

   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
                   }
               ]
           }
        ]
    }
   

كتابة بيانات جلسة النوم

أخيرًا، يمكنك تجميع الشرائح أعلاه عن طريق إدراج جلسة نوم. اضبط وقت بدء هذه الجلسة على وقت بدء الشريحة الأولى، ووقت الانتهاء على وقت انتهاء الشريحة الأخيرة.

Android

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

عنوان URL للطلب

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
}