写入睡眠数据

您的应用可以读取和写入精细睡眠数据。这包括 SleepStages 枚举类型中的浅度睡眠、深度睡眠、REM 和清醒睡眠阶段。如需写入睡眠数据，您必须创建 FitnessActivities.SLEEP 类型的会话。睡眠数据必须封装在会话中，才能显示在 Google 健身应用的用户日记中。

（可选）在会话中插入 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

Request 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

    Request 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

    Request 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

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