Для добавления 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 Border Router (TBR) . Приложение для Android Sample App поддерживает следующие типы и характеристики устройств:
- Цветовая температура света (включение и выключение, яркость)
- Контактный датчик (логическое состояние)
- Регулировка яркости освещения (включение и выключение, регулировка яркости).
- Расширенный цветовой режим подсветки (включение и выключение, яркость)
- Универсальный переключатель
- Маршрутизатор границ Google
- Google Камера
- Датчик присутствия (обнаружение присутствия)
- Индикатор включения/выключения (вкл/выкл, яркость)
- Выключатель света
- Включатель/выключатель (вкл/выкл)
- Датчик включения/выключения
Поддерживаемые хабы
Поддержка API Home доступна только для некоторых хабов Google Nest.
Настройте SDK.
API Home в этой открытой бета-версии пока не входят в стандартные библиотеки, предоставляемые Google для разработки. Для разработки приложений с использованием API Home необходимо загрузить и разместить библиотеки локально.
Для загрузки Android SDK Home API необходимо сначала войти в систему Google Home Developers.