Mithilfe von Sitzungen können Nutzer schnell und einfach eine Liste der wichtigsten Aktivitäten, die sie durchgeführt haben. Sie erscheinen auf der Seite „Tagebuch“ in der Google Fit App. Für wie eine Atemübung, ein Spaziergang, ein Lauf oder eine Nachtruhe Beispiele für eine Sitzung.
Sitzungen gruppieren Datensätze aus einem bestimmten Zeitraum, der während einer Aktivität. Wenn ein Nutzer z. B. aufzeichnet, wann er 3 km gestartet und beendet hat kann eine Sitzung erstellt werden und alle Fitnessdaten (wie Schritte, Geschwindigkeit, Strecke) dieser Sitzung zugeordnet werden.
Die Sitzungen selbst enthalten keine Details zur Aktivität. Dies ist in der Dataset. Sitzungen haben folgende Eigenschaften:
- Ein aussagekräftiger Name, z. B. „Lauf am Morgen“
- Eine Beschreibung
- Eine eindeutige Kennung
- Die Art der Aktivität, die erfasst wird (z. B. ein Lauf)
Vorteile von Sitzungen
- Nützlich für Nutzer: Mithilfe von Sitzungen kannst du Aktivitätsdaten und Trainingseinheiten in einem auf sinnvolle Weise präsentieren. Sie können alle ihre Aktivitäten des Tages in Tagebuchseite in der Google Fit App.
- Einheitliche Nutzererfahrung: Wenn Ihre App oder Ihr Begleitgerät Aktivitäten zulässt Tracking (wo Nutzer eine Aktivität starten und beenden können), Mit diesen Workouts können Nutzer ihre Aktivitäten in beiden Apps verfolgen.
- Umfassendere Daten: Google Fit führt auch Daten aus mehreren um die Sitzungsinformationen zu ergänzen und anzureichern. So können Nutzende umfassenderen Überblick über ihre Aktivitäten haben.
- Die Google Fit-Plattform nutzen: Wenn Nutzer ihre Aktivitäten nicht aufzeichnen oder Ihre App das Tracking nicht unterstützt, können Sie dennoch Sitzungen in Google Fit lesen. Sie können detaillierte oder aggregierte Daten aus dem Fitness-Store abfragen und verfügbaren Sitzungen, ohne dass Sie ein eigenes Schema Speicherplatz.
- Mehr Nutzer-Engagement: Sie können Ihren Nutzern die verfügbaren Sitzungen und Apps, von denen sie erstellt wurden. Diese Interaktion mit anderen Fitness-Apps das Nutzer-Engagement zu steigern.
Nutzerautorisierung für Sitzungen abrufen
Wenn Sie Sitzungen lesen oder schreiben möchten, muss Ihre App die Berechtigung. Für den Zugriff auf Sitzungen werden dieselben Autorisierungsbereiche verwendet als Datentypen, die Sie folgendermaßen anfordern sollten:
Android
Geben Sie an, auf welche Art von Sitzung Ihre App zugreifen muss, indem Sie die entsprechenden
FitnessOptions
-Methoden.
Um Sitzungen zum Thema Laufen zu lesen, kannst du beispielsweise 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()
Dieses Beispiel gibt an, dass Ihre App auf Metadaten von Aktivitätssitzungen zugreifen möchte, Außerdem werden die Datentypen festgelegt, die in diesen Sitzungen gelesen werden sollen. die In diesem Beispiel werden Herzfrequenz, Geschwindigkeit und Standortdaten verwendet.
REST
So fordern Sie Bereiche an:
- Sitzungen mit Schlafaktivitätstypen:
<ph type="x-smartling-placeholder">
- </ph>
https://www.googleapis.com/auth/fitness.sleep.read
https://www.googleapis.com/auth/fitness.sleep.write
- Alle anderen Sitzungen:
<ph type="x-smartling-placeholder">
- </ph>
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
Sitzungen verwenden
Android
Sie können die Sessions API für Folgendes verwenden:
- Sitzungen in Echtzeit erstellen
- Fügen Sie Sitzungen im Fitness-Store ein.
- Aktivitätssegmente für Pausen während des Trainings einfügen
- Lesesitzungen und Datasets, die damit verknüpft sind
- Andere App starten, um Informationen zu einer erstellten Sitzung aufzurufen
- Intent erhalten, wenn eine andere App eine Sitzung startet
REST
Sie können die Sessions API für Folgendes verwenden:
- Sitzungen in Echtzeit erstellen
- Fügen Sie Sitzungen im Fitness-Store ein.
- Aktivitätssegmente für Pausen während des Trainings einfügen
- Lesesitzungen und Datasets, die damit verknüpft sind
Interaktion von Datasets und Segmenten mit Sitzungen
In Google Fit:
- Ein Dataset stellt eine Gruppe von Datenpunkten aus einer bestimmten Datenquelle für einen bestimmten Zeitraum Datasets können in ihre gehören. Aber wenn Sie eine Sitzung erstellen, ist es vielleicht einfacher, Sitzung und ihre Datasets zusammen.
- Ein Segment gruppiert die Datasets in einer Sitzung nach der genauen Aktivität des Nutzers. was in der Sitzung passiert ist. Zeichnet der Nutzer beispielsweise einen 30-minütigen Lauf auf (der ) aber eine Weile gegangen ist, könnte dies in Segmente. Es gibt ein Segment für den Lauf, dann die Walking-Pause, noch einmal ausführen.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/fit/images/timeline.png?authuser=19&hl=de)
Abbildung 1 zeigt ein Zeitintervall im Fitnessspeicher, in das die Apps A, B und C eingefügt wurden. einige Datasets und Sitzungen:
- App A hat die Datasets A1 und A2 unabhängig von den Sitzungen zusammen mit den Sitzungen 1 und A3 eingefügt.
- App B hat die Datasets B1 und B2 zusammen mit Sitzung 2 eingefügt.
- App C hat Dataset C1 unabhängig von Sitzungen eingefügt.
Beim Lesen von Sitzungsdaten aus dem Fitness-Store werden alle Fitnessdaten, die innerhalb des Zeitintervalls einer Sitzung automatisch selbst wenn Sie die Daten nach dem Erstellen der Sitzung einfügen oder ein nachdem die Daten passiv erfasst wurden. Eine Abfrage nach Fitness aus Sitzung 1 Folgendes zurückgeben:
- Dataset A1
- Dataset A2
- Der Teil des Datasets A3 zwischen t1 und t2
- Der Teil des Datasets C1 zwischen t1 und t2
Sie können feststellen, von welcher Anwendung die einzelnen Sitzungen und Datasets eingefügt wurden.
Sitzungen erstellen
Sitzungen können auf verschiedene Arten erstellt werden:
- Ihre App kann aktiv eine Sitzung erstellen in:
<ph type="x-smartling-placeholder">
- </ph>
- Echtzeit, wenn ein Nutzer aktiv eine Aktivität auf einem Gerät verfolgt (nur Android) oder
- indem Sie es manuell einfügen.
- Wenn ein Nutzer manuell ein Training oder eine Aktivität in der Google Fit App hinzufügt.
Wann sollte eine Sitzung erstellt werden?
Fügen Sie Schlafdaten hinzu?
- Ja. Erstellen Sie eine Sitzung und fügen Sie sie manuell in den Fitnessspeicher ein. Zum Beispiel durch Einfügen einer Schlafsitzung. Dieses Nutzer mit Apps oder Geräten zur Schlafaufzeichnung nicht mit Geräten interagieren, um die Schlafaktivität zu starten und zu stoppen (wird passiv aufgezeichnet).
- Nein: Können Nutzer in Ihrer App Aktivitäten starten und beenden?
- Nein: Es wird keine Sitzung erstellt. Fügen Sie nur Datasets aus Ihrer Anwendung hinzu.
- Ja – mit der Android API eine Sitzung in Echtzeit erstellen, wenn Nutzer tracken oder manuell ausführen. Erstellen Sie mit der REST API eine Sitzung und fügen Sie diese manuell in den Fitnessspeicher ein.
- Kann Ihre App erkennen, wenn ein Nutzer verschiedene Aktivitäten auf einem
detailliertes Niveau (z. B. Gehen oder Laufen)?
- Ja: Segmente hinzufügen.
- Nein. Fügen Sie nur Datasets hinzu. Ignorieren und lassen Sie Google Fit diese passiv erstellen.
Lesesitzungen
Ihre App kann Sitzungen auf verschiedene Arten lesen:
- Suchen Sie nach einer bestimmten Sitzung, die erstellt/eingefügt wurde von
<ph type="x-smartling-placeholder">
- </ph>
- Name oder
- ID
- Suchen Sie nach allen erstellten/eingefügten Sitzungen nach Zeitraum.
- Suche nach allen verfügbaren Sitzungen, die von allen Apps (einschließlich Google Fit) nach Zeitraum erstellt wurden
Informationen dazu, welche Quellen eine Sitzung erstellt haben
Sie können Ihren Nutzern zeigen, über welche App oder auf welchem Gerät ihre Sitzungen erstellt wurden. Jedes mit einer Datenquelle verknüpft ist, die Informationen zur App oder zum das die Daten erhoben oder transformiert hat.
Android
Sie können derzeit nur den Paketnamen einer Sitzung abrufen, der von einem Android-Gerät geschrieben wurde
Client. Den Paketnamen der App, die eine Sitzung erstellt hat, erhalten Sie über den
getAppPackageName
-Methode. Sie können diese Informationen in Ihrer App nutzen, um
Nutzer, von denen andere Apps Fitnesssitzungen eingefügt haben. Sie können das Symbol für
alle
Apps, damit Nutzer sie leichter erkennen können.
Sie können auch Intent 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 Finden der Quelle, die ein Sitzung.
REST
Den Paketnamen der Android-App, die Sitzungen erstellt hat, erhalten Sie über den
session.application
-Property. Für Sitzungen, die mit dem
REST API verwenden, verwenden Sie stattdessen das Attribut session.name
. Sie können diese
Informationen in Ihrer App, um Nutzern zu zeigen, welche anderen Apps
Sitzungen. Sie können das Symbol für jede dieser Apps anzeigen, damit Nutzer
.
Weitere Informationen zum Finden der Quelle, die ein Sitzung.