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

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

Предпосылки

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

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

    Загрузить Android Studio

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

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

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

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

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

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

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

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

Таблица: Центры Google Nest с поддержкой Home API
Устройство Поддержка Thread Border Router 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 Home в этой открытой бета-версии пока не входят в стандартные библиотеки, предоставляемые Google для разработки. Для разработки приложений с использованием API Home необходимо загрузить и разместить библиотеки локально.

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

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