Пример приложения для Android

Демонстрационное приложение показывает основные возможности API Google Home для Android.

Предварительные требования

Для сборки, установки и тестирования приложения необходимо выполнить несколько предварительных условий:

  • Android Studio , версия 2024.2.1 («Ladybug») или более поздняя. Обратите внимание, что более ранние версии могут некорректно работать с SDK Home APIs.

    Скачать Android Studio

  • Отладчик Android ( adb ).

    Установите adb .

    Это можно сделать с помощью SDK Manager .

Для тестирования API Home вам потребуется:

  • Устройство Android под управлением Android 10 или более поздней версии, настроенное с использованием учетной записи Google, которую вы собираетесь использовать для разработки. Убедитесь, что установлена ​​актуальная версия Android Studio и что вы вошли в систему с помощью этой учетной записи разработчика.
  • Сеть Wi-Fi.
  • Для доступа к устройствам Matter и управления ими вам также потребуется концентратор Google, поддерживающий API Home . Подробности см. в разделе «Подключение на Android» .

  • At least one supported device in the home. If this device (or any other you want to test) uses Thread, the hub must also be a Thread border router. The following device types and traits are supported by the Android Sample App:

    • Цветовая температура света (включение и выключение, яркость)
    • Контактный датчик (логическое состояние)
    • Регулировка яркости освещения (включение и выключение, регулировка яркости).
    • Расширенный цветовой режим подсветки (включение и выключение, яркость)
    • Универсальный переключатель
    • Google Камера
    • Датчик присутствия (обнаружение присутствия)
    • Индикатор включения/выключения (вкл/выкл, яркость)
    • Выключатель света
    • Включатель/выключатель (вкл/выкл)
    • Датчик включения/выключения

Скачать исходный код

Исходный код демонстрационного приложения доступен на GitHub.

Перейдите в папку, куда хотите сохранить проект, а затем клонируйте его:

git clone https://github.com/google-home/google-home-api-sample-app-android.git

Настройте SDK.

The Home APIs for Android in this open beta are not yet part of the standard libraries provided by Google for development. In order to develop Android applications with the Home APIs, you need to download and host the libraries locally.

Для загрузки Android SDK Home API необходимо сначала войти в систему Google Home Developers.

Войдите прямо сейчас!

Создайте приложение

  1. Откройте Android Studio , затем откройте папку проекта google-home-api-sample-app-android клонированную на ваш локальный компьютер.

  2. В процессе первоначальной настройки Android Studio может потребоваться до 10 минут для загрузки всех зависимостей проекта и завершения сборки Gradle.

  3. Подключите компьютер к физическому Android-телефону с помощью USB-кабеля и включите ADB в параметрах разработчика . Убедитесь, что Android Studio может подключиться к Android-телефону через ADB.

  4. Измените имя пакета для демонстрационного приложения на новое, ранее не зарегистрированное, например, на имя, основанное на названии вашей организации:

    1. Откройте проект.
    2. Разверните иерархию источников.
    3. Выберите ту часть пакета, которую хотите изменить, — другими словами, com.example .
    4. Щелкните правой кнопкой мыши по пакету и выберите «Рефакторинг» > «Переименовать...». Рефакторинг > Переименовать меню
    5. Введите новое имя и нажмите «Рефакторинг» .
    6. Отредактируйте файл build.gradle.kts , изменив android namespace и applicationId на новое имя пакета.

  5. After all the required libraries are downloaded and the Gradle synchronization is complete, click the Run button to build and run the app. When the app is running successfully on your phone, you'll see the Sample App main page.

Создать сертификат подписи

When you run or debug an app in Android Studio , it automatically generates a debug certificate intended for development and debugging. See Android Studio: Sign your debug build for a complete explanation.

  1. Generate a debug app signing certificate by running the app in Android Studio . When you run or debug an app in Android Studio , Android Studio automatically generates an app signing certificate intended for development and debugging. See Android Studio: Sign your debug build for a complete explanation.

    Connect your mobile device to your local machine. Android Studio will list your connected devices by model number. Select your device from the list, then click Run project . This builds and installs the Sample App on your mobile device.

    Более подробные инструкции см. в разделе «Запуск приложений на аппаратном устройстве» на сайте разработчиков Android.

    Теперь остановите работающее приложение.

  2. Get your debug certificate's SHA-1 fingerprint by following the instructions detailed in Manage OAuth Clients / Application Types / Native applications / Android on the Google Cloud Console Help site.

  1. В консоли Google Cloud перейдите на панель выбора проекта и выберите проект, который вы хотите использовать для создания учетных данных OAuth.
  2. Перейдите на страницу «API и сервисы» и в меню навигации нажмите «Учетные данные» .

  3. If you haven't yet configured your consent screen for this Google Cloud project, the Configure consent screen button appears. In that case, configure your consent screen using the following procedure. Otherwise, move on to the next section.

    1. Нажмите «Настроить экран согласия» . Отобразится страница экрана согласия OAuth .
    2. В зависимости от вашего сценария использования выберите «Внутренний» или «Внешний» , а затем нажмите «Создать» . Отобразится панель согласия OAuth .
    3. Введите информацию на странице сведений о приложении в соответствии с инструкциями на экране, а затем нажмите «Сохранить и продолжить» . Отобразится панель «Области видимости» .
    4. Добавлять какие-либо области действия не нужно, поэтому нажмите «Сохранить и продолжить ». Отобразится панель «Проверка пользователей» .
    5. Нажмите «Аудитория» и затем кнопку «+ ДОБАВИТЬ ПОЛЬЗОВАТЕЛЕЙ» .
    6. Введите адрес электронной почты тестового пользователя и нажмите кнопку СОХРАНИТЬ .
    7. Нажмите «Сохранить и продолжить» . Отобразится панель «Сводка» .
    8. Проверьте информацию на экране согласия OAuth, а затем нажмите «Назад на панель управления» .

Подробную информацию см. в разделе «Настройка экрана согласия OAuth» на сайте справки консоли Google Cloud. Перед продолжением обязательно добавьте хотя бы одного тестового пользователя.

Настройка учетных данных OAuth

  1. Зарегистрируйте демонстрационное приложение для OAuth 2.0 и создайте учетные данные OAuth, следуя инструкциям, приведенным в разделе «Настройка OAuth 2.0» .
    1. Укажите тип приложения: нативное/приложение для Android .
    2. Add the SHA-1 fingerprint to the OAuth client by following the instructions in Setting up OAuth 2.0 / Native applications / Android on the Google Cloud Console Help site. You should generate the SHA-1 key from the default Android Studio key throughout the development process.

Запустите приложение

  1. Подключив мобильное устройство к локальному компьютеру, снова нажмите кнопку «Запустить проект» , чтобы запустить пример приложения на мобильном устройстве.

После установки приложение будет доступно на вашем мобильном устройстве под названием Home API Sample App .