Sitzungen

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:

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

Sitzungen verwenden

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.

</ph>

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.