Начало работы на устройстве Android

Создайте аккаунт Google

Чтобы использовать Google Fit API, вам понадобится аккаунт Google. Вы можете создать новый аккаунт или использовать существующий. Вы можете создать отдельный аккаунт, чтобы протестировать приложение с точки зрения пользователя.

Установить сервисы Google Play

Скачайте последнюю версию клиентской библиотеки для сервисов Google Play на хост разработки:

1. Откройте Android SDK Manager.
2. В разделе SDK Tools найдите сервисы Google Play.
3. Если статус этих пакетов не Установлено, выберите их оба и нажмите Установить пакеты.

Как получить идентификатор клиента OAuth 2.0

Чтобы включить Fitness API, получите идентификатор клиента OAuth 2.0.

Как создать и настроить проект

Мы рекомендуем использовать среду разработки Android Studio для создания приложений с помощью Fitness API. Подробнее о том, как создать и настроить проект в Android Studio…

Как добавить клиентскую библиотеку сервисов Google Play

В Android Studio откройте файл build.gradle для своего модуля и добавьте клиентскую библиотеку сервисов Google Play в качестве зависимости:

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:22.0.0")
}

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:22.0.0'
}

Это позволит Gradle автоматически скачивать Fitness SDK при сборке приложения.

Как получить необходимые разрешения Android

Чтобы считывать и записывать некоторые типы данных, вашему приложению нужно запрашивать разрешения Android.

Как получить разрешения OAuth

Типы данных, к которым у вашего приложения есть доступ, соответствуют областям авторизации. Чтобы запросить эти разрешения, вам нужно добавить типы данных, к которым приложению требуется доступ, в экземпляр FitnessOptions. Когда приложение запрашивает доступ к любому из типов данных Google Fit, Android SDK автоматически проверяет, к каким областям они относятся, и запрашивает у пользователя разрешение на доступ к этим областям.

Как создать API-клиент

Создайте API-клиент и добавьте типы данных, к которым приложению нужен доступ для записи или чтения. Доступны следующие конечные точки:

• SensorsClient: доступ к данным о здоровье и самочувствии из аппаратных датчиков на локальном и дополнительных устройствах.
• RecordingClient – для постоянного сбора данных датчиков в фоновом режиме с низким энергопотреблением.
• HistoryClient: вставлять, удалять и читать данные в Google Fit.
• SessionsClient: создание сеансов действий пользователей и управление ими.
• GoalsClient – чтение целей по баллам кардиотренировок и шагам, созданных пользователями в Google Fit.
• ConfigClient: доступ к пользовательским типам данных и настройкам на платформе Google Fit.

Пример создания API-клиента Fitness

Процесс авторизации пользователя

Ниже показан процесс авторизации, который видят пользователи при запросе разрешений:

1. Разрешения Android. Пользователи видят, какие разрешения Android запросило ваше приложение, прежде чем скачать его. После скачивания приложение запрашивает необходимые динамические разрешения, и пользователи предоставляют или отклоняют их.
2. Проверка приложений и подключение. Приложение проверяет, предоставлены ли разрешения, прежде чем запрашивать доступ к другим типам данных.
3. Запрос областей действия OAuth. Google предлагает пользователю предоставить приложению области действия OAuth, необходимые для доступа к нужным типам данных.
4. Доступ предоставлен. После того как пользователь предоставит разрешения, ваше приложение сможет получать доступ к типам данных, относящимся к областям действия, для которых пользователь предоставил разрешение.