Чтобы добавить Home API в приложение Android, вам необходимо соблюсти несколько предварительных условий.
Предпосылки
Для разработки вам понадобится компьютер с установленными на нем следующими инструментами:
Android Studio версии 2024.2.1 («Ladybug») или более поздней. Обратите внимание, что более ранние версии могут работать некорректно с Home API SDK.
Отладчик 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.
Настройте SDK
API Home в этой открытой бета-версии пока не входят в стандартные библиотеки, предоставляемые Google для разработки. Для разработки приложений с использованием API Home необходимо загрузить и разместить библиотеки локально.
Чтобы загрузить Home APIs Android SDK, сначала необходимо войти в систему Google Home Developers.