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

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

يمكنك اختياريًا إدراج مقاطع من النوع SleepStages ضمن الجلسة:

مثال بدون مستوى دقة

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

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.

REST

طريقة 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()

REST

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

REST

طريقة 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
}