Sesiones

Las sesiones son una forma para que los usuarios vean rápida y fácilmente una lista de todas las actividades que han realizado. Aparecen en la página de diario de la app de Google Fit. Para como una sesión de respiración, una caminata, una carrera o una noche de sueño son ejemplos de una sesión.

Las sesiones agrupan conjuntos de datos de un período específico, que se recopilaron durante una actividad. Por ejemplo, si un usuario realiza un seguimiento cuando comenzó y terminó una distancia de 3 km ejecutar, se podría crear una sesión y todos los datos de actividad física que estén en ese tiempo período (como pasos, velocidad y distancia) se asociaría con esa sesión.

Las sesiones en sí no contienen detalles sobre la actividad. Este se encuentra en de tu conjunto de datos. Las sesiones tienen las siguientes propiedades:

• Un nombre descriptivo y amigable (por ejemplo, "correr matutino")
• Una descripción.
• Un identificador único
• El tipo de actividad que está capturando (por ejemplo, una carrera)

Beneficios de usar sesiones

• Útil para los usuarios: Las sesiones te ayudan a organizar los datos de actividad y los entrenamientos de una de manera significativa para los usuarios. Pueden ver todas sus actividades del día en Página del diario en la app de Google Fit.
• Experiencia del usuario coherente: Si tu app o dispositivo complementario permite la actividad. seguimiento (donde los usuarios pueden iniciar y detener una actividad), tener sesiones durante estos entrenamientos permiten que los usuarios vean su actividad en ambas apps.
• Datos más completos: Google Fit también combina los datos de múltiples fuentes para complementar y enriquecer la información de tu sesión. Esto brinda a los usuarios un un panorama más completo de su actividad.
• Aprovechar la plataforma de Google Fit: Si tus usuarios no hacen un seguimiento de su actividad. Tu app no admite el seguimiento, pero puedes leer las sesiones en Google Fit. Puedes consultar datos detallados o agregados en el centro de entrenamiento y encontrar las sesiones disponibles sin necesidad de implementar tu propio esquema y y almacenamiento de los datos.
• Mayor participación de los usuarios: Puedes mostrarles a tus usuarios las sesiones disponibles y el y las apps que los crearon. Interactuar con otras aplicaciones de entrenamiento de esta manera podría aumentar la participación de los usuarios.

Obtén la autorización del usuario para las sesiones

Si quieres leer o escribir sesiones, tu app debe obtener las permiso. El acceso a las sesiones usa los mismos permisos de autorización como tipos de datos, que debes solicitar de la siguiente manera:

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

Cómo usar las sesiones

Cómo interactúan los segmentos y los conjuntos de datos con las sesiones

En Google Fit:

• Un conjunto de datos representa un conjunto de datos de un fuente de datos durante un período específico. Los conjuntos de datos pueden insertarse por sí solas. Pero, si creas una sesión, podría ser más fácil crear la y sus conjuntos de datos.
• Un segmento agrupa los conjuntos de datos en una sesión según la actividad exacta que el usuario estaba haciendo en la sesión. Por ejemplo, si el usuario monitorea una carrera de 30 minutos (el pero que caminaste un poco durante este tiempo, podría dividirse segmentos. Habría un tramo para correr, luego, un descanso para caminar y, después, volver a ejecutarse.

En la Figura 1, se muestra un intervalo de tiempo en gimnasio durante el cual se insertaron las apps A, B y C. algunos conjuntos de datos y sesiones:

• La app A insertó los conjuntos de datos A1 y A2 junto con las sesiones 1 y A3 independientemente de las sesiones.
• La App B insertó los conjuntos de datos B1 y B2 junto con la sesión 2.
• La App C insertó el conjunto de datos C1 independientemente de las sesiones.

Cuando se leen los datos de las sesiones de gimnasia, todos los datos de actividad física que dentro del intervalo de tiempo de una sesión se asocia automáticamente con ese de registro, incluso si insertas los datos luego de crear la sesión o creas una después de que se realizó un seguimiento pasivo de los datos. Por ejemplo, una consulta de fitness de la sesión 1 mostraría lo siguiente:

• Conjunto de datos A1
• Conjunto de datos A2
• La parte del conjunto de datos A3 entre t1 y t2
• La parte del conjunto de datos C1 entre t1 y t2

Puedes saber qué aplicación insertó cada sesión y conjunto de datos.

Crea sesiones

Las sesiones se pueden crear de diferentes maneras:

• Tu app puede crear una sesión de forma activa en
  • En tiempo real, cuando un usuario realiza un seguimiento activo de una actividad en un dispositivo (solo Android)
  • Insértala manualmente.
• Cuando un usuario agrega manualmente un entrenamiento o una actividad en la app de Google Fit

Cuándo crear una sesión

¿Estás agregando datos de sueño?

• Sí: Crea una sesión e insértala manualmente en la tienda de entrenamiento. Por ejemplo, si insertas una sesión de sueño. Esta es que los usuarios con apps o dispositivos de seguimiento del sueño no interactúan con para iniciar y detener la actividad de sueño (esto se registra de forma pasiva).
• No, ¿Tu app permite que los usuarios inicien y detengan actividades?
  • No, no crees una sesión. Solo agrega conjuntos de datos desde tu app.
  • Sí: Con la API de Android, crea una sesión en tiempo real si los usuarios realizan un seguimiento. su actividad o de forma manual. Con la API de REST, crea una sesión y, luego, insértala manualmente en la tienda de entrenamiento.
  • ¿Puede tu aplicación detectar cuando un usuario realiza diferentes actividades en un nivel detallado (por ejemplo, caminar frente a correr)?
    • Sí: Agregar segmentos.
    • No: solo agregar conjuntos de datos. Ignorar por ahora y dejar que Google Fit los cree de forma pasiva.

Sesiones de lectura

Tu app puede leer sesiones de varias maneras:

• Busca una sesión específica que haya creado o insertado
  • Nombre o
  • ID
• Busca todas las sesiones que creó o insertó, por período.
• Buscar todas las sesiones disponibles creadas por todas las apps (incluido Google Fit) por período

Descubre qué fuentes crearon una sesión

Puedes mostrarles a los usuarios qué app o dispositivo creó cada una de sus sesiones. Cada tiene una fuente de datos asociada, que incluye información sobre la app o que recopiló o transformó los datos.