Для добавления API Home в Android-приложение необходимо выполнить несколько предварительных условий.
Предварительные требования
Для разработки вам понадобится компьютер с установленными следующими программами:
Android Studio , версия 2024.2.1 («Ladybug») или более поздняя. Обратите внимание, что более ранние версии могут некорректно работать с SDK Home APIs.
Отладчик Android (
adb).Установите
adb.Это можно сделать с помощью SDK Manager .
Для тестирования API Home вам потребуется:
- Устройство Android под управлением Android 10 или более поздней версии, настроенное с использованием учетной записи Google, которую вы собираетесь использовать для разработки. Убедитесь, что установлена актуальная версия Android Studio и что вы вошли в систему с помощью этой учетной записи разработчика.
- Сеть Wi-Fi.
- Для доступа к устройствам Matter и управления ими вам также потребуется концентратор Google, поддерживающий API Home . Подробности см. в разделе «Подключение на Android» .
В доме должно быть как минимум одно поддерживаемое устройство. Если это устройство (или любое другое, которое вы хотите протестировать) использует Thread, то хаб также должен быть пограничным маршрутизатором Thread. Приложение для Android поддерживает следующие типы и характеристики устройств:
- Цветовая температура света (включение и выключение, яркость)
- Контактный датчик (логическое состояние)
- Регулировка яркости освещения (включение и выключение, регулировка яркости).
- Расширенный цветовой режим подсветки (включение и выключение, яркость)
- Универсальный переключатель
- Google Камера
- Датчик присутствия (обнаружение присутствия)
- Индикатор включения/выключения (вкл/выкл, яркость)
- Выключатель света
- Включатель/выключатель (вкл/выкл)
- Датчик включения/выключения
Поддерживаемые хабы
Поддержка API Home доступна только для некоторых хабов Google Nest.
Помимо этих поддерживаемых хабов, существует режим без хаба , который предлагает ограниченные возможности API Home.
Настройте SDK.
API Home в этой открытой бета-версии пока не входят в стандартные библиотеки, предоставляемые Google для разработки. Для разработки приложений с использованием API Home необходимо загрузить и разместить библиотеки локально.
Для загрузки Android SDK Home API необходимо сначала войти в систему Google Home Developers.