Sessões

As sessões são uma maneira de os usuários verem de forma rápida e fácil uma lista de todos os principais as atividades que ele realizou. Elas aparecem na página de diário do app Google Fit. Para por exemplo, uma sessão de respiração, uma caminhada, uma corrida ou uma noite de sono exemplos de uma sessão.

As sessões agrupam conjuntos de dados de um período específico coletados durante uma atividade. Por exemplo, se um usuário rastreou quando começou e terminou uma corrida de 3 km correr, uma sessão pode ser criada e todos os dados de condicionamento físico dentro desse tempo (como passos, velocidade, distância) seria associado a essa sessão.

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

• Um nome descritivo e fácil de usar (por exemplo, "corrida matinal")
• uma descrição
• Um identificador exclusivo
• O tipo de atividade sendo capturada (por exemplo, uma corrida)

Benefícios de usar sessões

• Útil para os usuários: as sessões ajudam a organizar dados de atividades e treinos em uma significativa para os usuários. Eles podem ver todas as atividades do dia em Página do diário no app Google Fit.
• Experiência do usuário consistente: se o app ou dispositivo complementar permite atividade acompanhamento (onde os usuários podem iniciar e interromper uma atividade), ter sessões para esses treinos permitem que os usuários vejam a atividade deles em ambos os aplicativos.
• Dados mais completos: o Google Fit também mescla dados de vários fontes para complementar e enriquecer as informações da sua sessão. Isso dá aos usuários uma imagem mais completa da atividade.
• usar a plataforma Google Fit: se os usuários não monitorarem a atividade deles; seu app não for compatível com o monitoramento, você ainda poderá ler as sessões no Google Fit. Você pode consultar dados detalhados ou agregados da loja de condicionamento físico e encontrar disponíveis, sem precisar implementar seu próprio esquema e armazenamento.
• Maior engajamento do usuário: você pode mostrar aos usuários as sessões disponíveis e as e apps que os criaram. Interagir com outros aplicativos de condicionamento físico dessa forma poderia aumentar o engajamento dos usuários.

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

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

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

Como usar sessões

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

No Google Fit:

• Um conjunto de dados representa um conjunto de pontos de dados de um determinado origem de dados sobre um período específico. É possível inserir os conjuntos de dados por conta própria. Mas se você estiver criando uma sessão, pode ser mais fácil criar a e seus conjuntos de dados.
• Um segmento agrupa os conjuntos de dados em uma sessão pela atividade exata do usuário estava fazendo na sessão. Por exemplo, se o usuário rastrear uma corrida de 30 minutos (o mas caminhamos por um tempo durante esta etapa, isso pode ser dividido em segmentos. Havia um segmento para a corrida, depois uma pausa para caminhada e o executar novamente.

A Figura 1 mostra um intervalo de tempo no armazenamento de condicionamento físico em que os apps A, B e C foram inseridos alguns conjuntos de dados e sessões:

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

Ao ler dados de 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 é automaticamente associado a essa mesmo que você insira os dados depois de criar a sessão ou crie uma após os dados terem sido acompanhados passivamente. Por exemplo, uma consulta sobre condicionamento físico os dados da Sessão 1 retornariam:

• 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

É possível saber qual app inseriu cada sessão e conjunto de dados.

Criar sessões

As sessões podem ser criadas de algumas maneiras diferentes:

• Seu app pode criar ativamente uma sessão
  • Em tempo real quando um usuário monitora ativamente uma atividade em um dispositivo (somente Android) ou
  • inserindo-o 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 de fitness. Por exemplo, a inserção de uma sessão de sono. Isso é porque os usuários com aplicativos ou dispositivos de monitoramento do sono não interagem com os dispositivos para iniciar e interromper sua atividade de sono (isso é monitorado passivamente).
• Não: o app permite que os usuários iniciem e interrompam atividades?
  • Não: não crie uma sessão. Adicione apenas conjuntos de dados do seu aplicativo.
  • Sim: com a API Android, crie uma sessão em tempo real se os usuários rastrearem pela atividade ou manualmente. Com a API REST, crie uma sessão e insira manualmente na loja de fitness.
  • Seu aplicativo pode detectar quando um usuário está realizando atividades diferentes em um nível detalhado (por exemplo, caminhada versus corrida)?
    • Sim: adicione segmentos.
    • Não: adicione apenas conjuntos de dados. Ignorar e deixar que o Google Fit os crie de forma passiva.

Sessões de leitura

Seu app pode ler sessões de algumas maneiras:

• Procure uma sessão específica que ele criou/inseriu.
  • Nome ou
  • ID
• Procure todas as sessões que ele criou/inseriu por período
• Procurar todas as sessões disponíveis criadas por todos os apps (incluindo o Google Fit) por período

Saber quais origens criaram uma sessão

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