Начать работу на Android

Зарегистрируйте аккаунт Google

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

Получить сервисы Google Play

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

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

Получите идентификатор клиента OAuth 2.0

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

Создайте и настройте свой проект

Для создания приложения с Fitness API мы рекомендуем использовать среду разработки Android Studio . Подробнее о создании нового проекта и его настройке в 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:21.4.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:21.4.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.

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

Результирующий поток авторизации пользователя

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

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