Sessões

As sessões são uma maneira de os usuários verem com rapidez e facilidade uma lista de todas as principais atividades que fizeram. Eles são exibidos na página do diário do app Google Fit. Por sessão, uma sessão de respiração, uma caminhada, uma corrida ou um sono noturno são exemplos de uma sessão.

As sessões agrupam conjuntos de dados de um período específico, que foram coletados durante uma atividade. Por exemplo, se um usuário monitorou quando iniciou e concluiu uma corrida de 3 km, uma sessão poderia ser criada e todos os dados de condicionamento físico dentro desse período (como passos, velocidade, distância) seriam associados a essa sessão.

As sessões em si não contêm detalhes sobre a atividade. Isso está no conjunto de dados. As sessões têm estas propriedades:

  • Um nome descritivo e amigável (por exemplo, "manhã em dia")
  • uma descrição
  • Um identificador exclusivo
  • O tipo de atividade que ela captura (por exemplo, uma execução)

Benefícios do uso de sessões

  • Útil para os usuários: as sessões ajudam a organizar dados de atividade e treinos de uma maneira relevante para os usuários. É possível ver todas as atividades do dia na página do diário no app Google Fit.
  • Experiência do usuário consistente: se o app ou dispositivo complementar permitir o rastreamento de atividades (onde os usuários podem iniciar e interromper uma atividade), ter sessões para esses treinos permitirá que os usuários vejam a atividade nos dois apps.
  • Dados mais completos: o Google Fit também combina dados de várias fontes para complementar e enriquecer as informações da sessão. Isso oferece aos usuários uma visão mais completa da atividade deles.
  • Aproveite a plataforma Google Fit: se seus usuários não monitoram a atividade ou seu app não é compatível com o rastreamento, ainda será possível ler as sessões no Google Fit. É possível consultar dados detalhados ou agregados na loja de condicionamento físico e encontrar sessões disponíveis, sem precisar implementar seu próprio esquema e armazenamento.
  • Maior engajamento dos usuários: é possível mostrar aos usuários as sessões disponíveis e os apps que as criaram. Interagir com outros apps de condicionamento físico dessa forma pode aumentar o engajamento do usuário.

Receber autorização do usuário para sessões

Se você quiser ler ou gravar sessões, seu app precisará ter a permissão do usuário. O acesso a sessões usa os mesmos escopos de autorização que os tipos de dados, que precisam ser solicitados da seguinte maneira:

Android

Especifique qual tipo de sessão seu app precisa acessar usando os métodos adequados da FitnessOptions. Por exemplo, para ler sessões relacionadas à corrida, escolha:

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

Este exemplo especifica que seu app quer acessar os metadados da sessão de atividade e também especifica os tipos de dados que quer ler nessas sessões. Os tipos de dados de frequência cardíaca, velocidade e localização são usados neste exemplo.

REST

Solicite escopos da seguinte maneira:

  • Sessões com tipos de atividade de sono:
    • https://www.googleapis.com/auth/fitness.sleep.read
    • https://www.googleapis.com/auth/fitness.sleep.write
  • Todas as outras sessões:
    • https://www.googleapis.com/auth/fitness.activity.read
    • https://www.googleapis.com/auth/fitness.activity.write

Usar sessões

Android

Você pode usar a API Sessions para:

  • Crie sessões em tempo real
  • Insira sessões na loja de ginástica
  • Insira segmentos de atividade para oferecer suporte a pausas durante os treinos
  • Ler sessões e conjuntos de dados associados a eles
  • Abra outro app para mostrar informações sobre uma sessão criada por ele
  • Receber uma intent quando outro app inicia uma sessão

REST

Você pode usar a API Sessions para:

  • Crie sessões em tempo real
  • Insira sessões na loja de ginástica
  • Insira segmentos de atividade para oferecer suporte a pausas durante os treinos
  • Ler sessões e conjuntos de dados associados a eles

Como os conjuntos de dados e segmentos interagem com sessões

No Google Fit:

  • Um conjunto de dados representa um conjunto de pontos de dados de uma fonte de dados específica durante um período específico. Os conjuntos de dados podem ser inseridos por conta própria. No entanto, se você estiver criando uma sessão, pode ser mais fácil criar a sessão e os conjuntos de dados dele juntos.
  • Um segmento agrupa os conjuntos de dados em uma sessão pela atividade exata que o usuário estava fazendo na sessão. Por exemplo, se o usuário rastrear uma corrida de 30 minutos (a sessão), mas caminhar por um pouco durante esse período, isso poderá ser dividido em segmentos. Há um trecho para a corrida, depois um intervalo de caminhada e, depois, outra para a corrida.
Figura 1: diferentes apps adicionam sessões e conjuntos de dados à [loja de ginástica].

A Figura 1 mostra um intervalo de tempo na loja de condicionamento físico em que os apps A, B e C inseriram alguns conjuntos de dados e sessões:

  • O app A inseriu os conjuntos de dados A1 e A2 em conjunto com a Sessão 1 e a A3, independentemente das sessões.
  • O app B inseriu os conjuntos de dados B1 e B2 na sessão 2.
  • O app C inseriu o conjunto de dados C1 independentemente das sessões.

Ao ler dados da sessão do armazenamento de condicionamento físico, todos os dados de condicionamento físico que se enquadram no intervalo de tempo de uma sessão são associados automaticamente a essa sessão, mesmo que você insira os dados após a criação da sessão ou crie uma sessão depois que os dados tiverem sido rastreados passivamente. Por exemplo, uma consulta de dados de condicionamento físico da Sessão 1 retornaria o seguinte:

  • Conjunto de dados A1
  • Conjunto de dados A2
  • A parte do conjunto de dados A3 entre t1 e t2
  • A parte do conjunto de dados C1 entre t1 e t2

Você pode saber qual app inseriu cada sessão e conjunto de dados.

Criar sessões

É possível criar sessões de algumas maneiras diferentes:

  • Seu app pode criar uma sessão ativamente em:
    • em tempo real quando um usuário rastreia ativamente uma atividade em um dispositivo (somente Android); ou
    • inserindo manualmente.
  • Quando um usuário adiciona manualmente um treino ou uma atividade no app Google Fit.

Quando criar uma sessão

Você está adicionando dados de sono?

  • Sim: crie uma sessão e insira manualmente na loja fitness. Por exemplo, inserir uma sessão de sono. Isso ocorre porque os usuários com dispositivos ou aplicativos de monitoramento de sono não interagem com os dispositivos para iniciar e interromper a atividade de sono, o que é monitorado passivamente.
  • Não: o app permite que os usuários iniciem e interrompam atividades?

Sessões de leitura

O app pode ler sessões de algumas maneiras:

  • Procure uma sessão específica criada/inserida por:
    • Nome ou
    • ID
  • Procure todas as sessões criadas/inseridas por período
  • Pesquisar todas as sessões disponíveis criadas por todos os apps (inclusive o Google Fit) por período

Descobrir quais origens criaram uma sessão

Você pode mostrar aos usuários qual app ou dispositivo criou cada sessão. Cada sessão tem uma fonte de dados associada, que contém informações sobre o app ou dispositivo que coletou ou transformou os dados.

Android

No momento, só é possível ver o nome do pacote de uma sessão escrita por um cliente Android. Para acessar o nome do pacote do app que criou uma sessão, use o método getAppPackageName. É possível usar essas informações no seu app para mostrar aos usuários quais outros apps inseriram sessões de condicionamento físico. Você pode mostrar o ícone em cada um desses apps para ajudar os usuários a identificá-los.

Você também pode disparar uma intent para iniciar outros apps para mostrar detalhes das sessões que eles criaram. Outros apps também podem iniciar uma intent para iniciá-lo.

Saiba mais sobre como encontrar a origem que criou uma sessão.

REST

Para acessar o nome do pacote do app Android que criou sessões, use a propriedade session.application. Para sessões que foram criadas com a API REST, use a propriedade session.name. É possível usar essas informações no seu app para mostrar aos usuários quais outros apps inseriram sessões de condicionamento físico. Você pode mostrar o ícone de cada um desses apps para ajudar os usuários a identificá-los.

Saiba mais sobre como encontrar a origem que criou uma sessão.