Как добавить API Home в приложение для Android

Чтобы добавить Home API в приложение для Android, необходимо выполнить несколько требований.

Требования

Для разработки вам понадобится компьютер со следующими инструментами:

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

    Скачать Android Studio

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

    Установить: adb.

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

Чтобы тестировать API умного дома, вам понадобится:

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

  • В доме должно быть хотя бы одно поддерживаемое устройство. Если устройство, которое вы хотите протестировать, использует Thread, то хаб должен быть Thread Border Router (TBR). В демонстрационном приложении для Android поддерживаются следующие типы устройств и traits:

    • Лампа с регулируемой цветовой температурой (включение и выключение, яркость)
    • Датчик открытия (логическое значение)
    • диммируемый светильник (включение и выключение, яркость);
    • Дверной замок
    • Расширенный цветной свет (включение и выключение, яркость)
    • Универсальный переключатель
    • Пограничный маршрутизатор Google
    • Google Камера
    • Google Doorbell
    • Датчик присутствия
    • Включить/выключить свет (включение и выключение, яркость)
    • Выключатель света
    • Включаемое/выключаемое устройство с вилкой
    • Датчик включения/выключения

Поддерживаемые хабы

API Google Home поддерживаются только на некоторых хабах Google Nest.

Таблица: устройства Google Nest Hub с поддержкой Home API
Устройство Поддержка пограничного маршрутизатора Thread Google Store
Google Home
Google Nest Audio
Google Nest Hub
Google Nest Hub (2nd gen)
Google Nest Hub Max
Google Nest Mini
Google TV Streamer (4k)
Nest WiFi Pro

Настройте SDK

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

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

Войдите в аккаунт

Далее
2. Настройте OAuth