Schlafdaten lesen

Der Schlaf wird in Sitzungen dargestellt. vom Typ sleep. Sitzungen können optional Schlafphasen mit detaillierteren Details enthalten. zu Schlafdaten. Zum Beispiel im Leicht-, Tief- oder REM-Schlaf Schlaf:

Werte der Schlafphasen
Art der Schlafphase Wert
Wach (im Schlafzyklus) 1
Schlaf 2
Aus dem Bett 3
Leichter Schlaf 4
Tiefschlaf 5
REM-Schlaf 6

Im Leitfaden Schlafdaten schreiben erfährst du, wie sowohl Detaillierte und nicht detaillierte Schlafdaten werden in Fit dargestellt.

In den folgenden Beispielen wird ein SessionClient um Daten aus Fit abzurufen.

val SLEEP_STAGE_NAMES = arrayOf(
    "Unused",
    "Awake (during sleep)",
    "Sleep",
    "Out-of-bed",
    "Light sleep",
    "Deep sleep",
    "REM sleep"
)

val request = SessionReadRequest.Builder()
    .readSessionsFromAllApps()
    // By default, only activity sessions are included, so it is necessary to explicitly
    // request sleep sessions. This will cause activity sessions to be *excluded*.
    .includeSleepSessions()
    // Sleep segment data is required for details of the fine-granularity sleep, if it is present.
    .read(DataType.TYPE_SLEEP_SEGMENT)
    .setTimeInterval(startTime, endTime, TimeUnit.MILLISECONDS)
    .build()

sessionsClient.readSession(request)
    .addOnSuccessListener { response ->
        for (session in response.sessions) {
            val sessionStart = session.getStartTime(TimeUnit.MILLISECONDS)
            val sessionEnd = session.getEndTime(TimeUnit.MILLISECONDS)
            Log.i(TAG, "Sleep between $sessionStart and $sessionEnd")

            // If the sleep session has finer granularity sub-components, extract them:
            val dataSets = response.getDataSet(session)
            for (dataSet in dataSets) {
                for (point in dataSet.dataPoints) {
                    val sleepStageVal = point.getValue(Field.FIELD_SLEEP_SEGMENT_TYPE).asInt()
                    val sleepStage = SLEEP_STAGE_NAMES[sleepStageVal]
                    val segmentStart = point.getStartTime(TimeUnit.MILLISECONDS)
                    val segmentEnd = point.getEndTime(TimeUnit.MILLISECONDS)
                    Log.i(TAG, "\t* Type $sleepStage between $segmentStart and $segmentEnd")
                }
            }
        }
    }

Das Abrufen von Schlafsitzungen erfolgt über die REST API in zwei Phasen:

  1. Liste der Sitzungen abrufen Der Parameter activityType wird auf 72 (SLEEP) festgelegt. Hinweis: Sie können startTime und endTime oder ein pageToken verwenden. um seit der vorherigen Anfrage neue Sitzungen abzurufen.

    HTTP-Methode

    GET
    

    Anfrage-URL

    https://www.googleapis.com/fitness/v1/users/me/sessions?startTime=2019-12-05T00:00.000Z&endTime=2019-12-17T23:59:59.999Z&activityType=72
    

    Antwort

    Ein Beispiel für eine Sitzung könnte dies so aussehen:

    {
     "session": [
        {
         "id": "Sleep1575505620000",
         "name": "Sleep",
         "description": "",
         "startTimeMillis": "1575505620000",
         "endTimeMillis": "1575526800000",
         "modifiedTimeMillis": "1575590432413",
         "application": {
          "packageName": "com.example.sleep_tracker"
         },
         "activityType": 72  // Sleep
        },
        {
         "id": "Run2939075083",
         "name": "Mud",
         "description": "",
         "startTimeMillis": "1576594403000",
         "endTimeMillis": "1576598754000",
         "modifiedTimeMillis": "1576616010143",
         "application": {
          "packageName": "com.example.run_tracker"
         },
         "activityType": 8  // Running
        }
      ],
     "deletedSession": [],
     "nextPageToken": "1576598754001"
    }
    
  2. Um Details zu den Schlafphasen für jede Sitzung (falls vorhanden) zu erhalten, verwende die folgende Anfrage für jede Sitzung in der gefilterten Liste an:

    HTTP-Methode

    POST
    

    Anfrage-URL

    https://www.googleapis.com/fitness/v1/users/userId/dataset:aggregate
    

    Anfragetext

    {
      "aggregateBy": [
        {
          "dataTypeName": "com.google.sleep.segment"
        }
      ],
      "endTimeMillis": 1575609060000,
      "startTimeMillis": 1575591360000
    }
    

    Antwort

    Wenn deine Anfrage erfolgreich war, siehst du den HTTP-Antwortstatus „200 OK“ Code. Der Antworttext enthält eine JSON-Darstellung der Aktivität aus denen die Schlafeinheit besteht. Jeder intVal steht für den Aktivitätstyp des Schlafs

    {
     "bucket": [
      {
       "startTimeMillis": "1575591360000",
       "endTimeMillis": "1575609060000",
       "dataset": [
        {
         "point": [
          {
           "startTimeNanos": "1575591360000000000",
           "endTimeNanos": "1575595020000000000",
           "dataTypeName": "com.google.sleep.segment",
           "originDataSourceId": "...",
           "value": [
            {
             "intVal": 4, // Light sleep
             "mapVal": []
            }
           ]
          },
          {
           "startTimeNanos": "1575595020000000000",
           "endTimeNanos": "1575596220000000000",
           "dataTypeName": "com.google.sleep.segment",
           "originDataSourceId": "...",
           "value": [
            {
             "intVal": 1, // Sleep
             "mapVal": []
            }
           ]
          },
    
          // .... more datapoints
    
          {
           "startTimeNanos": "1575605940000000000",
           "endTimeNanos": "1575609060000000000",
           "dataTypeName": "com.google.sleep.segment",
           "originDataSourceId": "...",
           "value": [
            {
             "intVal": 4, // Light sleep
             "mapVal": []
            }
           ]
          }
         ]
        }
       ]
      }
     ]
    }