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

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

Предпосылки

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

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

    Загрузить Android Studio

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

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

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

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

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

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

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

Поддерживаемые концентраторы

Только некоторые концентраторы Google Nest поддерживают API Home.

Таблица: концентраторы Google Nest с поддержкой Home API
Устройство ОС Поддержка маршрутизатора Thread Border Магазин Google
Google Home Бросать
Google Nest Audio Бросать
Google Nest Hub Бросать
Google Nest Hub (2nd gen) Фуксия
Google Nest Hub Max Фуксия
Google Nest Mini Бросать
Google TV Streamer (4k) андроид

Настройте SDK

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

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

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

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