Sitzungen

Durch Sitzungen können sich Nutzer schnell und einfach eine Liste aller Hauptaktivitäten ansehen, die sie ausgeführt haben. Sie werden in der Google Fit App-Journalseite angezeigt. Beispiele für eine Sitzung sind z. B. eine Atemübung, ein Spaziergang, ein Lauf oder eine Nacht mit Schlaf.

In Sitzungen werden Datasets aus einem bestimmten Zeitraum gruppiert, der während einer Aktivität erfasst wurde. Wenn ein Nutzer beispielsweise erfasst, wann er eine 3 km lange Laufstrecke gestartet und beendet hat, kann eine Sitzung erstellt werden und alle Fitnessdaten, die in diesem Zeitraum erfasst wurden (z. B. Schritte, Geschwindigkeit, Strecke), werden dieser Sitzung zugeordnet.

Die Sitzungen selbst enthalten keine Details zur Aktivität. Dies ist im Dataset. Sitzungen haben folgende Properties:

  • Einen beschreibenden, aussagekräftigen Namen (z. B. &morgenauslauf")
  • Eine Beschreibung
  • Eine eindeutige Kennung
  • Die Art der Aktivität, z. B. ein Lauf

Vorteile von Sitzungen

  • Nützlich für Nutzer: Mithilfe von Sitzungen können Sie Aktivitätsdaten und Trainings auf sinnvolle Weise für Nutzer organisieren. Sie können sich alle Aktivitäten des Tages auf der Seite „Journal“ in der Google Fit App ansehen.
  • Konsistente Nutzererfahrung: Wenn deine App oder dein Companion-Gerät das Aktivitäts-Tracking zulässt (wo Nutzer eine Aktivität starten und beenden können), können Nutzer die Sitzungen für diese Workouts sehen, wenn sie ihre Aktivitäten in beiden Apps sehen.
  • Umfassendere Daten: Google Fit führt auch Daten aus mehreren Quellen zusammen, um die Sitzungsinformationen zu ergänzen und anzureichern. So erhalten Nutzer ein umfassenderes Bild ihrer Aktivität.
  • Google Fit-Plattform nutzen: Wenn Ihre Nutzer ihre Aktivitäten nicht erfassen oder Ihre App das Tracking nicht unterstützt, können Sie in Google Fit weiterhin Sitzungen lesen. Du kannst detaillierte oder aggregierte Daten aus dem Fitnessspeicher abfragen und verfügbare Sitzungen finden, ohne dass du dein eigenes Schema und deinen eigenen Speicher implementieren musst.
  • Mehr Nutzerinteraktionen: Sie können Ihren Nutzern die verfügbaren Sitzungen und die Apps, die sie erstellt haben, anzeigen lassen. Die Interaktion mit anderen Fitness-Apps auf diese Weise kann die Nutzerinteraktion erhöhen.

Nutzerautorisierung für Sitzungen abrufen

Wenn Sie Sitzungen lesen oder schreiben möchten, muss Ihre App die Berechtigung des Nutzers erhalten. Für den Zugriff auf Sitzungen werden dieselben Autorisierungsbereiche wie für Datentypen verwendet, die Sie so anfordern sollten:

Android

Gib die Art der Sitzung an, auf die deine App zugreifen muss. Verwende dazu die entsprechenden Methoden aus FitnessOptions. Wenn Sie sich beispielsweise Sitzungen zum Laufen ansehen möchten, können Sie Folgendes auswählen:

    val fitnessOptions = FitnessOptions.builder()
        .accessActivitySessions(FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_HEART_RATE_BPM, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_SPEED, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_LOCATION_SAMPLE, FitnessOptions.ACCESS_READ)
        .build()

In diesem Beispiel wird angegeben, dass deine App auf Metadaten von Aktivitätssitzungen zugreifen möchte. Außerdem werden die Datentypen angegeben, die in diesen Sitzungen gelesen werden sollen. In diesem Beispiel werden die Herzfrequenz-, Geschwindigkeits- und Standortdaten verwendet.

REST

So fordern Sie Bereiche an:

  • Sitzungen mit Aktivitätstypen für den Schlaf:
    • https://www.googleapis.com/auth/fitness.sleep.read
    • https://www.googleapis.com/auth/fitness.sleep.write
  • Alle anderen Sitzungen:
    • https://www.googleapis.com/auth/fitness.activity.read
    • https://www.googleapis.com/auth/fitness.activity.write

Sitzungen verwenden

Android

Mit der Sessions API können Sie Folgendes tun:

  • Sitzungen in Echtzeit erstellen
  • Trainingseinheiten in den Fitnessladen einfügen
  • Füge Aktivitätssegmente ein, um Pausen während des Trainings zu unterstützen
  • Verknüpfte Sitzungen und Datasets lesen
  • Eine andere App starten, um Informationen zu einer erstellten Sitzung anzuzeigen
  • Intent erhalten, wenn eine andere App eine Sitzung startet

REST

Mit der Sessions API können Sie Folgendes tun:

  • Sitzungen in Echtzeit erstellen
  • Trainingseinheiten in den Fitnessladen einfügen
  • Füge Aktivitätssegmente ein, um Pausen während des Trainings zu unterstützen
  • Verknüpfte Sitzungen und Datasets lesen

Interaktion von Datasets und Segmenten mit Sitzungen

In Google Fit:

  • Ein Dataset stellt einen Satz von Datenpunkten aus einer bestimmten Datenquelle über einen bestimmten Zeitraum dar. Datasets können selbst eingefügt werden. Wenn Sie jedoch eine Sitzung erstellen, ist es einfacher, die Sitzung und die zugehörigen Datasets gemeinsam zu erstellen.
  • Ein Segment gruppiert die Datasets in einer Sitzung nach der genauen Aktivität, die der Nutzer in der Sitzung ausgeführt hat. Wenn der Nutzer beispielsweise eine 30-minütige Ausführung (Sitzung) erfasst, aber in dieser Zeit eine Weile gegangen ist, kann dies in Segmente unterteilt werden. Es gibt ein Segment für die Ausführung, dann die Pause und dann die Ausführung noch einmal.
Abbildung 1: Verschiedene Apps fügen dem [Fitness Store] Sitzungen und Datasets hinzu.

Abbildung 1 zeigt ein Zeitintervall im Fitnessspeicher, in dem Apps A, B und C einige Datasets und Sitzungen eingefügt haben:

  • App A hat die Datasets A1 und A2 zusammen mit Sitzung 1 und A3 unabhängig von den Sitzungen eingefügt.
  • App B hat die Datasets B1 und B2 zusammen mit Sitzung 2 eingefügt.
  • Dataset C1 von App C unabhängig von Sitzungen eingefügt.

Beim Lesen von Sitzungsdaten aus dem Fitnessspeicher werden alle Fitnessdaten, die innerhalb des Zeitintervalls einer Sitzung liegen, automatisch dieser Sitzung zugeordnet. Dies gilt auch dann, wenn Sie die Daten nach dem Erstellen der Sitzung einfügen oder eine Sitzung einrichten, nachdem die Daten passiv erfasst wurden. Eine Abfrage von Fitnessdaten aus Sitzung 1 würde beispielsweise Folgendes zurückgeben:

  • Dataset A1
  • Dataset A2
  • Der Anteil von Dataset A3 zwischen t1 und t2
  • Der Anteil von Dataset C1 zwischen t1 und t2

Sie sehen, welche App die einzelnen Sitzungen und Datasets verwendet hat.

Sitzungen erstellen

Sitzungen können auf verschiedene Arten erstellt werden:

  • Ihre App kann aktiv eine Sitzung erstellen in:
    • in Echtzeit, wenn ein Nutzer eine Aktivität auf einem Gerät aktiv erfasst (nur Android) oder
    • indem Sie sie manuell einfügen.
  • Wenn ein Nutzer manuell ein Training oder eine Aktivität in der Google Fit App hinzufügt.

Wann eine Sitzung erstellt wird

Füge Schlafdaten hinzu?

  • Ja – Erstellen Sie eine Sitzung und fügen Sie sie manuell in den Fitnessspeicher ein. Beispiel: eine Ruhesitzung einfügen. Das liegt daran, dass Nutzer mit Schlaf-Tracking-Apps oder -Geräten nicht mit Geräten interagieren, um ihre Schlafaktivitäten zu starten und zu beenden. Diese Aktivitäten werden passiv erfasst.
  • Nein: Können Nutzer in Ihrer App Aktivitäten starten und beenden?

Lesesitzungen

Ihre App kann Sitzungen auf verschiedene Arten lesen:

  • Suchen Sie nach einer bestimmten Sitzung, die von
      erstellt oder eingefügt wurde.
    • Name oder
    • ID
  • Nach allen erstellten Sitzungen nach Zeitraum suchen
  • Nach allen verfügbaren Sitzungen suchen, die von allen Apps (einschließlich Google Fit) erstellt wurden, nach Zeitraum

Aus welchen Quellen eine Sitzung erstellt wurde

Sie können Nutzern zeigen, welche App oder welches Gerät für jede Sitzung erstellt wurde. Jeder Sitzung ist eine Datenquelle zugeordnet. Sie enthält Informationen zu der App oder dem Gerät, über das bzw. das die Daten erfasst oder transformiert wurden.

Android

Sie können derzeit nur den Paketnamen einer Sitzung abrufen, die von einem Android-Client geschrieben wurde. Verwenden Sie die Methode getAppPackageName, um den Paketnamen der Anwendung abzurufen, die eine Sitzung erstellt hat. Du kannst diese Informationen in deiner App verwenden, um Nutzern zu zeigen, welche anderen Apps Fitnesssitzungen eingelegt haben. Du kannst das Symbol für jede dieser Apps einblenden, damit Nutzer sie leichter erkennen.

Sie können auch einen Intent auslösen, um andere Apps zu starten, um Details zu den erstellten Sitzungen aufzurufen. Andere Apps können auch einen Intent auslösen, um Ihre App zu starten.

Weitere Informationen zum Ermitteln der Quelle, die eine Sitzung erstellt hat

REST

Mit dem Attribut session.application können Sie den Paketnamen der Android-App abrufen, mit der Sitzungen erstellt wurden. Verwenden Sie für Sitzungen, die mit der REST API erstellt wurden, stattdessen das Attribut session.name. Du kannst diese Informationen in deiner App verwenden, um Nutzern zu zeigen, welche anderen Apps Fitnesssitzungen verwendet haben. Sie können für jede dieser Apps das Symbol anzeigen, damit Nutzer sie leichter erkennen.

Weitere Informationen zum Ermitteln der Quelle, die eine Sitzung erstellt hat