Главная API Пример приложения для Android

Пример приложения демонстрирует основные возможности API Google Home.

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

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

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

    Загрузите Android-студию

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

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

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

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

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

  • По крайней мере одно поддерживаемое устройство дома. Если это устройство (или любое другое, которое вы хотите протестировать) использует Thread, концентратор также должен быть граничным маршрутизатором Thread. Пример приложения для Android поддерживает следующие типы и характеристики устройств:

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

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

  3. Если вы еще не настроили экран согласия для этого проекта Google Cloud, появится кнопка «Настроить экран согласия» . В этом случае настройте экран согласия, используя следующую процедуру. В противном случае перейдите к следующему разделу.

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

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

Загрузите исходный код

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

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

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

Настройте SDK

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

Чтобы загрузить Android SDK Home APIs, сначала необходимо войти в Google Home Developers.

Войдите сейчас!

Стройте и запускайте

  1. Откройте Android Studio , затем откройте папку проекта google-home-api-sample-app-android которая была клонирована на локальный компьютер.
  2. Во время первой настройки Android Studio может потребоваться до 10 минут, чтобы загрузить все зависимости проекта и завершить сборку Gradle.
    • Если на этом этапе вы получите сообщение об ошибке, например Gradle Sync Failed , нажмите «Попробовать еще раз», чтобы начать синхронизацию еще раз.
  3. Измените имя пакета для примера приложения на новое, которое ранее не было зарегистрировано, например на имя вашей организации:
    1. Откройте проект.
    2. Разверните исходную иерархию.
    3. Выберите часть пакета, которую вы хотите изменить, другими словами, com.example .
    4. Щелкните пакет правой кнопкой мыши и выберите «Рефакторинг» > «Переименовать...».
    5. Нажмите «Все каталоги» .
    6. Введите новое имя и нажмите «Рефакторинг» .
    7. Отредактируйте файл build.gradle.kts , изменив android namespace и applicationId на новое имя пакета.
    8. Отредактируйте файл AndroidManifest.xml и измените имя пакета на новое имя, где бы оно ни встречалось в файле.

  4. Создайте ключ OAuth, запустив приложение в Android Studio . Когда вы запускаете или отлаживаете приложение в Android Studio , Android Studio автоматически генерирует ключ OAuth, предназначенный для разработки и отладки. См . Android Studio: подпишите отладочную сборку для получения полного объяснения.

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

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

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

  5. Получите отпечаток SHA-1 сертификата OAuth, следуя инструкциям, подробно описанным в разделе «Настройка OAuth 2.0 / Собственные приложения / Android» на справочном сайте Google Cloud Console.

  6. Зарегистрируйте пример приложения для OAuth 2.0 и создайте учетные данные OAuth, следуя инструкциям, приведенным в разделе Настройка OAuth 2.0 .

    1. Укажите тип приложения: нативное/Android-приложение .
    2. Добавьте отпечаток SHA-1 в клиент OAuth, следуя инструкциям в разделе «Настройка OAuth 2.0/Нативные приложения/Android» на сайте справки Google Cloud Console. Вам следует генерировать ключ SHA-1 из ключа Android Studio по умолчанию на протяжении всего процесса разработки.
    3. Добавьте тестовых пользователей. Тестовые пользователи имеют право предоставлять разрешения в примере приложения.

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

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