Sessioni

Le sessioni consentono agli utenti di visualizzare in modo facile e veloce un elenco di tutte le principali attività svolte. Vengono visualizzati nella pagina del diario dell'app Google Fit. Per ad esempio una sessione di respirazione, una camminata, una corsa o una notte esempi di una sessione.

Le sessioni raggruppano i set di dati relativi a un periodo di tempo specifico, raccolti durante un'attività. Ad esempio, se un utente ha monitorato quando ha iniziato e terminato un percorso di 3 km corsa, è possibile creare una sessione e tutti i dati relativi all'attività fisica contenuti in quel lasso di tempo (come passi, velocità, distanza) viene associato a quella sessione.

Le sessioni in sé non contengono dettagli sull'attività. Questo è il del set di dati. Le sessioni hanno le seguenti proprietà:

• Un nome descrittivo e descrittivo (ad esempio "corsa mattutina")
• Una descrizione
• Un identificatore univoco
• Il tipo di attività che sta acquisendo (ad esempio una corsa)

Vantaggi dell'utilizzo delle sessioni

• Utili per gli utenti: le sessioni consentono di organizzare i dati relativi all'attività e gli esercizi in un un modo significativo per gli utenti. Possono vedere tutte le attività svolte per la giornata in Pagina del diario nell'app Google Fit.
• Esperienza utente coerente: se l'app o il dispositivo companion consente attività. il monitoraggio (dove gli utenti possono iniziare e interrompere un'attività), con sessioni per questi esercizi consentono agli utenti di vedere la propria attività in entrambe le app.
• Dati più completi: Google Fit unisce anche i dati di più per integrare e arricchire le informazioni sulle sessioni. Questo offre agli utenti un quadro più completo delle loro attività.
• Sfruttare la piattaforma Google Fit: se gli utenti non monitorano la loro attività oppure la tua app non supporta il monitoraggio, puoi comunque leggere le sessioni in Google Fit. Puoi eseguire query su dati dettagliati o aggregati dal negozio per il fitness e trovare disponibili senza dover implementare uno schema personalizzato archiviazione.
• Maggiore coinvolgimento degli utenti: puoi mostrare agli utenti le sessioni disponibili e il le app che li hanno creati. L'interazione con altre app per l'attività fisica potrebbe aumentare il coinvolgimento degli utenti.

Ottenere l'autorizzazione degli utenti per le sessioni

Se vuoi leggere o scrivere sessioni, la tua app deve ottenere i dati autorizzazione. L'accesso alle sessioni utilizza gli stessi ambiti di autorizzazione come tipi di dati, che dovresti richiedere come segue:

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

Utilizzo delle sessioni

In che modo i set di dati e i segmenti interagiscono con le sessioni

In Google Fit:

• Un set di dati rappresenta un insieme di punti dati da un determinato origine dati per un periodo di tempo specifico. I set di dati possono essere inseriti personali. Tuttavia, se intendi creare una sessione, potrebbe essere più semplice creare e i relativi set di dati.
• Un segmento raggruppa i set di dati in una sessione in base all'attività esatta dell'utente. durante la sessione. Ad esempio, se l'utente monitora una corsa di 30 minuti (il sessione) ma durante questo periodo di tempo abbiamo camminato per un po', la situazione potrebbe essere suddivisa segmenti. Ci sarebbe un segmento per la corsa, poi la pausa camminata e infine la esegui di nuovo.

La figura 1 mostra un intervallo di tempo nel negozio per il fitness durante il quale sono state inserite le app A, B e C alcuni set di dati e sessioni:

• L'app A ha inserito i set di dati A1 e A2 insieme alle sessioni 1 e A3 indipendentemente dalle sessioni.
• L'app B ha inserito i set di dati B1 e B2 insieme alla Sessione 2.
• L'app C ha inserito il set di dati C1 indipendentemente da qualsiasi sessione.

Durante la lettura dei dati di sessione dal fitness store, tutti i dati relativi all'attività fisica che rientrano nell'intervallo di tempo di una sessione viene automaticamente associata sessione, anche se inserisci i dati dopo aver creato la sessione o crei una successiva al monitoraggio passivo dei dati. Ad esempio, una query per l'attività fisica i dati della Sessione 1 restituiranno:

• Set di dati A1
• Set di dati A2
• La parte del set di dati A3 tra t1 e t2
• La parte del set di dati C1 tra t1 e t2

Puoi capire quale app ha inserito ogni sessione e set di dati.

Creazione di sessioni

Le sessioni possono essere create in diversi modi:

• La tua app può creare attivamente una sessione in
  • In tempo reale quando un utente monitora attivamente un'attività su un dispositivo (solo Android) oppure
  • inserendolo manualmente.
• Quando un utente aggiunge manualmente un esercizio o un'attività nell'app Google Fit.

Quando creare una sessione

Stai aggiungendo dati relativi al sonno?

• Sì: crea una sessione e inseriscila manualmente nel Fitness Store. Ad esempio, inserendo una sessione di sonno. Questo è che gli utenti che hanno app o dispositivi per il monitoraggio del sonno non interagiscono con i dispositivi. per avviare e interrompere l'attività del sonno (ciò viene monitorato passivamente).
• No. L'app consente agli utenti di avviare e interrompere attività?
  • No. Non creare una sessione. Aggiungi solo set di dati dalla tua app.
  • Sì: con l'API Android, puoi creare una sessione in tempo reale se gli utenti monitorano la propria attività o manualmente. Con l'API REST, crea una sessione e inseriscila manualmente nel Fitness Store.
  • La tua app può rilevare quando un utente sta svolgendo diverse attività su un livello dettagliato (ad es. camminata rispetto a corsa)?
    • Sì: aggiungi segmenti.
    • No: aggiungi solo set di dati. Ignora segmenti e lasciare che sia Google Fit a crearli passivamente.

Sessioni di lettura

La tua app può leggere le sessioni in diversi modi:

• Cerca una sessione specifica creata/inserita da
  • Nome o
  • ID
• Cerca tutte le sessioni che ha creato/inserito, per periodo di tempo
• Cerca tutte le sessioni disponibili create da tutte le app (incluso Google Fit) in base al periodo di tempo

Scopri quali origini hanno creato una sessione

Puoi mostrare agli utenti quale app o dispositivo ha creato ciascuna delle loro sessioni. Ciascuna a una sessione è associata a un'origine dati, che contiene informazioni sull'app dispositivo che ha raccolto o trasformato i dati.