Sessões

As sessões são uma maneira dos usuários visualizarem de maneira rápida e fácil uma lista de todas as principais atividades que realizaram. Elas aparecem na página de diário do app Google Fit. Uma sessão de respiração, uma caminhada, uma corrida ou uma noite de sono 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 acompanhou quando começou e terminou uma corrida de 3 km, uma sessão poderia ser criada e todos os dados de condicionamento físico nesse período (como passos, velocidade e distância) seriam associados a essa sessão.

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

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

Benefícios de usar as sessões

  • Útil para os usuários: as sessões ajudam a organizar os dados de atividades e treinos de maneira significativa para os usuários. Eles podem ver todas as atividades do dia na página "Diário" do app Google Fit.
  • Experiência do usuário consistente: se o app ou dispositivo complementar permitir o monitoramento de atividades, em que os usuários podem iniciar e interromper uma atividade, ter sessões para esses treinos vai permitir que os usuários confiram a atividade nos dois apps.
  • Dados mais completos: o Google Fit também mescla dados de várias fontes para complementar e enriquecer as informações da sua sessão. Isso dá aos usuários um panorama mais completo da atividade deles.
  • Use a plataforma Google Fit: se os usuários não monitorarem as atividades deles ou seu app não oferecer suporte ao monitoramento, você ainda poderá ler as sessões no Google Fit. É possível consultar dados detalhados ou agregados do armazenamento de condicionamento físico e encontrar as sessões disponíveis sem precisar implementar seu próprio esquema e armazenamento.
  • Maior engajamento dos usuários: é possível mostrar as sessões disponíveis aos usuários e os apps que as criaram. Interagir com outros apps fitness dessa maneira pode aumentar o engajamento do usuário.

Como conseguir a 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 às sessões usa os mesmos escopos de autorização dos tipos de dados, que você precisa solicitar da seguinte maneira:

Android

Especifique o tipo de sessão que seu app precisa acessar usando os métodos apropriados do FitnessOptions. Por exemplo, para ler sessões relacionadas a corrida, você pode escolher:

    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 os tipos de dados que ele quer ler nessas sessões. Os tipos de dados de frequência cardíaca, velocidade e localização são usados neste exemplo.

REST

Escopos da solicitação 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

Uso de sessões

Android

Você pode usar a API Sessions para:

  • Crie sessões em tempo real
  • Inserir sessões na loja de fitness
  • Insira segmentos de atividade para apoiar as pausas durante os treinos
  • Ler sessões e conjuntos de dados associados a elas
  • Iniciar outro app para mostrar informações sobre uma sessão criada por ele
  • Receber uma intent quando outro app iniciar uma sessão

REST

Você pode usar a API Sessions para:

  • Crie sessões em tempo real
  • Inserir sessões na loja de fitness
  • Insira segmentos de atividade para apoiar as pausas durante os treinos
  • Ler sessões e conjuntos de dados associados a elas

Como 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 determinada fonte de dados durante um período específico. Os conjuntos de dados podem ser inseridos por conta própria. Mas, se você estiver criando uma sessão, pode ser mais fácil criar a sessão e os conjuntos de dados dela juntos.
  • Um segmento agrupa os conjuntos de dados em uma sessão pela atividade exata que o usuário estava realizando na sessão. Por exemplo, se o usuário monitora uma corrida de 30 minutos (a sessão), mas caminhou por um tempo, isso pode ser dividido em segmentos. Haverá um trecho para a corrida, depois a pausa para caminhada e, em seguida, a corrida novamente.
Figura 1: diferentes apps adicionam sessões e conjuntos de dados ao [armazenamento de fitness].

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

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

Ao ler dados de sessões do armazenamento de condicionamento físico, todos os dados de condicionamento físico que se enquadram no intervalo de uma sessão são automaticamente associados a ela, mesmo que você insira os dados após a criação ou crie uma sessão após o rastreamento passivo dos dados. Por exemplo, uma consulta de dados de condicionamento físico da Sessão 1 retornaria:

  • 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 dizer qual aplicativo inseriu cada sessão e conjunto de dados.

Criar sessões

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

  • O app pode criar ativamente uma sessão em:
    • Em tempo real, quando um usuário rastreia ativamente uma atividade em um dispositivo (somente Android).
    • inserindo-o manualmente.
  • Quando um usuário adiciona manualmente um treino ou uma atividade ao 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 condicionamento físico. Por exemplo, ao inserir uma sessão de sono. Isso ocorre porque os usuários com apps ou dispositivos de monitoramento do sono não interagem com os dispositivos para iniciar e interromper a atividade de sono, que é monitorada passivamente.
  • Não: o app permite que os usuários iniciem e interrompam atividades?

Sessões de leitura

Seu app pode ler as 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
  • Procure todas as sessões disponíveis criadas por todos os apps (incluindo o Google Fit) por período

Saiba 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 receber o nome do pacote de uma sessão gravada por um cliente Android. Para conferir o nome do pacote do app que criou uma sessão, use o método getAppPackageName. Você pode usar essas informações no seu app para mostrar aos usuários quais outros apps inseriram sessões de exercícios. Você pode mostrar o ícone de cada um desses apps para ajudar os usuários a identificá-los.

Você também pode disparar uma intent para iniciar outros apps e mostrar detalhes das sessões criadas por ele. Outros apps também podem disparar uma intent para iniciar seu app.

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

REST

Para conferir o nome do pacote do app Android que criou sessões, use a propriedade session.application. Para sessões criadas usando a API REST, use a propriedade session.name. Você pode 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 para cada um desses apps para ajudar os usuários a identificá-los.

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