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

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

Требования

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

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

    Скачать Android Studio

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

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

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

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

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

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

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

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

Поддержка Home API доступна только на некоторых устройствах Google Nest Hub.

Таблица. Устройства 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

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

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

Войти

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