Sessioni

Le sessioni consentono agli utenti di visualizzare in modo facile e veloce un elenco di tutte le attività principali che hanno svolto. Vengono visualizzate nella pagina del diario dell'app Google Fit. Ad esempio, una sessione di respirazione, una camminata, una corsa o un sonno di notte sono ciascuno esempi di una sessione.

Le sessioni raggruppano i set di dati di un periodo di tempo specifico che sono stati raccolti durante un'attività. Ad esempio, se un utente ha rilevato quando ha iniziato e terminato una corsa di 3 km, è possibile creare una sessione e tutti i dati sull'attività fisica relativi a tale periodo di tempo (come passi, velocità e distanza) saranno associati alla sessione.

Le sessioni stesse non contengono dettagli sull'attività. Questo è nel set di dati. Le sessioni hanno queste proprietà:

• Un nome descrittivo e amichevole (ad esempio, " corsa del mattino")
• Una descrizione
• Un identificatore univoco
• Il tipo di attività acquisita (ad esempio, una corsa)

Vantaggi dell'utilizzo delle sessioni

• Utile per gli utenti: le sessioni ti aiutano a organizzare i dati delle attività e gli allenamenti in modo significativo per gli utenti. Possono vedere tutte le loro attività della giornata nella pagina Giornale nell'app Google Fit.
• Esperienza utente coerente: se l'app o il dispositivo companion consente il monitoraggio delle attività (dove gli utenti possono avviare e interrompere un'attività), le sessioni relative a questi allenamenti consentono agli utenti di vedere le loro attività in entrambe le app.
• Dati più completi: Google Fit unisce anche i dati provenienti da più fonti per integrare e arricchire le informazioni relative alle sessioni. In questo modo gli utenti possono avere un quadro più completo della loro attività.
• Utilizza la piattaforma Google Fit: se i tuoi utenti non monitorano la loro attività o se la tua app non supporta il monitoraggio, puoi comunque leggere le sessioni in Google Fit. Puoi eseguire query sui dati dettagliati o aggregati dallo store fitness e trovare le sessioni disponibili, senza dover implementare i tuoi schemi e lo spazio di archiviazione.
• Maggiore coinvolgimento degli utenti: puoi mostrare agli utenti le sessioni disponibili e le app che li hanno creati. Interagire con altre app per l'attività fisica in questo modo potrebbe aumentare il coinvolgimento degli utenti.

Richiedere l'autorizzazione dell'utente per le sessioni

Se vuoi leggere o scrivere sessioni, l'app deve ottenere l'autorizzazione dell'utente. L'accesso alle sessioni utilizza gli stessi ambiti di autorizzazione dei tipi di dati, che devi richiedere nel seguente modo:

Android

Specifica il tipo di sessione a cui deve accedere la tua app, utilizzando i metodi appropriati di FitnessOptions. Ad esempio, per leggere le sessioni relative alla corsa potresti scegliere:

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

Questo esempio specifica che la tua app vuole accedere ai metadati di sessioni attività e specifica i tipi di dati che vuole leggere in tali sessioni; in questo esempio vengono utilizzati i tipi di dati relativi a frequenza cardiaca, velocità e posizione.

Nota: per accedere alle sessioni di sonno, usa .accessSleepSessions().

REST

Richiedi gli ambiti come segue:

• Sessioni con tipi di attività del sonno:
  • https://www.googleapis.com/auth/fitness.sleep.read
  • https://www.googleapis.com/auth/fitness.sleep.write
• Tutte le altre sessioni:
  • https://www.googleapis.com/auth/fitness.activity.read
  • https://www.googleapis.com/auth/fitness.activity.write

Utilizzo delle sessioni

Android

Puoi utilizzare l'API Sessions per:

• Crea sessioni in tempo reale
• Inserisci sessioni nel negozio di fitness
• Inserisci segmenti di attività per supportare le pause durante gli esercizi
• Sessioni e set di dati associati
• Avvia un'altra app per mostrare informazioni su una sessione creata
• Ricevere un intent quando un'altra app avvia una sessione

REST

Puoi utilizzare l'API Sessions per:

• Crea sessioni in tempo reale
• Inserisci sessioni nel negozio di fitness
• Inserisci segmenti di attività per supportare le pause durante gli esercizi
• Sessioni e set di dati associati

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

In Google Fit:

• Un set di dati rappresenta un set di punti dati da una determinata origine dati in un periodo di tempo specifico. I set di dati possono essere inseriti da soli. Tuttavia, se stai creando una sessione, potrebbe essere più facile creare la sessione e i relativi set di dati.
• Un segmento raggruppa i set di dati in una sessione in base all'attività esatta che l'utente ha fatto nella sessione. Ad esempio, se l'utente monitora una corsa di 30 minuti (la sessione) ma cammina per un po' durante questo periodo, questo potrebbe essere suddiviso in segmenti. Ci sarebbe un segmento per la corsa, poi la camminata, poi la corsa di nuovo.

Figura 1: app diverse aggiungono sessioni e set di dati a [store fitness].

La Figura 1 mostra un intervallo di tempo nell'archivio dell'attività fisica durante il quale le app A, B e C hanno inserito alcuni set di dati e sessioni:

• L'app A ha inserito i set di dati A1 e A2 insieme alla sessione 1 e A3 indipendentemente da qualsiasi sessione.
• 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 dall'archivio dell'attività fisica, tutti i dati relativi all'attività fisica che rientrano nell'intervallo di tempo di una sessione vengono associati automaticamente alla sessione in questione, anche se inserisci i dati dopo aver creato la sessione o crei una sessione dopo che i dati sono stati monitorati passivamente. Ad esempio, una query sui dati relativi all'attività fisica della Sessione 1 restituirà:

• 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 ogni set di dati.

Creazione di sessioni

Nota: per creare una sessione, la tua app deve avere l'https://www.googleapis.com/auth/fitness.activity.write autorizzazione di ambito OAuth.

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
  • inserendo manualmente la casella.
• Quando un utente aggiunge manualmente un'attività fisica 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 negozio. Ad esempio, inserendo una sessione di sonno. Questo perché gli utenti con app o dispositivi di monitoraggio del sonno non interagiscono con i dispositivi per avviare e interrompere la loro attività del sonno (viene monitorata passivamente).
• No: la tua app consente agli utenti di avviare e interrompere le attività?
  • No: non creare una sessione, Aggiungi solo set di dati dalla tua app.
  • Sì. Con l'API Android, crea una sessione in tempo reale se gli utenti monitorano la loro attività o manualmente. Con l'API REST, crea una sessione e inseriscila manualmente nel negozio di fitness.
  • La tua app può rilevare quando un utente svolge attività diverse a un livello più dettagliato (ad esempio, camminata o corsa)?
    • Sì. Aggiungi segmenti.
    • No: solo aggiungi set di dati. Ignorare per ora i segmenti e lasciare che Google Fit li crei passivamente.

Sessioni di lettura

Nota: per leggere le sessioni con l'API REST, la tua app richiede l'autorizzazione https://www.googleapis.com/auth/fitness.activity.read OAuth OAuth . Per leggere le sessioni con l'API Sessions per Android, specifica la costante di lettura nella classe FitnessOptions.

L'app può leggere le sessioni in diversi modi:

• Cerca una sessione specifica creata/inserita
  • 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) per periodo di tempo

Scopri quali origini hanno creato una sessione

Puoi mostrare agli utenti quale app o dispositivo ha creato ciascuna delle loro sessioni. A ogni sessione è associata un'origine dati contenente informazioni sull'app o sul dispositivo che ha raccolto o trasformato i dati.

Android

Al momento puoi ricevere solo il nome di pacchetto di una sessione scritta da un client Android. Per recuperare il nome del pacchetto dell'app che ha creato una sessione, utilizza il metodo getAppPackageName. Puoi utilizzare queste informazioni nella tua app per mostrare agli utenti quali altre app hanno inserito sessioni di fitness. Puoi mostrare l'icona per ognuna di queste app per aiutare gli utenti a identificarle.

Nota: puoi mostrare icone generiche per altre app per l'attività fisica che non sono installate sul dispositivo dell'utente.

Puoi anche attivare un intent per avviare altre app per mostrare i dettagli delle sessioni che hanno creato. Anche altre app possono attivare l'intenzione di lanciare la tua app.

Scopri di più su come trovare il codice sorgente che ha creato una sessione.

REST

Per recuperare il nome del pacchetto dell'app Android che ha creato le sessioni, utilizza la proprietà session.application. Per le sessioni create utilizzando l'API REST, utilizza invece la proprietà session.name. Puoi utilizzare queste informazioni nella tua app per mostrare agli utenti quali altre app hanno inserito sessioni di fitness. Puoi mostrare l'icona di ciascuna di queste app per aiutare gli utenti a identificarle.

Scopri di più su come trovare il codice sorgente che ha creato una sessione.